Skip to main content
Use this when you need to discover exact indexed values before building a Search Jobs query — for filter dropdowns, input validation, dataset exploration, or guided query builders. The Job Autocomplete API returns ranked field-value suggestions so you can feed the result straight into a Search Jobs filter without guessing at valid values.
This endpoint returns field values, not job listings. It also has no pagination or cursor — the limit parameter (max 100) is the only way to control result size. To fetch job records, use Search Jobs instead.
Replace YOUR_API_KEY in each example with your actual API key. All requests require the x-api-version: 2025-11-01 header.

​
At a glance

DetailValue
EndpointPOST https://api.crustdata.com/job/search/autocomplete
AuthAuthorization: Bearer YOUR_API_KEY
API versionx-api-version: 2025-11-01 header (required)
Requiredfield (string) · query (string, may be empty)
Optionallimit (integer, 1–100, default 20)
Response{ "suggestions": [ { "value": string } ] }
Errors400 invalid request · 401 unauthorized · 500 internal
PricingFree — autocomplete 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.

Examples

Most-common values, autocomplete companies and locations, and the Autocomplete → Search workflow.

Reference

Contract, request parameters, autocomplete-enabled fields, implementation tips, and errors.
You want to…Use
Discover valid filter values for a fieldAutocomplete (this page)
See the distinct values a field takes, rankedAutocomplete with an empty query
Return actual job listings matching filtersSearch Jobs
Build a type-ahead dropdown for a filter UIAutocomplete with a partial query

​
Quick start: discover job title values

Type-ahead lookup on a single field. Pass the user’s partial input as query and cap the dropdown size with limit. 
curl --request POST \
  --url https://api.crustdata.com/job/search/autocomplete \
  --header 'authorization: Bearer YOUR_API_KEY' \
  --header 'content-type: application/json' \
  --header 'x-api-version: 2025-11-01' \
  --data '{
    "field": "title",
    "query": "Software",
    "limit": 5
  }'
Each suggestion includes:
  • value — the exact indexed value stored against field. Use it verbatim as a Search Jobs filter value.
When no values match the query, the response returns an empty array — not a 404:
No results
{
    "suggestions": []
}

​
What to do next

  • Try more patterns — see Examples for most-common values, company and location autocomplete, and the Autocomplete → Search workflow.
  • Reference — see Autocomplete reference for request parameters, autocomplete-enabled fields, implementation tips, and errors.
  • Search for jobs — use discovered values in Search Jobs.