Supply a candidate-data API with personal emails and mobiles for recruiting platforms
Let a candidate-data aggregator return personal emails and mobiles to the recruiting platforms that call its API, filling records its other sources missed.
- Free API key
- No credit card
- Run your sample
A selection of teams that run this job on Forager · plus other teams on Forager
Uses POST /person_detail_lookup/, POST /person_contacts_lookup/phone_numbers/ · Person enrichment API reference
What it costs: 15 credits per mobile found · 5 credits per email found. A mobile or email lookup that returns nothing costs 0 credits. Enrichment and search are charged per request: credit pricing.
- Personal emails
- Mobile numbers
- Person enrichment
- API
- Data reseller
- HR tech
How the data flows
POST /person_detail_lookup/ - personal email
- priya.f@example.net
- phone number
- +44 20 7946 0958
- name
- Priya Fixture
- title
- VP Revenue Operations
- work email
- priya@example.com
- company
- Example Inc.
Steps
- Resolve each candidate with
POST /person_detail_lookup/ - Fetch
personal_emailfrom/person_contacts_lookup/personal_emails/ - Fetch mobiles from
POST /person_contacts_lookup/phone_numbers/(Gold for quality, Silver for reach) - Merge into the aggregator's candidate API response with source attribution and per-field credits
import json, os, requests BASE = "https://api-v2.forager.ai/api/{account_id}/datastorage" HEADERS = {"X-API-KEY": os.environ["FORAGER_KEY"]} body = json.load(open("request.json")) # request fields: see the API reference # 1. Resolve each candidate with POST /person_detail_lookup/ r1 = requests.post(f"{BASE}/person_detail_lookup/", headers=HEADERS, json=body) # 2. Fetch personal_email from /person_contacts_lookup/personal_emails/ # 3. Fetch mobiles from POST /person_contacts_lookup/phone_numbers/ (Gold # for quality, Silver for reach) r2 = requests.post(f"{BASE}/person_contacts_lookup/phone_numbers/", headers=HEADERS, json=body) # 4. Merge into the aggregator's candidate API response with source # attribution and per-field credits
# 1. POST /person_detail_lookup/ curl -X POST \ https://api-v2.forager.ai/api/{account_id}/datastorage/person_detail_lookup/ \ -H "X-API-KEY: $FORAGER_KEY" \ -H "Content-Type: application/json" \ -d @request.json # 2. POST /person_contacts_lookup/phone_numbers/ curl -X POST \ https://api-v2.forager.ai/api/{account_id}/datastorage/person_contacts_lookup/phone_numbers/ \ -H "X-API-KEY: $FORAGER_KEY" \ -H "Content-Type: application/json" \ -d @request.json
Run it yourself: Person enrichment API reference
- Free API key
- No credit card
- Run your sample
Inputs and outputs
| Inputs | Outputs |
|---|---|
| candidate profile URL | personal_email |
| name + employer | phone_number |
tier |
Questions about this recipe
Which API provides personal emails and phone numbers for candidates?
This recipe uses Forager Personal emails, Mobile numbers and Person enrichment. Personal emails: Personal email addresses for reaching people outside their work inbox, such as passive candidates and founders. Let a candidate-data aggregator return personal emails and mobiles to the recruiting platforms that call its API, filling records its other sources missed.
What does it cost to supply a candidate-data API with personal emails and mobiles for recruiting platforms?
Personal emails: 5 credits per personal email found, and a personal email lookup that finds nothing costs 0 credits. Mobile numbers: 15 credits per mobile number found, and a mobile number lookup that finds nothing costs 0 credits. Person enrichment: 1 credit per request, charged whether or not data comes back. Growth's 8,250 monthly credits cover 550 mobiles, 1,650 emails or 8,250 person enrichments, or a mix. Self-serve plans are Starter, Growth, Pro and Scale. See plans and prices
What do I need to run this recipe, and what comes back?
You send candidate profile URL and name + employer. You get back personal_email, phone_number and tier, as JSON. You also need a Forager API key, which comes with a free account.
How do recruiting platforms add candidate contact data to their product?
Resolve each candidate with POST /person_detail_lookup/. Fetch personal_email from /person_contacts_lookup/personal_emails/.
Is there a free way to try Forager on this workflow?
Yes. Create a free account at app.forager.ai: it comes with $5 in free credits and an API key, and there is no credit card to sign up. Run it on records you already know, or book a demo and send us a list: we run it and show you what we find.
When should I run this workflow?
When a recruiting-platform customer complains about missing contact fields on candidate records. Recruiting platforms fill more candidate records and launch contact features quickly.
Which Forager products does this recipe use?
Personal emails, mobile numbers and person enrichment. Personal emails: personal email addresses for reaching people outside their work inbox, such as passive candidates and founders. Mobile numbers: direct mobile numbers for a person, from a LinkedIn URL or a Forager person ID, validated before they reach you.
How do you check data quality?
Forager ranked #1 of 10 in Clay's 2026 test of mobile data providers, by quality score: Clay's measure of how likely a dialled number reaches the right person. The test that counts is your own: send a list of profiles you care about. We run it and show you what we find, number by number, so you can measure hit rate and connect rate yourself.
Which tools can run this workflow?
Native in Clay and Zapier, partner-built in Deepline and Cargo and called through the API from Make, n8n and your own code. Or call the endpoints in the steps above from your own code with one API key.
How many steps is this workflow?
4 steps: resolve each candidate with POST /person_detail_lookup/, fetch personal_email from /person_contacts_lookup/personal_emails/, fetch mobiles from POST /person_contacts_lookup/phone_numbers/ (Gold for quality, Silver for reach) and merge into the aggregator's candidate API response with source attribution and per-field credits.
Is there a contract or minimum commitment?
No contract to start: a free account comes with $5 in credits. To keep using Forager, choose a monthly or yearly plan. Monthly plans cancel anytime and unused credits roll over; yearly plans grant all credits upfront and cost 10% less. Larger volumes are agreed with our team.
Can we show Forager data inside our product?
Yes, under platform terms. Self-serve plans cover internal use by your own team. Showing Forager contacts to your users, or passing records on, is licensed separately: talk to sales about volume and which fields your users need to see.
Written answers are not available right now. The matching pages above still help, or book a demo and ask the team.
- $5 free credits
- No credit card
- Run your sample
A selection of teams that run this job on Forager · plus other teams on ForagerA selection of teams using Forager
-
Clay - GTM workflow builders
Selected use case: Forager mobile numbers, emails and people data inside Clay tables.
-
Juicebox
- AI candidate sourcing
Selected use case: Forager data behind its PeopleGPT search and sourcing agents.
-
Nooks - Power & parallel dialers
Selected use case: mobile numbers inside their dialer.
-
Andela
- Customer
Selected use case: Forager data for the go-to-market team at a global talent marketplace.
-
HubSpot
- CRM add-ons
Selected use case: enriching contact and company records with people, company and job-posting data.
-
SeekOut
- Talent intelligence
Selected use case: Forager’s people data feed, used to keep candidate profiles current.
2–3 years on the Forager people data feed, by SeekOut’s own account1
-
Intro
- AI candidate sourcing
Selected use case: phone numbers for outreach to passive candidates.
-
Leelu - AI candidate sourcing
Team behind the Leelu AI recruiting copilot.
Sources
1 SeekOut: SeekOut, customer interview, Sep 2026.
More recipes for data marketplaces
-
Sell niche custom B2B datasets by audience
-
Add a mobile-number slot to a multi-provider enrichment waterfall
-
Detect CRM contacts who changed jobs and alert on moved champions
-
Back a sales-intelligence database with an additional mobile source
-
Build natural-language candidate search on a licensed people feed
-
Offer mobile and email enrichment as native actions in a GTM workflow builder