Fill missing emails and mobiles in user-uploaded CSVs
Offer a bulk 'upload a list, get it back complete' feature to a data product's users.
- Free API key
- No credit card
- Run your sample
A selection of teams that run this job on Forager · plus other teams on Forager
- Tools named
LinkedIn
Uses POST /person_detail_lookup/ · 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.
- Person enrichment
- Work emails
- Personal emails
- Mobile numbers
- API
- Data reseller
- B2B data providers
How the data flows
POST /person_detail_lookup/ - work email
- lee@example.com
- personal email
- lee.s@example.net
- phone number
- +1 (312) 555-0107
- fill status
- open
- name
- Lee Sampler
- title
- VP Revenue Operations
Steps
- Normalise columns and resolve each row with
POST /person_detail_lookup/or/person_role_search/(person_name+organization_domains) - Fill
work_email,personal_emailand mobile viaperson_contacts_lookupendpoints - Return the CSV with fill status per field and credits used
- Bill only filled fields
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. Normalise columns and resolve each row with POST /person_detail_lookup/ # or /person_role_search/ (person_name + organization_domains) r1 = requests.post(f"{BASE}/person_detail_lookup/", headers=HEADERS, json=body) # 2. Fill work_email, personal_email and mobile via person_contacts_lookup # endpoints # 3. Return the CSV with fill status per field and credits used # 4. Bill only filled fields
# 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
Run it yourself: Person enrichment API reference
- Free API key
- No credit card
- Run your sample
Inputs and outputs
| Inputs | Outputs |
|---|---|
| CSV (name, company, LinkedIn URL, email) | work_email |
personal_email | |
phone_number | |
fill status |
Questions about this recipe
How can I fill in missing emails and phone numbers for a spreadsheet of contacts?
Fill work_email, personal_email and mobile via person_contacts_lookup endpoints. Return the CSV with fill status per field and credits used.
What does it cost to fill missing emails and mobiles in user-uploaded CSVs?
Person enrichment: 1 credit per request, charged whether or not data comes back. Work emails: 5 credits per work email found, and a work email lookup that finds nothing costs 0 credits. 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. 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 CSV (name, company, LinkedIn URL, email). You get back fill status, personal_email, phone_number and work_email, as JSON. You also need a Forager API key, which comes with a free account.
Which tools bulk-enrich a CSV with emails and mobile numbers and only charge for found results?
This recipe uses Forager Person enrichment, Work emails, Personal emails and Mobile numbers. Person enrichment: A full professional profile for a person from a LinkedIn URL, email or phone: experience, education, skills and contact channels. Offer a bulk 'upload a list, get it back complete' feature to a data product's users.
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 user uploads a CSV of names, companies or LinkedIn URLs with gaps. Users get complete, CRM-ready lists without manual research.
Which Forager products does this recipe use?
Person enrichment, work emails, personal emails and mobile numbers. Person enrichment: a full professional profile for a person from a LinkedIn URL, email or phone: experience, education, skills and contact channels. Work emails: verified work email addresses for a person at their current employer.
How do I know the data is right?
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: normalise columns and resolve each row with POST /person_detail_lookup/ or /person_role_search/ (person_name + organization_domains), fill work_email, personal_email and mobile via person_contacts_lookup endpoints, return the CSV with fill status per field and credits used and bill only filled fields.
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.
-
Airscale - Waterfall enrichment
Selected use case: a Forager step in its mobile number waterfall.
-
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
-
Orbital - Lead databases
Selected use case: contact lookups in its enrichment waterfall, for teams selling to local businesses.
Sources
1 SeekOut: SeekOut, customer interview, Sep 2026.
More recipes for contact-data vendors
-
Back a sales-intelligence database with an additional mobile source
-
Launch a pay-per-valid-result phone finder on wholesale mobile data
-
Launch a regional B2B contact database on licensed people and jobs feeds
-
Bundle job-posting buying signals into a B2B data product
-
Resell person and reverse-email enrichment through a developer data API
-
Add an additional email source to an email finder's lookup chain