Get Valid Emails

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.

POST

linkedin_to_best_email

curl --request POST \
  --url https://api.moltsets.com/api/v1/tools/linkedin_to_best_email \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "linkedin_url": "https://linkedin.com/in/retentionadam"
}
'

{
  "results": {
    "email": "john.smith@example.com",
    "risk_score": "A",
    "type": "business",
    "last_validated_at": "2026-03-04"
  },
  "status": "ok",
  "metadata": {
    "fair_use": {
      "records_remaining_5h": 179999,
      "records_reset_5h": "2026-07-15T18:53:16Z",
      "records_remaining_1w": 899999,
      "records_reset_1w": "2026-07-22T13:53:16Z"
    }
  }
}

{
  "error": "Bad Request",
  "message": "The server cannot process the request due to a client error (400 Bad Request)."
}

{
  "error": "Unauthorized",
  "message": "Invalid API key."
}

{
  "results": {
    "email": null,
    "type": null,
    "last_validated_at": null
  },
  "status": "not_found",
  "metadata": {
    "fair_use": {
      "records_remaining_5h": 179999,
      "records_reset_5h": "2026-07-15T18:53:16Z",
      "records_remaining_1w": 899999,
      "records_reset_1w": "2026-07-22T13:53:16Z"
    }
  }
}

{
  "error": "Invalid Input",
  "message": "Message describing the nature of the invalid input."
}

{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Maximum 100 requests per second."
}

{
  "error": {
    "code": "internal_error",
    "message": "Unexpected connection error."
  },
  "metadata": {}
}

Authorizations

Authorization

string

header

required

Pass your API key as a Bearer token. Keys follow the format ms_XXXXXXXXXXX.

Body

application/json

linkedin_url

string

Single LinkedIn profile URL or slug.

linkedin_urls

string[]

Batch of LinkedIn profile URLs or slugs, up to 100.

Maximum array length: 100

Response

Success

results

object

Show child attributes

status

string

Example:

"ok"

metadata

object

Show child attributes

curl --request POST \
  --url https://api.moltsets.com/api/v1/tools/linkedin_to_best_email \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "linkedin_url": "https://linkedin.com/in/retentionadam"
}
'

{
  "results": {
    "email": "john.smith@example.com",
    "risk_score": "A",
    "type": "business",
    "last_validated_at": "2026-03-04"
  },
  "status": "ok",
  "metadata": {
    "fair_use": {
      "records_remaining_5h": 179999,
      "records_reset_5h": "2026-07-15T18:53:16Z",
      "records_remaining_1w": 899999,
      "records_reset_1w": "2026-07-22T13:53:16Z"
    }
  }
}

{
  "error": "Bad Request",
  "message": "The server cannot process the request due to a client error (400 Bad Request)."
}

{
  "error": "Unauthorized",
  "message": "Invalid API key."
}

{
  "results": {
    "email": null,
    "type": null,
    "last_validated_at": null
  },
  "status": "not_found",
  "metadata": {
    "fair_use": {
      "records_remaining_5h": 179999,
      "records_reset_5h": "2026-07-15T18:53:16Z",
      "records_remaining_1w": 899999,
      "records_reset_1w": "2026-07-22T13:53:16Z"
    }
  }
}

{
  "error": "Invalid Input",
  "message": "Message describing the nature of the invalid input."
}

{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Maximum 100 requests per second."
}

{
  "error": {
    "code": "internal_error",
    "message": "Unexpected connection error."
  },
  "metadata": {}
}

Search

Get Valid Emails

Get Carrier-Verified Mobile Phones

Reverse Lookups

Get Ad Audience

Get LinkedIn

Get Company

Account

LinkedIn to Best Email

Authorizations

Body

Response