$5 free Limited time. Sign up to activate. Get your $5 →
How-to · People

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.

How to find the employees of a companyPerson role search filtered by the company's domain, a role _ht_title query and current roles only. Count first with the totals call, review the list, then spend on contact lookups only for the people you keep.Everyone at a company, by roleCount first, list second, contact details lastexample.com"VP" OR "Head"current only1Totals: how many?2Role search: who?size the query before pagingpage through the matchesEACH MATCHpersonJane DoeroleVP Sales · currentcompanyExample Corpprofilelinkedin.com/in/jane-doe3Review: keep the people you needWork emailsMobile numbersonly for the kept rows: that is where credits goSample values are fictional.
Credits go on the kept rows only. The search finds people; the contact lookups are the spend.

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}'
Sample values are fictionalFields: API reference

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}'
Sample values are fictionalFields: API reference

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.

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.

Start building

Run it on your own records

Create a free account, start with $5 in credits and try the lookups in this guide on people and companies you already know.

  • $5 free credits
  • No credit card
  • Run your sample
Platforms and teams that build on Forager
  • Clay
  • Juicebox
  • Nooks
  • Andela
  • HubSpot
  • SeekOut