Use cases
Reverse Contact API use cases
NewLast verified
Find people, enrich companies, get work emails and build prospect lists with the Reverse Contact API. Follow code examples and check credit costs.
9 use cases shown
Find & enrich
Find a person from an email, a name or a profile URL
Enrich profile · Person profile · Person profile live
1 to 2 credits · live charged at job creation
Find & enrich
Find a company from a domain or a page URL
Enrich company · Company profile · Company profile live
1 to 2 credits · live charged at job creation
Find & enrich
Keep profiles fresh
Person profile status · Company profile status · Person profile live · Company profile live
status checks are free · 2 credits per live request
Contact
Get a work email or a phone number
Find Email · Verify Email · Find Phone
email lookup from 3 credits when found · verification 1 credit
Build lists
Build a list of people
People search · People search count · Agentic Search · People lookalike
1 credit per profile · Agentic +1 per page · count is free
Build lists
Build a list of companies
Company search · Company search count · Agentic Company Search
1 credit per company · Agentic +1 per page · count is free
At scale
Enrich up to 25,000 people in one request
Bulk enrichment · Get a job · Read job results by page · Download job results
priced like the unit calls
At scale
Keep contacts in a List and buy their emails
Create a List · Import members and data · Read a List operation · Export a List
identity + data costs · capped by maxCredits
At scale
Enrich a CSV file of contacts
Enrich profile · Bulk enrichment
priced like the unit calls
Choose a use case based on the data you have and the result you need. Each recipe gives you the endpoints, expected results and credit costs, with code from the first request to the result. Examples use cURL, the TypeScript SDK or the Python SDK, plus the CLI when a command is available.
Use cases at scale
For larger datasets, enrich up to 25,000 people in one request, keep contacts in a List and buy their emails, or enrich a CSV file of contacts. You can find these guides alongside the recipes in the use case gallery.
FAQ
Which Reverse Contact API endpoint should I use?
Choose the use case that matches your starting data and the result you need. Each recipe lists the endpoints and credit costs, with code to retrieve the result.
Can I follow the API use cases in TypeScript or Python?
The use case recipes include cURL, TypeScript SDK and Python SDK examples. You can also use CLI examples when a command is available.
How do I enrich contacts in bulk or from a CSV file?
Follow the Bulk enrichment guide for requests of up to 25,000 people, or the CSV enrichment guide for contact files. Use the Lists guide to store contacts and buy their emails.