jobs.ams.at APIjobs.ams.at ↗
Search Austrian job listings from jobs.ams.at via API. Filter by location, education, green jobs, apprenticeships, and more. Get full job details by UUID.
curl -X GET 'https://api.parse.bot/scraper/78cbcd5c-9119-42e9-8f44-df60d1c765d3/search_jobs' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for job listings with various filters.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| query | string | Search keyword (job title, skill, or company) |
| period | string | Time period (ALL, 1, 2, 7, 30 days) |
| radius | integer | Search radius in km around location |
| location | string | Location (City, Postal Code, or State) |
| education | string | Education level filter (e.g. 'P*' for Pflichtschule, 'U*' for University) |
| green_job | boolean | Filter for Green Jobs only |
| page_size | integer | Number of results per page |
| sort_field | string | Sort field (_SCORE for relevance, DATE for date) |
| working_time | string | Working hours (VZ=Fulltime, TZ=Parttime) |
| job_offer_types | string | Comma-separated list of job offer sources (AMS, SB_WKO, IJ, BA, BZ, TN) |
| employment_relationship | string | Employment type (AA=Arbeiter/Angestellte, LS=Lehrstelle, SS=Saison, FS=Ferial, SB=Sonstige) |
{
"type": "object",
"fields": {
"page": "integer",
"results": "array",
"pageSize": "integer",
"totalPages": "integer",
"totalResults": "integer"
},
"sample": {
"page": 1,
"results": [
{
"id": 12345,
"uuid": "abc-123-def",
"title": "Software Engineer",
"company": {
"name": "Example GmbH"
}
}
],
"pageSize": 12,
"totalPages": 10,
"totalResults": 120
}
}About the jobs.ams.at API
This API exposes 6 endpoints covering Austria's AMS alle jobs platform, letting you search listings with filters like location, radius, education level, and green-job status, then retrieve full job details by UUID. The search_jobs endpoint returns paginated results with totalResults, totalPages, and a results array, while get_job_detail delivers title, company object, and description for a specific posting.
Search and Filter Austrian Job Listings
The search_jobs endpoint accepts up to eight optional parameters: query for keyword search (job title, skill, or company name), location (city, postal code, or Austrian state), radius in kilometers, period to restrict results to the last 1, 2, 7, or 30 days, education for level filtering (e.g. P* for Pflichtschule, U* for University), green_job boolean, page, and page_size. Results include totalResults, totalPages, and a results array so you can build pagination UIs directly from the response.
Job Detail and Autocomplete
get_job_detail requires a uuid and returns structured fields including id, uuid, title, a company object, a full description, and lastUpdatedAt. The get_suggestions endpoint takes a query prefix (e.g. Koch or Software) and an optional count cap, returning an array of suggestion objects each with an id and text — useful for building type-ahead search fields against AMS job titles.
Specialised Listing Types
Three endpoints target specific listing segments. get_featured_job_categories returns predefinedSearches — the curated category tiles shown on the AMS homepage — with no inputs required. get_green_jobs and get_apprenticeship_jobs are convenience endpoints that accept an optional location filter and return a results array plus totalResults, isolating environmentally-focused positions and Lehrstelle apprenticeships respectively without requiring you to construct filter parameters manually.
- Aggregate Austrian job listings into a multilingual job board filtered by state or postal code
- Build a type-ahead job-title search field using
get_suggestionswith a prefix query - Track new green-job postings daily using
get_green_jobswith a location filter - Monitor apprenticeship (Lehrstelle) availability per region using
get_apprenticeship_jobs - Display AMS homepage curated categories in an embedded widget via
get_featured_job_categories - Alert users to new listings in a specific field by polling
search_jobswithperiod=1and a keyword - Populate full job-detail pages using
get_job_detailafter surfacing a UUID from search results
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does AMS (Arbeitsmarktservice Österreich) have an official developer API?+
What does `get_job_detail` return beyond what appears in search results?+
get_job_detail returns the full description field and a structured company object alongside title, uuid, id, and lastUpdatedAt. Search results contain a summary results array but do not include the full description text — you need the UUID from search to call the detail endpoint.How does education-level filtering work in `search_jobs`?+
education parameter uses prefix codes that map to Austrian qualification levels: P* targets Pflichtschule (compulsory schooling), U* targets university-level qualifications. Other prefix codes correspond to levels in between. You pass the prefix string as the parameter value.Does the API return employer contact details or application links for job postings?+
get_job_detail response includes a company object and description, but direct application URLs, recruiter email addresses, and employer contact fields are not currently exposed as discrete response fields. You can fork this API on Parse and revise it to add an endpoint that surfaces those fields if the underlying listing data includes them.Is pagination supported across all listing endpoints?+
search_jobs supports explicit page and page_size parameters and returns totalPages and totalResults for cursor management. The convenience endpoints get_green_jobs and get_apprenticeship_jobs return totalResults but do not currently expose pagination parameters. You can fork this API on Parse and revise those endpoints to add page and page_size support.