> ## 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.

# Glossary

> Terms used in the Forager documentation: Account ID, API key, credits, Forager ID, LinkedIn public identifier, data feed and more.

![Forager glossary terms: Account ID, API key, credits, person ID and data feed](https://mintcdn.com/forager/OnhSHNo_LBQ7yKjR/images/illustrations/forager-glossary-terms.svg?fit=max\&auto=format\&n=OnhSHNo_LBQ7yKjR\&q=85\&s=a9824d0549dbb380a66343dd4be33790)

Terms as used in these docs.

> [accordion] Account ID
>
> The ID of your Forager account. It goes in the path of most API requests as `{account_id}`. Find it on the [My Account](https://app.forager.ai/profile) page of the Forager Web App.

> [accordion] API key
>
> The secret you send in the `X-API-KEY` header to authenticate API requests. Create one in the [Forager Web App](https://app.forager.ai/keys). Credits are charged to the account the key belongs to. See [Authentication](https://www.forager.ai/docs/api-overview/authentication.md).

> [accordion] Credits
>
> The unit Forager charges for API requests. Each request type uses a set number of credits. See [Credit pricing](https://www.forager.ai/docs/api-overview/credit-pricing.md).

> [accordion] Forager ID
>
> The numeric ID of a person record in the Forager dataset. Request bodies use it as `person_id`. Person role search returns it as `person.id` on each result; the top-level `id` of a result is the role, not the person. See [Recipes](https://www.forager.ai/docs/api-overview/recipes.md).

> [accordion] LinkedIn public identifier
>
> The slug in a LinkedIn profile URL (`linkedin.com/in/<slug>/`). Several endpoints accept it as `linkedin_public_identifier` to identify a person. For organizations it is the slug in `linkedin.com/company/<slug>/`.

> [accordion] Autocomplete
>
> Endpoints that turn free text (industries, organizations, organization keywords, locations, person skills, web technologies) into the IDs that the search endpoints accept as filters. See [Autocomplete](https://www.forager.ai/docs/openapi/autocomplete).

> [accordion] Role search
>
> A search for people by role: title, description, current or past role, dates, person and organization attributes. See [Person role search](https://www.forager.ai/docs/openapi/people/datastorage_person_role_search_create.md).

> [accordion] Totals endpoint
>
> A search variant that returns match counts for a query instead of the full result set. For example, [Person role search totals](https://www.forager.ai/docs/openapi/people/datastorage_person_role_search_totals_create.md).

> [accordion] Work email lookup job
>
> An asynchronous work email lookup. Submitting returns a `job_id` and a `status_check_url`; you poll until `status` is `completed` or `failed`. A bulk submission returns a `batch_id` instead. See [Work Emails](https://www.forager.ai/docs/openapi/work-emails).

> [accordion] Webhook URL
>
> An optional https URL on work email lookups. Forager POSTs the results there when the job or batch completes, so you do not need to poll.

> [accordion] Data feed
>
> Bulk people, company and job datasets delivered as files under an annual license, as opposed to API requests. See [Data Feed V2 Overview](https://www.forager.ai/docs/data-license/v2/data-feed-overview.md).

> [accordion] serialized\_data
>
> The property of each data feed record that holds the JSON object described by the [schema](https://www.forager.ai/docs/data-license/v2/schema.md).


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