API Reference › Valid emails › LinkedIn → best email

Phase 1 / planned endpoint

POST/linkedin_to_best_email

LinkedIn → best email

Resolve a LinkedIn profile URL to the best available email. Business email is preferred; personal email is the fallback when no business address is found.

Request body

JSON object

Bearer auth required

linkedin_urlstring

Public LinkedIn profile URL.

Example: https://linkedin.com/in/avery-lin

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.email

Resolved email address.

results.type

business or personal.

results.risk

Validation risk label (valid, catch-all, etc.).

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