Skip to main content
POST
https://api.crustdata.com
/
person
/
search
/
autocomplete
Get autocomplete suggestions for person search fields
curl --request POST \
  --url https://api.crustdata.com/person/search/autocomplete \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-version: <x-api-version>' \
  --data '
{
  "field": "experience.employment_details.current.title",
  "query": "CEO",
  "limit": 5
}
'
{
  "suggestions": [
    {
      "value": "CEO",
      "document_count": 1046463
    },
    {
      "value": "Founder & CEO",
      "document_count": 168935
    },
    {
      "value": "ceo",
      "document_count": 81666
    }
  ]
}

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 limit for autocomplete suggestions.

Request body for autocomplete suggestions on person search fields.

​
field
string
required

The dataset API field name to get suggestions for. Must be a field from the /person/search response schema (e.g., 'basic_profile.headline', 'basic_profile.current_title', 'experience.employment_details.current.title').

Example:

"basic_profile.headline"

​
query
string
required

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

Example:

"VP"

​
limit
integer
default:20

Maximum number of suggestions to return

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

Optional filters to narrow down suggestions. Filter field names use the same dataset API field names.

Example:
{
  "field": "experience.employment_details.current.company_name",
  "type": "=",
  "value": "Google"
}

Response

Autocomplete suggestions with document counts

Response containing autocomplete suggestions with document counts.

​
suggestions
object[]
required
Example:
[
  { "value": "CEO", "document_count": 1046463 }
]