---
title: "Autocomplete values for a job search field"
method: POST
path: "/job/search/autocomplete"
tags: ["Job APIs", "Search APIs"]
---

# Autocomplete values for a job search field

`POST /job/search/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.

<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>

## Headers

- `x-api-version` '2025-11-01', required

## Request body

- JobAutocompleteRequest — Request body for autocompleting the values of a single `/job/search` field.
  - `field` string, 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`.
  - `query` string, required — Partial text to match against the field's values. May be an empty string to return top values.
  - `limit` integer — Maximum number of suggestions to return. Must be between 1 and 100.

## Response `200`

Matching suggestions for the requested field and query.

- JobAutocompleteResponse — Autocomplete suggestions for the requested field and query.
  - `suggestions` JobAutocompleteSuggestion[], required — Matching values for the requested field, ordered by relevance. Empty when nothing matches.
    - `value` string, required — A suggested value for the requested field.

## Other responses

- `400` — Invalid request - missing or unsupported `field`, missing `query`, or `limit` out of range.
- `401` — Unauthorized - invalid or missing API key
- `500` — Internal server error

---

[API](https://skmtc.net/crustdata/apis/batch-api.md) · [All operations](https://skmtc.net/crustdata/apis/batch-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/crustdata/batch-api/versions/581689e66ae7/schema)