Autocomplete
Return type-ahead suggestions for the values of a single /job/search field.
Pass the field you intend to filter on (for example title or category) and a
partial query, and the endpoint returns matching values drawn from the indexed job
dataset. Use it to power autocomplete inputs or to discover the exact values a filter
will accept before issuing a POST /job/search request.
This endpoint does not consume credits.
Default rate-limit is 30 requests per minute. Send an email to gtm@crustdata.co to discuss higher limits if needed for your use case.
Authorizations
API key passed as a Bearer token in the Authorization header.
Headers
API version to use. This endpoint currently requires 2025-11-01.
2025-11-01 "2025-11-01"
Body
The field to autocomplete, the partial query to match, and an optional result limit.
Request body for autocompleting the values of a single /job/search field.
The /job/search field whose values to autocomplete. Accepts the same
names used in /job/search filters, plus their short aliases.
Common values: title, category, company.name, company.industries,
location.country, location.city, location.state.
Full set of supported fields: category, city,
company.basic_info.industries, company.basic_info.name,
company.basic_info.primary_domain, company.funding.investors,
company.funding.last_round_type, company.headcount.largest_country,
company.headcount.range, company.industries, company.locations.city,
company.locations.country, company.locations.state, company.name,
company.revenue.acquisition_status,
company.revenue.public_markets.fiscal_year_end,
company.revenue.public_markets.stock_symbols, continent, country,
country_code, district, fiscal_year_end, job_category,
job_details.category, job_details.title, job_details.workplace_type,
job_title, location, location.city, location.country,
location.district, location.raw, location.state, locations.city,
locations.country, locations.district, locations.location,
locations.state, state, title, workplace_type.
"title"
Partial text to match against the field's values. May be an empty string to return top values.
"Software"
Maximum number of suggestions to return. Must be between 1 and 100.
1 <= x <= 10050
Response
Matching suggestions for the requested field and query.
Autocomplete suggestions for the requested field and query.
Matching values for the requested field, ordered by relevance. Empty when nothing matches.
[
{ "value": "Software Engineer" },
{ "value": "Software Engineering Manager" }
]