Enrich profile

Retrieve an enriched profile using a LinkedIn profile ID, profile UUID, or email address. A LinkedIn profile ID is the part after https://www.linkedin.com/in/ in the profile URL.

Provide a LinkedIn profile ID in docid, a profile UUID in either uuid or docid, or an email. If only email is provided, the system attempts to resolve it to a LinkedIn profile. A UUID in either field uses masked profile enrichment and includes the full profile and available emails and phones.

Set fast=true to prioritize speed when retrieving requested emails and phone numbers. This can reduce response time but may return fewer contacts than standard enrichment. The default is false. This option is separate from /v2/search's type.

Costs: A UUID in uuid or docid costs 25 credits for masked enrichment. For a LinkedIn slug in docid, costs are additive: with_profile costs 1 credit, high_freshness costs 2 credits, and reveal_emails and reveal_phones cost 6 credits each when contact data is found. Looking up a profile by email costs 6 credits and is separate from reveal_emails.

Rate limit: 60 requests per user per 60 seconds. When the rate limit is exceeded, the API returns HTTP 429 with details about the triggered window, current value, and limit.

Query Params
string

LinkedIn profile slug (the part after https://www.linkedin.com/in/) or a profile UUID. Slugs use additive profile and contact pricing. A UUID uses masked enrichment, as with uuid. Cost: 25 credits for UUID lookup

uuid

Profile UUID, including one from a masked search result. Uses masked enrichment, as does a UUID in docid. Cost: 25 credits for UUID lookup

string

Email address to look up. If provided without docid, the system will resolve the email to a LinkedIn profile. This lookup is separate from reveal_emails. Cost: 6 credits for email lookup

boolean

Enable real-time profile updates for fresher data. This downloads the most recent copies of profiles directly from source websites in realtime (e.g. Linkedin). If you are ok with profiles that may be a few months outdated, turn off high_freshness. Refreshed roles include employment_type when the source provides it. Cost: 2 credits

boolean
Defaults to false

Prioritize speed when retrieving requested emails and phone numbers. Can reduce response time, but may return fewer contacts than standard enrichment. This option is separate from /v2/search's type.

boolean

Include email addresses in the profile if available. Cost: 6 credits, only charged if the profile has at least one email address. Deprecated name: show_emails

boolean

Include phone numbers in the profile if available. Cost: 6 credits, only charged if the profile has at least one phone number. Deprecated name: show_phone_numbers

boolean

Include full profile data in the response. Cost: 1 credit

Responses

400

Invalid parameter values or missing required parameters. At least one of docid, uuid, or email must be provided. JSON body contains the error message.

401

Invalid API key

404

Profile not found

429

Rate limit exceeded. JSON body contains the triggered window, current value, and limit.

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json