Pre-fill applicant profiles from the email on an application
When a candidate applies with a personal email, fill their profile in the ATS with work history, education and skills so recruiters review a complete record.
- Free API key
- No credit card
- Run your sample
Uses POST /person_detail_reverse_lookup/by_email/, POST /person_detail_lookup/ · Reverse email lookup API reference
What it costs: Charged per request: credit pricing.
- Reverse email lookup
- Person enrichment
- API
- Embedded in a platform
- HR tech
How the data flows
POST /person_detail_reverse_lookup/by_email/ - roles
- Product Designer
- skills
- Python, SQL
- linkedin url
- /in/lee-sampler
- name
- Lee Sampler
- mobile
- +1 (312) 555-0107
- work email
- lee@samplelabs.example
Steps
- Resolve the applicant email with
POST /person_detail_reverse_lookup/by_email/ - Map roles, educations, skills and certifications onto the candidate profile fields
- Store
linkedin_info.public_identifierso later refreshes can usePOST /person_detail_lookup/ - Mark pre-filled fields as suggested until the candidate or recruiter confirms them
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 the applicant email with POST # /person_detail_reverse_lookup/by_email/ r1 = requests.post(f"{BASE}/person_detail_reverse_lookup/by_email/", headers=HEADERS, json=body) # 2. Map roles, educations, skills and certifications onto the candidate # profile fields # 3. Store linkedin_info.public_identifier so later refreshes can use POST # /person_detail_lookup/ r2 = requests.post(f"{BASE}/person_detail_lookup/", headers=HEADERS, json=body) # 4. Mark pre-filled fields as suggested until the candidate or recruiter # confirms them
# 1. POST /person_detail_reverse_lookup/by_email/ curl -X POST \ https://api-v2.forager.ai/api/{account_id}/datastorage/person_detail_reverse_lookup/by_email/ \ -H "X-API-KEY: $FORAGER_KEY" \ -H "Content-Type: application/json" \ -d @request.json # 2. 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: Reverse email lookup API reference
- Free API key
- No credit card
- Run your sample
Inputs and outputs
| Inputs | Outputs |
|---|---|
| applicant personal email | roles |
educations | |
skills | |
certifications | |
LinkedIn URL |
Questions about this recipe
How can an ATS fill in an applicant's work history from their email?
Resolve the applicant email with POST /person_detail_reverse_lookup/by_email/. Map roles, educations, skills and certifications onto the candidate profile fields.
What does it cost to pre-fill applicant profiles from the email on an application?
Reverse email lookup: 5 credits per request, charged whether or not data comes back. Person enrichment: 1 credit per request, charged whether or not data comes back. Growth's 8,250 monthly credits cover 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 applicant personal email. You get back certifications, educations, LinkedIn URL and roles, as JSON. You also need a Forager API key, which comes with a free account.
Which API returns a candidate profile from a personal email?
This recipe uses Forager Reverse email lookup and Person enrichment. Reverse email lookup: Turn an email address into a full person profile: name, title, company, location and social links. When a candidate applies with a personal email, fill their profile in the ATS with work history, education and skills so recruiters review a complete record.
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 new application arrives with a personal email address and a thin or unparsed resume. Recruiters screen from a full profile, and candidates retype less of their history.
Which Forager products does this recipe use?
Reverse email lookup and person enrichment. Reverse email lookup: turn an email address into a full person profile: name, title, company, location and social links. Person enrichment: a full professional profile for a person from a LinkedIn URL, email or phone: experience, education, skills and contact channels.
How accurate is Forager data?
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.
How do I enrich job applicants with work history?
Resolve the applicant email with POST /person_detail_reverse_lookup/by_email/. Map roles, educations, skills and certifications onto the candidate profile fields.
Which tools can run this workflow?
Native in Clay, 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 the applicant email with POST /person_detail_reverse_lookup/by_email/, map roles, educations, skills and certifications onto the candidate profile fields, store linkedin_info.public_identifier so later refreshes can use POST /person_detail_lookup/ and mark pre-filled fields as suggested until the candidate or recruiter confirms them.
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.
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
More recipes for applicant tracking
-
Refresh stale ATS candidate records so past applicants resurface
-
Rebuild a corporate alumni list for boomerang hiring
-
Suggest referral candidates from employees' former colleagues
-
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