Rebuild a corporate alumni list for boomerang hiring
Help an ATS or alumni platform find a company's former employees, see where they work now, and invite them back when a fitting role opens.
- Free API key
- No credit card
- Run your sample
Uses POST /person_role_search/, POST /person_detail_lookup/, POST /person_contacts_lookup/personal_emails/ · People search 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.
- People search
- Person enrichment
- Personal emails
- API
- Embedded in a platform
- HR tech
How the data flows
POST /person_role_search/ - former employees
- 120
- personal email
- kim.e@example.net
- name
- Kim Exemplar
- title
- Product Designer
- mobile
- +1 (416) 555-0186
- work email
- kim@samplelabs.example
Steps
- Find former employees with
POST /person_role_search/(organizations,role_is_current: false) - Fetch current roles with
POST /person_detail_lookup/to see where each person is now - Fetch personal emails via
POST /person_contacts_lookup/personal_emails/, since the old work address no longer reaches them - Invite alumni to the network and match them to open roles
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. Find former employees with POST /person_role_search/ (organizations, # role_is_current: false) r1 = requests.post(f"{BASE}/person_role_search/", headers=HEADERS, json=body) # 2. Fetch current roles with POST /person_detail_lookup/ to see where each # person is now r2 = requests.post(f"{BASE}/person_detail_lookup/", headers=HEADERS, json=body) # 3. Fetch personal emails via POST # /person_contacts_lookup/personal_emails/, since the old work address no # longer reaches them r3 = requests.post(f"{BASE}/person_contacts_lookup/personal_emails/", headers=HEADERS, json=body) # 4. Invite alumni to the network and match them to open roles
# 1. 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 # 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 # 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: People search API reference
- Free API key
- No credit card
- Run your sample
Inputs and outputs
| Inputs | Outputs |
|---|---|
| company organization id | former employees |
| open roles | current employer and title |
personal email |
Questions about this recipe
How can a company find and contact its former employees?
Find former employees with POST /person_role_search/ (organizations, role_is_current: false). Fetch personal emails via POST /person_contacts_lookup/personal_emails/, since the old work address no longer reaches them.
What does it cost to rebuild a corporate alumni list for boomerang hiring?
People search: people search 1 credit per request and people search: role details 1 credit per request, charged whether or not data comes back. Person enrichment: 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 search requests, 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 company organization id and open roles. You get back current employer and title, former employees and personal email, as JSON. You also need a Forager API key, which comes with a free account.
Which data helps rehire boomerang employees?
You send company organization id and open roles. You get back former employees, current employer and title and personal email. Companies rehire people who already know the business, and alumni hear about roles directly.
Can I test people search for free?
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 company launches an alumni program, or a role opens that past employees could fill. Companies rehire people who already know the business, and alumni hear about roles directly.
Which Forager products does this recipe use?
People search, person enrichment and personal emails. People search: find the people who hold a role at target companies, filtered by title, seniority, department and location. Person enrichment: a full professional profile for a person from a LinkedIn URL, email or phone: experience, education, skills and contact channels.
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 employees of a company?
Find former employees with POST /person_role_search/ (organizations, role_is_current: false). Fetch current roles with POST /person_detail_lookup/ to see where each person is now.
Which tools can run this workflow?
Native in Clay and Zapier, partner-built in Deepline and Cargo and called through the API from your own code, Make and n8n. Or call the endpoints in the steps above from your own code with one API key.
How many steps is this workflow?
4 steps: find former employees with POST /person_role_search/ (organizations, role_is_current: false), fetch current roles with POST /person_detail_lookup/ to see where each person is now, fetch personal emails via POST /person_contacts_lookup/personal_emails/, since the old work address no longer reaches them and invite alumni to the network and match them to open roles.
Do I need a subscription?
Not to test: 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
-
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
