Skip to main content
POST
https://api.crustdata.com
/
company
/
search
/
autocomplete
curl --request POST \
  --url https://api.crustdata.com/company/search/autocomplete \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-version: <x-api-version>' \
  --data '
{
  "field": "basic_info.industries",
  "query": "tech",
  "limit": 5
}
'
{
  "suggestions": [
    {
      "value": "Technology, Information and Media",
      "document_count": 2074162
    },
    {
      "value": "Technology, Information and Internet",
      "document_count": 1373419
    },
    {
      "value": "Information Technology & Services",
      "document_count": 196383
    },
    {
      "value": "Biotechnology Research",
      "document_count": 51297
    },
    {
      "value": "Technical and Vocational Training",
      "document_count": 35871
    }
  ]
}

Authorizations

​
Authorization
string
header
required

API key passed as a Bearer token in the Authorization header.

Headers

​
x-api-version
string
required

API version to use. Must match a supported version (e.g., "2025-11-01").

Example:

"2025-11-01"

Body

application/json

Field name, query text, and optional filters for autocomplete

Request body for autocomplete suggestions on company search fields.

​
field
string
required

The dataset API field name to get suggestions for. Must be a field from the /company/search response schema (e.g., 'basic_info.name', 'basic_info.industries', 'locations.hq_country').

Example:

"basic_info.industries"

​
query
string
required

The search query text (can be empty to get top values by frequency)

Example:

"tech"

​
limit
integer
default:20

Maximum number of suggestions to return

Required range: 1 <= x <= 100
​
filters
object

Optional filters to narrow down suggestions

Example:
{
  "field": "locations.hq_country",
  "type": "=",
  "value": "USA"
}

Response

Autocomplete suggestions with document counts

Response containing autocomplete suggestions with document counts.

​
suggestions
object[]
required

List of autocomplete suggestions

Example:
[
  {
    "value": "Technology, Information and Media",
    "document_count": 2074162
  }
]