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.
Personal email limit:
On the $397 / month and $997 / month plans, personal email results are capped at 15k per 5 hours and 75k per week, counted across every tool that returns a personal email. Past the cap, the record is still returned without the personal email, and carries a personal_email_redacted object with reason (fair_use_limit_exceeded), message, and retry_after. Nothing is charged for withheld data.
Batch responses:
A batch call returns results as a list with one entry per input: { "input", "data", "status" }. data has the same fields as a single lookup. There is no top-level status, so read each entry’s status and match entries to inputs by input. metadata adds total_requested, total_processed, total_with_data, total_without_data, and total_errored.
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
Headers
Body
Response
Success
