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

# Company search with the API

> Search companies in the Forager organization index by domain, industry, size, location and more, and count matches first.

![Company search with industry, size and technology filters returns matching companies](https://mintcdn.com/forager/EGsWCxLOYv1Cb__c/images/illustrations/company-search-filters-results.svg?fit=max\&auto=format\&n=EGsWCxLOYv1Cb__c\&q=85\&s=a91372069d2725c2eec4362f0060b906)

Use this to find companies that match filters.

## Search

Send a `POST` to [Organization search](https://www.forager.ai/docs/openapi/organizations/datastorage_organization_search_create.md). This example filters by domain.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST "https://api-v2.forager.ai/api/$FORAGER_ACCOUNT_ID/datastorage/organization_search/" \
     -H "X-API-KEY: $FORAGER_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
           "domains": ["acme.com"]
         }'
```

Set `FORAGER_API_KEY` and `FORAGER_ACCOUNT_ID` in your shell first, as in the [quickstart](https://www.forager.ai/docs/api-overview/send-your-first-request.md). See [Authentication](https://www.forager.ai/docs/api-overview/authentication.md).

Other filters in the request include `industries`, `locations`, `keywords`, `web_technologies`, `employees_start` / `employees_end`, `revenue_start` / `revenue_end`, `founded_date_start` / `founded_date_end`, funding fields and job post fields. See the full list in the [operation reference](https://www.forager.ai/docs/openapi/organizations/datastorage_organization_search_create.md).

Filters that take IDs (industries, locations, keywords, web technologies) use values from the [Autocomplete](https://www.forager.ai/docs/openapi/autocomplete) endpoints.

## Count first

[Organization search totals](https://www.forager.ai/docs/openapi/organizations/datastorage_organization_search_totals_create.md) takes the same body and returns match counts, so you can size a query before paging with `page`.

## Costs

See [Credit pricing](https://www.forager.ai/docs/api-overview/credit-pricing.md).


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