> ## Documentation Index
> Fetch the complete documentation index at: https://www.forager.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Forager is a REST API for B2B people, company and job post data: contact lookups (phone numbers, personal emails, work emails), person, company and job post search, and bulk data feeds.
> Server: https://api-v2.forager.ai. Send the API key in the X-API-KEY header. Most paths include {account_id}. Read FORAGER_API_KEY and FORAGER_ACCOUNT_ID from the environment; never put the key in client-side code, logs or prompts.
> To add Forager to a project, follow https://www.forager.ai/docs/guides/agent-quickstart.md. To pick an endpoint, read https://www.forager.ai/docs/guides/choose-an-endpoint.md. For end-to-end builds, see https://www.forager.ai/docs/recipes/overview.md.
> Most requests spend credits. Do not guess costs; use https://www.forager.ai/docs/api-overview/credit-pricing.md and ask the user before spending credits.
> Use only endpoints and fields defined in https://www.forager.ai/docs/openapi.yaml. Forager has no MCP server for the API yet; the /mcp endpoint on this site searches the documentation only.

# Forager API: people and company data

> Forager API docs: search people and companies, find work emails, personal emails and phone numbers, enrich records, and license bulk B2B data feeds.

![Forager connects your app to phone numbers, emails, people search and data feeds](https://mintcdn.com/forager/OnhSHNo_LBQ7yKjR/images/illustrations/forager-api-people-company-data-overview.svg?fit=max\&auto=format\&n=OnhSHNo_LBQ7yKjR\&q=85\&s=5437fc8c80eb4ae068581867bf97833c)

> [card] [Get an API key](https://www.forager.ai/docs/api-overview/create-an-account.md)
>
> Free account at app.forager.ai.

> [card] [Quickstart](https://www.forager.ai/docs/api-overview/send-your-first-request.md)
>
> Your first phone number lookup in about 5 minutes.

> [card] [Set up with a coding agent](https://www.forager.ai/docs/guides/agent-quickstart.md)
>
> Paste one prompt into your agent.

## Try a request

Pick a job. Set `FORAGER_API_KEY` and `FORAGER_ACCOUNT_ID` from your [account](https://www.forager.ai/docs/api-overview/create-an-account.md), then run the request.

> [tab] Find a phone number
>
> Look up phone numbers from a LinkedIn public identifier, or from a Forager person ID. [Reference](https://www.forager.ai/docs/openapi/phones/datastorage_person_contacts_lookup_phone_numbers_create.md) · [Guide](https://www.forager.ai/docs/guides/find-phone-numbers.md)
>
> ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
> 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"}'
> ```
>
> ```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
> 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())
> ```
>
> ```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
> 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());
> ```
>
> ```json Example response (illustrative values) theme={"theme":{"light":"github-light","dark":"github-dark"}}
> [
>   { "phone_number": "+12025550142" },
>   { "phone_number": "+12025550187" }
> ]
> ```

> [tab] Enrich from an email
>
> Find the person behind a personal email address: profile, roles, education and the LinkedIn profile URL. [Reference](https://www.forager.ai/docs/openapi/people/datastorage_person_detail_reverse_lookup_by_email_create.md) · [Guide](https://www.forager.ai/docs/guides/enrich-a-contact.md)
>
> ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
> 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"}'
> ```
>
> ```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
> 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())
> ```
>
> ```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
> 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());
> ```
>
> ```json Example response (illustrative values, trimmed) theme={"theme":{"light":"github-light","dark":"github-dark"}}
> {
>   "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" }
>     }
>   ]
> }
> ```

> [tab] Search people by role
>
> 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](https://www.forager.ai/docs/openapi/people/datastorage_person_role_search_create.md) · [Guide](https://www.forager.ai/docs/guides/search-people-by-role.md)
>
> ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
> 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}'
> ```
>
> ```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
> 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"])
> ```
>
> ```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
> 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);
> ```
>
> ```json Example response (illustrative values, trimmed) theme={"theme":{"light":"github-light","dark":"github-dark"}}
> {
>   "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" }
>     }
>   ]
> }
> ```

> [tab] Bulk data feed
>
> License people, company and job post data as files delivered to your Amazon S3 bucket, Google Cloud Storage or Snowflake. [Overview](https://www.forager.ai/docs/data-license/v2/data-feed-overview.md) · [Schema](https://www.forager.ai/docs/data-license/v2/schema.md)
>
> ```text File path layout theme={"theme":{"light":"github-light","dark":"github-dark"}}
> /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](https://www.forager.ai/docs/data-license/v2/output-data-file-details.md) and the sample files there.

## Choose your path

> [card] [REST API](https://www.forager.ai/docs/api-overview/send-your-first-request.md)
>
> Call Forager from your product or scripts, with a playground for every [endpoint](https://www.forager.ai/docs/openapi.md).

> [card] [No-code](https://www.forager.ai/docs/integrations/overview.md)
>
> Use Forager inside [Zapier](https://www.forager.ai/docs/integrations/zapier.md) or [Clay](https://www.forager.ai/docs/integrations/clay.md) without writing code.

> [card] [Data feeds](https://www.forager.ai/docs/data-license/v2/data-feed-overview.md)
>
> 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.

> [card] [Add a phone number before a call](https://www.forager.ai/docs/recipes/dialer-mobile.md)
>
> For dialers and sales engagement platforms.

> [card] [Enrich a CRM contact from an email](https://www.forager.ai/docs/recipes/crm-enrich-from-email.md)
>
> Turn an email into a person, then add contact details.

> [card] [Get a candidate's email and phone number](https://www.forager.ai/docs/recipes/candidate-contact.md)
>
> For recruiting and sourcing platforms.

> [card] [Join the people and company feeds](https://www.forager.ai/docs/recipes/feed-join-snowflake.md)
>
> For data and product teams on Snowflake.

[All recipes →](https://www.forager.ai/docs/recipes/overview.md)

## Build with AI agents

> [!TIP]
>
> **Set up Forager with a coding agent.** Paste this into Claude Code, Codex, Cursor or another coding agent:
>
> ```text Setup prompt theme={"theme":{"light":"github-light","dark":"github-dark"}}
> 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](https://www.forager.ai/docs/llms.txt), [llms-full.txt](https://www.forager.ai/docs/llms-full.txt), Markdown for any page (add `.md` to the URL) and the [Forager API skill](https://www.forager.ai/docs/skill.md). See [Build with AI agents](https://www.forager.ai/docs/guides/build-with-agents.md).

## Reference and help

> [card] [API reference](https://www.forager.ai/docs/openapi.md)
>
> Every endpoint, with an interactive playground.

> [card] [Credits and pricing](https://www.forager.ai/docs/api-overview/credit-pricing.md)
>
> What each request costs.

> [card] [What's new](https://www.forager.ai/docs/changelog.md)
>
> API and docs updates, also as an RSS feed.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.