$5 free Limited time. Sign up to activate. Get your $5 →
Glossary · Data types

What is people data API?

A people data API is an HTTP interface that returns professional profiles on request: look up one person by LinkedIn URL, email or phone, or search people by title, company, seniority and location. Products call it to embed person data.

Also called: person data API · person enrichment API · people search API

People data API in practice

The API has two verbs. Lookup takes a key and returns one profile: name, title, employer, work history, education, skills, location. Search takes filters and returns a list of matching people, usually with totals so you can size a market before paying for the rows.

Contact channels are separate calls on the same person, because they are priced and verified differently from profile fields. A typical flow is search, then lookup for detail, then a mobile or email lookup for the people you want to reach.

How a people data API call works

  1. AuthenticateSend your API key in a header. Keys are created in the web app.
  2. Search or look upSearch by filters (title, company, location), or look up one person by LinkedIn identifier, email or phone.
  3. Read the profileRoles newest first, education, skills, location, and the identifiers to use in the next call.
  4. Add contact channelsPass the person identifier to the mobile, work email or personal email lookup.
people data API: diagram Search finds the people; lookup returns one profile; contact lookups hang off the person identifier. Search filters LinkedIn URL Email or phone Profile Roles, education Person ID Contact lookups People API
Search finds the people; lookup returns one profile; contact lookups hang off the person identifier.

Core endpoints of Forager's people API

FieldDefinitionExampleForager fieldWhere
People searchFind people by role filterstitle = "VP Sales", country = USperson_role_searchAPI (1 credit per request)
Person lookupOne full profile by identifierlinkedin.com/in/exampleperson_detail_lookupAPI (1 credit per request)
Reverse email lookupProfile from an emailname@employer.exampleperson_detail_reverse_lookup/by_emailAPI (5 credits per request)
TotalsCount of matches before paying for rows4,120 peopleperson_role_search/totalsAPI

Example values are illustrative, not records.

People data API vs people data feed

APIFeed
ShapeOne request, one answerWhole dataset as files
BillingCredits per request or per resultLicence, priced per record set
Best forLookups inside a product, at the moment of needSearch, models and matching in your own warehouse
FreshnessCurrent record at call timeAs of each delivery

Limits and when not to use it

  • Search filters match the provider's taxonomy. Use the autocomplete endpoints to find valid IDs for industries, locations and skills before filtering.
  • An API suits one-at-a-time and batch use inside a product. Building a search index over a whole market needs a feed.
  • Rate limits apply. Production code should retry on 429 with backoff and cache what it already fetched.
With Forager

How people data API works with Forager

Forager's people API covers 800M+ people: people search (1 credit per request), person lookup from a LinkedIn URL, email or phone (1 credit per request), reverse email lookup (5 credits per request) and contact lookups on top, charged per result found.

  • $5 free credits
  • No credit card
  • Run your sample

Questions about people data API

What is a people data API?

An HTTP interface that returns professional profiles: look up one person by LinkedIn URL, email or phone, or search people by title, company, seniority and location. Products call it to embed person data.

What is the difference between people search and person lookup?

Search takes filters and returns a list of matching people with totals. Lookup takes one identifier and returns that person's full profile. Most flows search first, then look up the people they want.

What fields does a person profile contain?

Name, current title and employer, past roles newest first, education, skills, location and the identifiers used for contact lookups. Contact channels are separate calls.

How is Forager's people API priced?

Credits per request: 1 credit per people search, 1 credit per person lookup, 5 credits per reverse email lookup. Mobiles and emails are charged per result found.

How do I get an API key?

Create a Forager account, create an API key in the web app and start with $5 in credits. The quickstart in the docs makes a first request in a few minutes.

Keep reading

Start building

Test it on your own records

Create an account, start with $5 in credits and measure hit rate and connect rate on a sample you choose.

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