Sign in

v1

latestOpenAPI 3.0.32026-07-222085264.6 KB
Person APIs
Autocomplete APIs

Get autocomplete suggestions for person search fields

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.

<Note> Default `rate-limit` is 45 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>
post/person/search/autocomplete

Headers

x-api-version'2025-11-01' required
Example:2025-11-01

API version to use. This endpoint currently requires 2025-11-01.

Request body

fieldstring required

The dataset API field name to get suggestions for. Valid fields include: basic_profile.name, basic_profile.first_name, basic_profile.last_name, basic_profile.headline, basic_profile.languages, basic_profile.location, basic_profile.location.raw, basic_profile.location.full_location, 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, professional_network.open_to_cards, 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.current.employment_type, experience.employment_details.past.name, experience.employment_details.past.title, experience.employment_details.past.seniority_level, experience.employment_details.past.function_category, experience.employment_details.past.company_type, experience.employment_details.past.company_hq_location, experience.employment_details.past.company_website_domain, experience.employment_details.past.employment_type, experience.employment_details.employment_type, education.schools.school, education.schools.degree, education.schools.field_of_study, certifications.name, certifications.issuing_organization, honors.title, open_to_cards, employment_type

querystring required

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

limitinteger

Maximum number of suggestions to return

Example request

{
  "field": "basic_profile.headline",
  "query": "Founder",
  "limit": 5
}

Response

Ranked autocomplete suggestions for the requested person search field.

Example response

{
  "suggestions": [
    {
      "value": "Founder, CEO"
    }
  ]
}