API Reference › Search › Find LinkedIn profile

Phase 2 / planned endpoint

POST/search_linkedin_profile

Find LinkedIn profile

Resolve a person to a LinkedIn profile URL using name, company, title, or location signals. Returns the best candidate profile when confidence is sufficient.

Request body

JSON object

Bearer auth required

full_namestring

Person name to match.

Example: Avery Lin

company_domainstring

Employer domain to disambiguate common names.

Example: northstar.dev

titlestring

Optional job title hint.

Example: Account Executive

Response

200 · Processed

application/json

A processed request returns status: "ok". The nested result may be empty; in that case tokens_charged remains zero.

results.linkedin_url

Best-match LinkedIn profile URL.

results.confidence

Match confidence score for the candidate.

metadata.tokens_charged

Credits charged for the returned result. Zero for a miss.

metadata.fair_use

Remaining records and reset timestamps for applicable plan windows.

Errors

400

Malformed request body

401

Missing or invalid API key

422

Unsupported filter value

429

Rate limit exceeded