Integration guides
Which endpoint should I use?
UpdatedPick the right Reverse Contact endpoint for profile lookup, enrichment, search, and live scraping.
Not sure where to start? Tell us what you have and we'll show you the fastest way to get the data you need.
Pick your starting point
- I have a Social URL → Get their full profile
- I have an email, name, or domain → Find the matching profile
- I have filters (job title, location...) → Search our database
- I can describe the people I want in a sentence → Agentic Search
- I need a professional email address → Find an email
Profiles
Turn a Social URL into a complete person or company profile.
| Endpoint | Credits | Delivery | When to use |
|---|---|---|---|
POST /v2/fetch/persons/check | 0 | Sync | Check if a person profile exists before spending credits |
POST /v2/fetch/companies/check | 0 | Sync | Check if a company profile exists before spending credits |
POST /v2/fetch/persons | 1 | Sync | Retrieve a cached person profile. Fast and cheap |
POST /v2/fetch/companies | 1 | Sync | Retrieve a cached company profile. Fast and cheap |
POST /v2/fetch/persons/live | 2 | Async | Force a fresh scrape when you need the latest data |
POST /v2/fetch/companies/live | 2 | Async | Force a fresh scrape when you need the latest data |
Enrichment
Find a profile when you don't have a Social URL. Send the details you have, get the full profile back in the same response.
| Endpoint | Credits | Delivery | Input |
|---|---|---|---|
POST /v2/enrich/persons | 2 | Sync | Any combination of email, name, company name or domain |
POST /v2/enrich/companies | 2 | Sync | A company domain (e.g. acme.com) |
Search
Query our database of indexed profiles with filters. No Social URL needed.
| Endpoint | Credits | Delivery | When to use |
|---|---|---|---|
POST /v2/search/people | 1 per profile | Sync | Search people by function, seniority, title, location, company... |
POST /v2/search/people/prompt | 1 per page + 1 per profile | Sync | Describe the people you want in plain language instead of building filters |
POST /v2/search/people/count | 0 | Sync | Count matching people before spending credits |
POST /v2/search/companies | 1 | Sync | Search companies by industry, size, location... |
Contact
Find a professional email address from a LinkedIn profile URL, or from a person's full name and company domain.
| Endpoint | Credits | Delivery | When to use |
|---|---|---|---|
POST /v2/contact/email | 3 when found | Async webhook | Find a professional email address |
Sync vs async
Most endpoints return data instantly in the API response. Live endpoints and the Contact Email Finder deliver their results asynchronously.