You are viewing the documentation of the new API versions. We would love to hear from you. You can write to use at support@crustdata.co for feedback and clarifications.
Group placeholder
Autocomplete
Return ranked field-value suggestions for any supported person
search field. Use this endpoint to discover the exact indexed values that
/person/search filters expect — feed the suggestion value back into a search filter
verbatim to retrieve the matching profiles.
Pass a partial query string for type-ahead behaviour, or pass an empty query to
retrieve the most common values for the field by frequency. An optional filters scope
lets you compute autocomplete results against a subset of the dataset (for example, top
job titles among current Google employees in the United States).
The top-level field must be one of the supported autocomplete fields — an allowlisted
subset of the field names used by /person/search, not every field exposed in its
request and response schemas. Sending an unsupported field returns a 400 whose error
message lists every accepted field.
Default rate-limit is 15 requests per minute. Send an email to gtm@crustdata.co to discuss higher limits if needed for your use case.
Documentation Index
Fetch the complete documentation index at: https://docs.crustdata.com/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
API key passed as a Bearer token in the Authorization header.
Headers
API version to use. This endpoint currently requires 2025-11-01.
2025-11-01 "2025-11-01"
Body
Specify the dataset field to autocomplete, the partial query text to match against, an optional limit (1-100, default 20), and an optional filters scope that narrows the population the suggestions are computed against.
Request body for autocomplete suggestions on person search fields.
The dataset API field name to get suggestions for. Valid fields include: basic_profile.name, basic_profile.headline, basic_profile.languages, basic_profile.location, basic_profile.location.raw, basic_profile.location.city, basic_profile.location.state, basic_profile.location.country, basic_profile.location.continent, professional_network.location, professional_network.location.raw, professional_network.location.city, professional_network.location.state, professional_network.location.country, professional_network.location.continent, skills.professional_network_skills, experience.employment_details.current.name, experience.employment_details.current.title, experience.employment_details.current.seniority_level, experience.employment_details.current.function_category, experience.employment_details.current.company_industries, experience.employment_details.current.company_type, experience.employment_details.current.company_hq_location, experience.employment_details.current.company_website_domain, experience.employment_details.past.name, experience.employment_details.past.title, education.schools.school, education.schools.degree, education.schools.field_of_study, certifications.name, certifications.issuing_organization, honors.title
"basic_profile.location.city"
The search query text (can be empty to get top values by frequency)
"VP"
Maximum number of suggestions to return
1 <= x <= 100Optional filters to narrow down suggestions. Filter field names use the same dataset API field names.
- Option 1
- Option 2
Show child attributes
Show child attributes
{
"field": "experience.employment_details.current.company_name",
"type": "=",
"value": "Retool"
}
Response
Ranked autocomplete suggestions for the requested person search field.
Response with autocomplete suggestions for a person search field.
Show child attributes
Show child attributes
Was this page helpful?