Autocomplete and lookup endpoints (e.g. industries) for dropdowns and search, powered by Typesense.
Get industries (autocomplete)
Search the industries Typesense collection and return matching values for autocomplete. Results include id and name.
Authentication: All requests require ONLY the X-API-Key header with your API key. Do not use the Authorization header - it is not required for this endpoint.
query Parameters
textstring · requiredSearch text for autocomplete (prefix match on industry name).
limitinteger · min: 1 · max: 100Maximum number of results to return (default 20, max 100).
Default: 20
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.X-API-Keystring · requiredRequired. Your API key for authentication. This is the only authentication header needed for this endpoint. Do not use the Authorization header.
Responses
List of matching industries with id and name.
idnamestring | null
Enrich job title (lookup)
Call People Data Labs job title enrich API. Returns a normalized job title, similar job titles, and relevant skills for the given job title.
Authentication: All requests require ONLY the X-API-Key header with your API key.
query Parameters
job_titlestring · requiredJob title to enrich (e.g. supply manager).
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.X-API-Keystring · requiredRequired. Your API key for authentication.
Responses
Enriched job title data.
cleaned_job_titlestringNormalized job title
similar_job_titlesstring[]Similar job titles
relevant_skillsstring[]Relevant skills for the job title
Get companies (lookup)
Search the companies Typesense collection by name, LinkedIn profile URL, or website. Returns matching company documents (name, linkedin_url, website, industry, size, country, region, locality, founded, etc.). At least one of name, profile, or website must be provided.
Authentication: All requests require ONLY the X-API-Key header with your API key.
query Parameters
namestringCompany name to search (e.g. nvidia).
profilestringLinkedIn company profile URL to search (e.g. linkedin.com/company/google).
websitestringCompany website to search (e.g. www.peopledatalabs.com).
limitinteger · min: 1 · max: 100Maximum number of results to return (default 20, max 100).
Default: 20
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.X-API-Keystring · requiredRequired. Your API key for authentication.
Responses
List of matching companies (name, linkedin_url, website, industry, size, country, region, locality, founded, etc.).
namestringlinkedin_urlstringwebsitestringfoundedintegerindustrystringsizestringcountrystringregionstringlocalitystring
Sandbox: Get industries (autocomplete)
Same as /v1/lookups/industries. No behavior change.
query Parameters
textstring · requiredlimitintegerDefault: 20
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.X-API-Keystring · required
Responses
List of matching industries
Sandbox: Get companies (lookup)
Same as /v1/lookups/companies. No behavior change.
query Parameters
namestringprofilestringwebsitestringlimitintegerDefault: 20
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.X-API-Keystring · required
Responses
List of matching companies
Sandbox: Enrich job title (static response)
Returns a fixed job title enrich response (python developer example). No external API call.
query Parameters
job_titlestring
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.X-API-Keystring · required
Responses
Static job title enrich data