How to find the employees of a company
Search people by the company's domain and a role title, with current roles only. Searching a professional network by hand works for one company; a person role search returns each match with name, current role, company and profile, and a totals call says how many there are before you page.
Decide who you mean
"The employees of a company" is three different lists. All of them, which is a headcount question. A role group, which is a prospecting or sourcing question. The decision makers, which is a seniority question. The search below takes the same shape for all three; what changes is the role title query.
Write the title as a boolean query: "VP Sales" OR "Head of Sales" OR "Sales Director". Seniority words (VP, Head, Director, Chief) do the decision-maker filtering; function words (Sales, Revenue, Growth) do the team filtering. Leave the title out for everyone.
The manual route
Open the company page, click the employee count, and filter the people search by title and location. Sales Navigator adds seniority and function filters and saved searches. This is the route page 1 describes on a professional network (octopuscrm, Oct 21, 2024), and it works for one company by hand.
What it does not do: give you a list you can export and refresh, count before you scroll, or hand the people to a contact lookup. For one company it is fine; for an account list it is a job for the API.
Count first
The person role search totals endpoint takes the same body as the search and returns total_search_results, total_persons and total_organizations. Call it before you page, so a query that matches 3,000 people gets narrowed before it costs 3,000 rows of review.
Role search totals
curl -X POST https://api-v2.forager.ai/api/{account_id}/datastorage/person_role_search/totals/ \ -H "X-API-KEY: $FORAGER_API_KEY" \ -H "Content-Type: application/json" \ -d '{"organization_domains":["example.com"],"role_title":"\"VP\" OR \"Head of\" OR \"Director\"","role_is_current":true}'
import os, requests r = requests.post( f"https://api-v2.forager.ai/api/{os.environ['FORAGER_ACCOUNT_ID']}/datastorage/person_role_search/totals/", headers={"X-API-KEY": os.environ["FORAGER_API_KEY"]}, json={"organization_domains": ["example.com"], "role_title": "\"VP\" OR \"Head of\" OR \"Director\"", "role_is_current": True}, timeout=30, ) r.raise_for_status() data = r.json() if r.content else [] # an empty body means nothing was found
// illustrative values, not a record
{ "total_search_results": 42, "total_persons": 42, "total_organizations": 1 } The totals call costs 1 credit per request.
Then list
Person role search
curl -X POST https://api-v2.forager.ai/api/{account_id}/datastorage/person_role_search/ \ -H "X-API-KEY: $FORAGER_API_KEY" \ -H "Content-Type: application/json" \ -d '{"organization_domains":["example.com"],"role_title":"\"VP\" OR \"Head of\" OR \"Director\"","role_is_current":true,"page":1}'
import os, requests r = requests.post( f"https://api-v2.forager.ai/api/{os.environ['FORAGER_ACCOUNT_ID']}/datastorage/person_role_search/", headers={"X-API-KEY": os.environ["FORAGER_API_KEY"]}, json={"organization_domains": ["example.com"], "role_title": "\"VP\" OR \"Head of\" OR \"Director\"", "role_is_current": True, "page": 1}, timeout=30, ) r.raise_for_status() data = r.json() if r.content else [] # an empty body means nothing was found
// illustrative values, not a record
{ "search_results": [{ "person": { "id": 123, "full_name": "Jane Doe", "linkedin_info": { "public_identifier": "jane-doe-example" } }, "role_title": "VP Sales", "organization": { "name": "Example Corp", "domain": "example.com" } }], "total_search_results": 42 } Each hit has person (id, full_name and linkedin_info), role_title and organization (name and domain). Page through with page until you have total_search_results rows. A search costs 1 credit per request.
Narrow it
- person_locations: the person's location, as autocomplete ids.
- organization_employees_start and organization_employees_end: company size band, useful when the domain filter is replaced by an industry.
- organization_industries: industry ids from the industries autocomplete.
- role_position_start_date: people who started recently, which is its own signal.
Filters that take ids come from the autocomplete endpoints, which are free and limited to 10 requests a second. Cache the ids.
Review, then spend
The search returns people; it does not return contact details, and that is the point. Review the list, keep the people you will actually contact, and run the contact lookups only for those, by person_id: 5 credits per work email found, 15 credits per mobile found, and 0 credits when a lookup finds nothing.
Former employees
Flip role_is_current to false and the same search returns people who used to work at the company, with a window on when they left. That is its own guide below, because the results shape and the jobs it serves are different.
Inside a product
- Server-side key; the browser never calls Forager directly.
- Resolve and cache autocomplete ids once per filter value.
- Store person ids with the search that found them, so a re-run dedupes against what you already hold.
- Put the review step between the search and the contact lookups, in the UI or as a rule.
The data behind every match is drawn from 800M+ people and 65M+ companies.
The pieces this guide uses
Recipes
- $5 free credits
- No credit card
- Run your sample
Questions about this guide
How do I find a list of employees at a company?
Run a person role search filtered by organization_domains with role_is_current true, and page through the results. Each hit carries the person, their current role title and the organization. Count first with the totals call so you know the size of the list.
Can I find only the decision makers?
Yes. Put seniority words in the role title query: "VP" OR "Head of" OR "Director" OR "Chief". Add function words to narrow to a team, for example Sales or Engineering.
Is a list of employees personal data?
Yes. Names, roles and profile links are personal data, even when the company is public. Keep a narrow purpose, store only what you use, and honor opt-outs. Bring your legal questions to a call with our team.
How current is the "current role"?
The search runs against the current record at request time, and role_is_current reflects what the record holds then. For a job-change watch, re-run the search on a schedule and compare ids.
How many people can I pull from one company?
As many as the totals call reports; page through with page. Each search request costs 1 credit, so the cost scales with pages, not with people. Contact lookups are separate and charged only when found.
What does it cost to find the employees of a company?
A totals call costs 1 credit and each search page 1 credit, charged per request. Contact details are extra and charged only when found: 5 credits per work email, 15 credits per mobile.
What does people search cost for teams following this guide?
People search: people search 1 credit per request and people search: role details 1 credit per request, charged whether or not data comes back. 1,000 search requests use 1,000 credits: about $13 of Starter credits month to month, or about $10 on Pro with yearly billing. Self-serve plans are Starter, Growth, Pro and Scale. See plans and prices
Am I charged when nothing is found?
Yes. People search is charged per request, whether or not data comes back. Only mobile and email lookups are free when nothing is found, so try your inputs on a small run before you scale.
Can teams following this guide 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.
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.
How is the data sourced, and what about privacy?
Bring your legal and security questions to a call with our team, and we take you through how Forager data is sourced and the terms that cover people search for teams following this guide. Forager's privacy policy is public, and anyone can send a request about their own personal data through the consumer rights form on forager.ai.
Do I need a subscription?
Not to test: a free account comes with $5 in credits. To keep using people search, 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
Keep reading
Glossary
Tools
Best-of guides
Related guides
Sources
- Forager docs: People search by job title and company (read Nov 1, 2026)
- Forager docs: Build a prospect list by role and company (read Nov 1, 2026)
- Forager docs: API credits and pricing (read Nov 1, 2026)
- octopuscrm.io: How to Find Employees of a Company on LinkedIn (Oct 21, 2024) (read Nov 1, 2026)