AMS APIjobs.ams.at ↗
Get job title autocomplete suggestions from Austria's AMS public employment service. Typeahead endpoint returns matching titles with IDs for job search interfaces.
What is the AMS API?
This API exposes 1 endpoint against Austria's public employment service (AMS) job database, returning autocomplete suggestions for job title search interfaces. The get_suggestions endpoint accepts a text prefix and returns an array of matching job title objects, each carrying a unique integer ID and a display string — enough to wire up a functional typeahead in any job search application targeting the Austrian labour market.
curl -X GET 'https://api.parse.bot/scraper/78cbcd5c-9119-42e9-8f44-df60d1c765d3/get_suggestions?count=5&query=Software' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace jobs-ams-at-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: AMS Job Suggestions API — bounded, re-runnable."""
from parse_apis.ams_job_suggestions_api import AMS, NotFoundError
client = AMS()
# Search for job title suggestions matching a prefix
for suggestion in client.suggestions.search(query="Software", limit=5):
print(suggestion.id, suggestion.text)
# Drill-down: get the first suggestion for a different query
first = client.suggestions.search(query="Koch", limit=1).first()
if first:
print(f"Top match for 'Koch': {first.text} (id={first.id})")
# Typed error handling around a search call
try:
results = client.suggestions.search(query="Lehrer", limit=3)
for s in results:
print(s.id, s.text)
except NotFoundError as exc:
print(f"Error: {exc}")
print("exercised: suggestions.search with multiple queries and limit control")
Get job title autocomplete suggestions based on a search prefix. Returns matching job titles from the AMS job database. Useful for building search interfaces with typeahead functionality.
| Param | Type | Description |
|---|---|---|
| count | integer | Maximum number of suggestions to return |
| queryrequired | string | Search prefix for job titles (e.g. 'Software', 'Koch', 'Lehrer') |
{
"type": "object",
"fields": {
"suggestions": "array of suggestion objects each containing id (integer) and text (string)"
},
"sample": {
"data": {
"suggestions": [
{
"id": 388,
"text": "SoftwareentwicklerIn"
}
]
},
"status": "success"
}
}About the AMS API
What the API Returns
The single get_suggestions endpoint queries the AMS job title database using a search prefix supplied via the required query parameter. Responses contain a suggestions array where each element includes an id (integer) and a text (string) field. The text field holds the human-readable job title as it appears in AMS records — for example, submitting 'Koch' returns culinary-role titles, while 'Software' returns software-related positions.
Parameters and Behaviour
Two inputs are accepted: query (required string) and count (optional integer). The count parameter caps how many suggestion objects are returned, making it straightforward to tune the list length to your UI needs — a compact dropdown might request 5, while a richer autocomplete panel might request 20. The id returned with each suggestion corresponds to AMS's internal job-title identifier, which can be used to reference a specific occupation category within the AMS taxonomy.
Coverage and Scope
The data covers Austrian job titles catalogued by AMS (Arbeitsmarktservice Österreich), the country's official public employment service. Titles span sectors from trades and hospitality to technical and professional roles, and are matched against the beginning of the search string. The endpoint works with both German-language inputs (the primary language of AMS listings) and partial strings, making it suitable for building search-as-you-type experiences for Austrian job portals.
The AMS API is a managed, monitored endpoint for jobs.ams.at — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when jobs.ams.at changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official jobs.ams.at API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Autocomplete job title fields in Austrian job board search forms using
textvalues fromget_suggestions - Validate and normalise free-text job title input against official AMS occupation titles
- Populate occupation-category dropdowns dynamically using AMS title IDs returned in the
idfield - Build multilingual Austrian HR tools that map user input to canonical AMS job title strings
- Pre-populate job alert setup forms with standardised occupation titles from the AMS database
- Test or benchmark typeahead performance by comparing suggestion counts across different
countparameter values
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does AMS provide an official public developer API?+
What exactly does the `get_suggestions` endpoint return, and how do I control the number of results?+
suggestions array of objects. Each object contains an id (integer identifying the occupation in the AMS taxonomy) and a text (string with the full job title). To limit results, pass an integer via the count parameter. If count is omitted, the endpoint returns the default number of matches for the given prefix.Does the API return full job listings, salary data, or employer information?+
Does the API support filtering suggestions by job category, region, or employment type?+
get_suggestions endpoint accepts only a text query prefix and an optional count. Filtering by region, sector, or employment type is not available in the response shape. You can fork this API on Parse and revise it to add those filter parameters if your use case requires narrower results.Are the job titles returned in German only?+
text field in each suggestion will reflect German-language occupation titles. English or other language prefixes may return no results or partial matches depending on whether the AMS database contains equivalent entries.