Skip to main content
Use this when you need to discover valid filter values before building a Company Search query — for example, finding the exact industry label or country code the API expects. The Company Autocomplete API helps you discover the exact field values the indexed Company Search API expects. Use it before you build filters for industries, geographies, company types, funding stages, and more. Every request goes to the same endpoint: 
POST https://api.crustdata.com/company/search/autocomplete
Replace YOUR_API_KEY in each example with your actual API key. All requests require the x-api-version: 2025-11-01 header.

​
Request fields

FieldTypeRequiredDescription
fieldstringYesSearchable company field to autocomplete, such as basic_info.industries, taxonomy.professional_network_industry, or locations.country.
querystringYesPartial text to match. Use "" to get the most common values.
limitintegerNoMaximum suggestions to return. Default: 20. Max: 100.
filtersobjectNoOptional condition or nested and/or group to narrow the suggestion pool.

​
Response body

FieldTypeDescription
suggestionsarrayMatching values sorted by relevance (or by frequency when query is empty).
suggestions[].valuestringThe exact field value to reuse in a Company Search filter.

​
Rate limits and pricing

Pricing: Free.
  • Rate limits: For current plan-specific limits, see Rate limits.

Recipes

Autocomplete names, most common values, filtered suggestions, and the Autocomplete → Search workflow.

Reference

Supported fields, filter operators, errors, API summary.

​
When to use autocomplete

Use this endpoint when you want to:
  • Build filter dropdowns or typeahead inputs in your product.
  • Validate the exact values a Company Search filter expects.
  • Explore the dataset vocabulary for a field before writing search queries.

​
Your first autocomplete request: discover industry values

Start with the field you want to query and a partial search string. Here, tech returns matching values from basic_info.industries. 
curl --request POST \
	--url https://api.crustdata.com/company/search/autocomplete \
	--header 'authorization: Bearer YOUR_API_KEY' \
	--header 'content-type: application/json' \
	--header 'x-api-version: 2025-11-01' \
	--data '{
		"field": "basic_info.industries",
		"query": "tech",
		"limit": 5
	}'

​
Understanding the response

Autocomplete returns an object with one key:
  • suggestions — an array of matching values, sorted by relevance. Each suggestion contains:
    • value — the exact field value to reuse in a Company Search filter.
Use the returned value exactly as-is in your next search request. This avoids empty results caused by typos, casing differences, or unsupported variants. When query is non-empty, suggestions are ranked by match relevance. When query is an empty string, suggestions are ranked by frequency.

​
What to do next

  • Try more patterns — see Recipes for company-name autocomplete, most-common values, and filtered suggestions.
  • Look up supported fields and operators — see Autocomplete reference.
  • Use values in a search — head to Company Search once you’ve picked a value.
  • Enrich a company — use Company Enrich after you find a company.