Build a Forager API request
Pick an endpoint, fill in the parameters and copy the request in the language you use. Each one shows what comes back, what it costs in credits and where to run it for real.
Which endpoint?
Nothing is sent from this page and no key is entered here: the samples read your key and account ID from environment variables. Every sample response is fictional (example domains, 555 numbers, made-up names).
Person profile
POST /api/{account_id}/datastorage/person_detail_lookup/
The profile for one person: roles, education, skills and location.
1 credit · charged per request
Mobile number
POST /api/{account_id}/datastorage/person_contacts_lookup/phone_numbers/
The mobile number for a person.
15 credits · charged only when data comes back
Work email
POST /api/v2/{account_id}/datastorage/person_contacts_lookup/work_emails/
An address at the person’s current employer, checked for deliverability. The lookup runs as a job.
5 credits · charged only when data comes back
Personal email
POST /api/{account_id}/datastorage/person_contacts_lookup/personal_emails/
Addresses on consumer mail providers for a person.
5 credits · charged only when data comes back
Person by email
POST /api/{account_id}/datastorage/person_detail_reverse_lookup/by_email/
The person behind a personal email address: the same profile shape as the person lookup.
5 credits · charged per request
People search
POST /api/{account_id}/datastorage/person_role_search/
People by role, company and more. Each page of results is one call.
1 credit · charged per request
Company search
POST /api/{account_id}/datastorage/organization_search/
Companies by domain, size, founding date and more. Each page is one call.
1 credit · charged per request
Job postings
POST /api/{account_id}/datastorage/job_search/
Open roles by title, company and source. Each page is one call.
2 credits · charged per request
Every request is a POST to https://api-v2.forager.ai with your API key in the X-API-KEY header and your account ID in the path. Paths and parameters here are read from the API reference’s OpenAPI file; fields the playground leaves out are documented on each endpoint’s reference page.
Run it on your own records
- $5 free credits
- No credit card
- Run your sample