Enrich profile

get

https://api.pearch.ai/v1/profile

Test this endpoint in the playground
Check out official Python client

Retrieve enriched user profile based on the provided Linkedin profile ID or email address as a query parameter. Linkedin profile ID is the part that comes after https://www.linkedin.com/in/ in the profile URL.

You can provide docid (LinkedIn profile ID) or email. If only email is provided, the system will attempt to resolve it to a LinkedIn profile.

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 instead of docid 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.

PRICING

CHECK HOW OUR CREDIT SYSTEM WORKS

KNOWLEDGE BASE

Insights and Research from PEARCH AI team

Query Params

docid

string

The linkedin profile ID of the profile to retrieve. Linkedin profile ID is the part that comes after https://www.linkedin.com/in/ in the profile URL. Provide docid or email.

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

high_freshness

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). Scraped results are cached for up to 24 hours. If you are ok with profiles that may be a few months outdated, turn off high_freshness. Cost: 2 credits

reveal_emails

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

reveal_phones

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

with_profile

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

200Profile retrieved successfully