LinkedIn to Best Personal Email (US-only)
The LinkedIn to Best Personal Email API turns a LinkedIn profile into a valid personal email address in a single call. This endpoint is US-only data. It supports single lookups (linkedin_url) and batch lookups of up to 100 profiles at once (linkedin_urls).
Pass a LinkedIn URL or slug and get back the highest-confidence personal email MoltSets holds for that person, along with the date it was last validated. Cached validations are refreshed on a 90-day freshness window, so last_validated_at tells you exactly how fresh the check is. It can be null — a catch-all domain or a validation error leaves no date — so read risk_score alongside it.
Use this endpoint to:
- Get the single best personal email for a contact, with confidence
- Confirm an email is still active before sending
- Enrich records where deliverability matters most
Fair Use Policy: This API is subject to our Fair Use Policy for Enrichment.
Plan Availability:
This endpoint is not available on every plan. Access is set by price tier — call get_account and read personal_email_available. Where it is false, use linkedin_to_business_email instead, or contact support@moltsets.com to request access.
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.
Headers
Identifies the calling client. Any non-empty value is accepted — MoltSets does not validate its contents. Requests without this header are rejected with 403 Forbidden (error.code: forbidden).
Body
Response
Success
