Sign in

v1

latestOpenAPI 3.0.32026-07-222085264.6 KB
Job APIs
Search APIs

Autocomplete values for a job search field

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.

<Note> Default `rate-limit` is 30 requests per minute. Send an email to [gtm@crustdata.co](mailto:gtm@crustdata.co) to discuss higher limits if needed for your use case. </Note>
post/job/search/autocomplete

Headers

x-api-version'2025-11-01' required
Example:2025-11-01

API version to use. This endpoint currently requires 2025-11-01.

Request body

fieldstring required

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.

querystring required

Partial text to match against the field's values. May be an empty string to return top values.

limitinteger

Maximum number of suggestions to return. Must be between 1 and 100.

Example request

{
  "field": "title",
  "query": "Software",
  "limit": 50
}

Response

Matching suggestions for the requested field and query.

Example response

{
  "suggestions": [
    {
      "value": "Software Engineer"
    },
    {
      "value": "Software Engineering Manager"
    }
  ]
}