LinkedIn to Best Email
The LinkedIn to Email API finds the best available email address for any LinkedIn profile. It supports single lookups (linkedin_url) and batch lookups of up to 100 profiles at once (linkedin_urls).
It returns a valid business email when one exists, and automatically falls back to a personal email if not, so you get a result whenever the data is available. The type field in the response tells you which kind was returned. Use this as your default LinkedIn-to-email enrichment endpoint when the type of email doesn’t matter to you.
Use this endpoint to:
- Enrich LinkedIn-sourced leads with a working email address
- Maximise match rate across business and personal inboxes
- Fill contact records that only have a LinkedIn URL
Fair Use Policy: This API is subject to our Fair Use Policy for Enrichment.
Outcomes:
A lookup that finds nothing is not an error. It returns HTTP 200 with status: "not_found", empty or null results, and the usual metadata — and costs no tokens, though it still counts as one request against your Fair Use requests limit. Read status, not the HTTP code, to tell a hit from a miss. The API’s only 404 is an unknown or retired tool name.
Authorizations
Pass your API key as a Bearer token. Keys follow the format ms_XXXXXXXXXXX.
Body
Response
Success
ok when the lookup found data, not_found when it completed but matched nothing. A miss is still HTTP 200 and costs no tokens.
ok, not_found Per-call metadata. fair_use is always present on a tool call; the remaining fields appear only where they apply.