Forager API: people and company data

Forager connects your app to phone numbers, emails, people search and data feeds

Get an API key

Free account at app.forager.ai.

Quickstart

Your first phone number lookup in about 5 minutes.

Set up with a coding agent

Paste one prompt into your agent.

Try a request

Pick a job. Set FORAGER_API_KEY and FORAGER_ACCOUNT_ID from your account, then run the request.

Find a phone number
Enrich from an email
Search people by role
Bulk data feed

Look up phone numbers from a LinkedIn public identifier, or from a Forager person ID. Reference · Guide

curl -X POST "https://api-v2.forager.ai/api/$FORAGER_ACCOUNT_ID/datastorage/person_contacts_lookup/phone_numbers/" \
  -H "X-API-KEY: $FORAGER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"linkedin_public_identifier": "billgates"}'

import os, requests

resp = requests.post(
    f"https://api-v2.forager.ai/api/{os.environ['FORAGER_ACCOUNT_ID']}/datastorage/person_contacts_lookup/phone_numbers/",
    headers={"X-API-KEY": os.environ["FORAGER_API_KEY"]},
    json={"linkedin_public_identifier": "billgates"},
)
print(resp.json())

const resp = await fetch(
  `https://api-v2.forager.ai/api/${process.env.FORAGER_ACCOUNT_ID}/datastorage/person_contacts_lookup/phone_numbers/`,
  {
    method: "POST",
    headers: { "X-API-KEY": process.env.FORAGER_API_KEY, "Content-Type": "application/json" },
    body: JSON.stringify({ linkedin_public_identifier: "billgates" }),
  },
);
console.log(await resp.json());

Example response (illustrative values)

[
  { "phone_number": "+12025550142" },
  { "phone_number": "+12025550187" }
]

Find the person behind a personal email address: profile, roles, education and the LinkedIn profile URL. Reference · Guide

curl -X POST "https://api-v2.forager.ai/api/$FORAGER_ACCOUNT_ID/datastorage/person_detail_reverse_lookup/by_email/" \
  -H "X-API-KEY: $FORAGER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "jane.doe@gmail.com"}'

import os, requests

resp = requests.post(
    f"https://api-v2.forager.ai/api/{os.environ['FORAGER_ACCOUNT_ID']}/datastorage/person_detail_reverse_lookup/by_email/",
    headers={"X-API-KEY": os.environ["FORAGER_API_KEY"]},
    json={"email": "jane.doe@gmail.com"},
)
print(resp.json())

const resp = await fetch(
  `https://api-v2.forager.ai/api/${process.env.FORAGER_ACCOUNT_ID}/datastorage/person_detail_reverse_lookup/by_email/`,
  {
    method: "POST",
    headers: { "X-API-KEY": process.env.FORAGER_API_KEY, "Content-Type": "application/json" },
    body: JSON.stringify({ email: "jane.doe@gmail.com" }),
  },
);
console.log(await resp.json());

Example response (illustrative values, trimmed)

{
  "id": 1234567,
  "full_name": "Jane Doe",
  "headline": "VP of Sales at Example Corp",
  "linkedin_info": {
    "public_identifier": "jane-doe",
    "public_profile_url": "https://www.linkedin.com/in/jane-doe"
  },
  "roles": [
    {
      "id": 55501,
      "role_title": "VP of Sales",
      "is_current": true,
      "organization": { "id": 4321, "name": "Example Corp" }
    }
  ]
}

Find people by current job title, then pass each result’s person.id to the contact lookups as person_id. The top-level id of a result is the role, not the person. Reference · Guide

curl -X POST "https://api-v2.forager.ai/api/$FORAGER_ACCOUNT_ID/datastorage/person_role_search/" \
  -H "X-API-KEY: $FORAGER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"role_title": "Software Engineer", "role_is_current": true}'

import os, requests

resp = 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={"role_title": "Software Engineer", "role_is_current": True},
)
print(resp.json()["total_search_results"])

const resp = await fetch(
  `https://api-v2.forager.ai/api/${process.env.FORAGER_ACCOUNT_ID}/datastorage/person_role_search/`,
  {
    method: "POST",
    headers: { "X-API-KEY": process.env.FORAGER_API_KEY, "Content-Type": "application/json" },
    body: JSON.stringify({ role_title: "Software Engineer", role_is_current: true }),
  },
);
console.log((await resp.json()).total_search_results);

Example response (illustrative values, trimmed)

{
  "total_search_results": 2,
  "search_results": [
    {
      "id": 55501,
      "role_title": "Software Engineer",
      "is_current": true,
      "person": { "id": 9876543, "full_name": "Jane Doe" }
    },
    {
      "id": 55502,
      "role_title": "Senior Software Engineer",
      "is_current": true,
      "person": { "id": 9876544, "full_name": "John Roe" }
    }
  ]
}

License people, company and job post data as files delivered to your Amazon S3 bucket, Google Cloud Storage or Snowflake. Overview · Schema

File path layout

/forager_data_feed/<data_feed_id>/<date_created>/<data_feed_type>_<schema_version>/data_<partition_id>.<file_type>.<compression_type>

# Example
/forager_data_feed/123/2025-10-15/person_2.0.4/data_0_0_1.json.gzip

Files come as CSV, JSON or Parquet, always UTF-8. See output file details and the sample files there.

Choose your path

REST API

Call Forager from your product or scripts, with a playground for every endpoint.

No-code

Use Forager inside Zapier or Clay without writing code.

Data feeds

Bulk people, company and job post files in S3, Google Cloud Storage or Snowflake.

Recipes

Step-by-step builds for common jobs. Each starts with a prompt you can paste into a coding agent.

Add a phone number before a call

For dialers and sales engagement platforms.

Enrich a CRM contact from an email

Turn an email into a person, then add contact details.

Get a candidate's email and phone number

For recruiting and sourcing platforms.

Join the people and company feeds

For data and product teams on Snowflake.

All recipes →

Build with AI agents

Set up Forager with a coding agent. Paste this into Claude Code, Codex, Cursor or another coding agent:

Setup prompt

Read https://www.forager.ai/docs/guides/agent-quickstart.md and follow it to add the Forager API to this project. Keep my API key server-side in FORAGER_API_KEY and FORAGER_ACCOUNT_ID.

Agents can also read these docs directly: llms.txt, llms-full.txt, Markdown for any page (add .md to the URL) and the Forager API skill. See Build with AI agents.

Reference and help

API reference

Every endpoint, with an interactive playground.

Credits and pricing

What each request costs.

What's new

API and docs updates, also as an RSS feed.

Get started

Contact data

People and companies

Account and billing

Production

Help

Coming soon

Forager API: people and company data

Get an API key

Quickstart

Set up with a coding agent

Try a request

Choose your path

REST API

No-code

Data feeds

Recipes

Add a phone number before a call

Enrich a CRM contact from an email

Get a candidate's email and phone number

Join the people and company feeds

Build with AI agents

Reference and help

API reference

Credits and pricing

What's new

Get an API key

Quickstart

Set up with a coding agent

​Try a request

​Choose your path

REST API

No-code

Data feeds

​Recipes

Add a phone number before a call

Enrich a CRM contact from an email

Get a candidate's email and phone number

Join the people and company feeds

​Build with AI agents

​Reference and help

API reference

Credits and pricing

What's new

Try a request

Choose your path

Recipes

Build with AI agents

Reference and help