Suggest referral candidates from employees' former colleagues
In an ATS or referral tool, show each employee the people they worked with before who now fit an open role, and let the employee make the introduction.
- Free API key
- No credit card
- Run your sample
Uses POST /person_detail_lookup/, POST /person_role_search/, POST /person_contacts_lookup/personal_emails/ · Person enrichment API reference
What it costs: 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
- People search
- Personal emails
- API
- Embedded in a platform
- HR tech
How the data flows
POST /person_detail_lookup/ - personal email
- jane.e@example.net
- name
- Jane Example
- title
- Product Designer
- mobile
- +1 (415) 555-0142
- work email
- jane@samplelabs.example
- company
- Sample Labs
Steps
- Fetch the employee's history with
POST /person_detail_lookup/(linkedin_public_identifier) - Find people who held roles at the same organizations in overlapping years with
POST /person_role_search/(organizations,role_position_start_date,role_position_end_date) - Keep those whose current
role_titlefits the open requisition - After the employee agrees to refer, fetch a personal email via
POST /person_contacts_lookup/personal_emails/for the outreach
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. Fetch the employee's history with POST /person_detail_lookup/ # (linkedin_public_identifier) r1 = requests.post(f"{BASE}/person_detail_lookup/", headers=HEADERS, json=body) # 2. Find people who held roles at the same organizations in overlapping # years with POST /person_role_search/ (organizations, # role_position_start_date, role_position_end_date) r2 = requests.post(f"{BASE}/person_role_search/", headers=HEADERS, json=body) # 3. Keep those whose current role_title fits the open requisition # 4. After the employee agrees to refer, fetch a personal email via POST # /person_contacts_lookup/personal_emails/ for the outreach r3 = requests.post(f"{BASE}/person_contacts_lookup/personal_emails/", headers=HEADERS, json=body)
# 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_role_search/ curl -X POST \ https://api-v2.forager.ai/api/{account_id}/datastorage/person_role_search/ \ -H "X-API-KEY: $FORAGER_KEY" \ -H "Content-Type: application/json" \ -d @request.json # 3. POST /person_contacts_lookup/personal_emails/ curl -X POST \ https://api-v2.forager.ai/api/{account_id}/datastorage/person_contacts_lookup/personal_emails/ \ -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 |
|---|---|
| employee LinkedIn URL | former colleagues who fit the role |
| open requisition title | shared employer and years |
personal email |
Questions about this recipe
How can a referral tool suggest people an employee worked with?
Fetch the employee's history with POST /person_detail_lookup/ (linkedin_public_identifier). Find people who held roles at the same organizations in overlapping years with POST /person_role_search/ (organizations, role_position_start_date, role_position_end_date).
What does it cost to suggest referral candidates from employees' former colleagues?
Person enrichment: 1 credit per request, charged whether or not data comes back. People search: people search 1 credit per request and people search: role details 1 credit per request, charged whether or not data comes back. Personal emails: 5 credits per personal email found, and a personal email lookup that finds nothing costs 0 credits. Growth's 8,250 monthly credits cover 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 employee LinkedIn URL and open requisition title. You get back former colleagues who fit the role, personal email and shared employer and years, as JSON. You also need a Forager API key, which comes with a free account.
Which API finds people who worked at the same company at the same time?
This recipe uses Forager Person enrichment, People search and Personal emails. Person enrichment: A full professional profile for a person from a LinkedIn URL, email or phone: experience, education, skills and contact channels. In an ATS or referral tool, show each employee the people they worked with before who now fit an open role, and let the employee make the introduction.
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 requisition opens, or an employee opens the referral page. Employees refer people they actually know for roles that fit, and recruiters get warmer candidates.
Which Forager products does this recipe use?
Person enrichment, people search and personal emails. Person enrichment: a full professional profile for a person from a LinkedIn URL, email or phone: experience, education, skills and contact channels. People search: find the people who hold a role at target companies, filtered by title, seniority, department and location.
How do you check data quality?
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 find former colleagues for referrals?
Fetch the employee's history with POST /person_detail_lookup/ (linkedin_public_identifier). Find people who held roles at the same organizations in overlapping years with POST /person_role_search/ (organizations, role_position_start_date, role_position_end_date).
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: fetch the employee's history with POST /person_detail_lookup/ (linkedin_public_identifier), find people who held roles at the same organizations in overlapping years with POST /person_role_search/ (organizations, role_position_start_date, role_position_end_date), keep those whose current role_title fits the open requisition and after the employee agrees to refer, fetch a personal email via POST /person_contacts_lookup/personal_emails/ for the outreach.
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
-
Pre-fill applicant profiles from the email on an application
-
Rebuild a corporate alumni list for boomerang hiring
-
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
