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

# Find valid filter IDs with autocomplete

> Search filters take IDs, not free text. Use the autocomplete endpoints to turn names like an industry or city into the IDs the search endpoints expect.

![Filter IDs from autocomplete: a text value becomes an ID that the search filters accept](https://mintcdn.com/forager/OnhSHNo_LBQ7yKjR/images/illustrations/filter-ids-autocomplete-to-search.svg?fit=max\&auto=format\&n=OnhSHNo_LBQ7yKjR\&q=85\&s=612ebdfbefc21d1d3163a4bf245a8cd1)

The search endpoints filter on IDs. Passing a name such as `"Software"` or `"Berlin"` where an ID is expected will not match. Resolve each name with the matching autocomplete endpoint, then pass the returned IDs.

## Which autocomplete endpoint feeds which filter

| Autocomplete endpoint | Filters it feeds |
| - | - |
| [Industries lookup](https://www.forager.ai/docs/openapi/autocomplete/v1_industry_lookup.md) | People search: `person_industries`, `person_industries_exclude`, `organization_industries`, `organization_industries_exclude`. Company search: `industries`, `industries_exclude` |
| [Locations lookup](https://www.forager.ai/docs/openapi/autocomplete/v1_location_lookup.md) | People search: `person_locations`, `organization_locations`, `job_post_locations`, `job_post_locations_exclude`. Company search: `locations`, `job_post_locations`, `job_post_locations_exclude`. Job postings: `locations`, `locations_exclude` |
| [Person skills lookup](https://www.forager.ai/docs/openapi/autocomplete/v1_person_skill_lookup.md) | People search: `person_skills` |
| [Organization keywords lookup](https://www.forager.ai/docs/openapi/autocomplete/v1_organization_keyword_lookup.md) | People search: `organization_keywords`. Company search: `keywords` |
| [Web technologies lookup](https://www.forager.ai/docs/openapi/autocomplete/v1_web_technology_lookup.md) | People search: `organization_web_technologies`. Company search: `web_technologies` |
| [Organizations lookup](https://www.forager.ai/docs/openapi/autocomplete/v1_organization_lookup.md) | People search: `organizations`. Company search: `organization_ids`. Job postings: `organization_ids` |

## Example: resolve an industry, then search

Each autocomplete endpoint takes a search term in `q` (and an optional `page`).

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -G "https://api-v2.forager.ai/api/$FORAGER_ACCOUNT_ID/datastorage/autocomplete/industries/" \
  -H "X-API-KEY: $FORAGER_API_KEY" \
  --data-urlencode "q=software"
```

Pick the IDs you want from the response, then pass them to the search:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
INDUSTRY_ID=123  # replace with an ID from the autocomplete response

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 "{\"industries\": [$INDUSTRY_ID]}"
```

## Limits and cost

* Autocomplete is limited to 10 requests per second per account. Cache IDs you use often instead of resolving them on every search. See [API errors and rate limits](https://www.forager.ai/docs/errors-and-rate-limits.md).
* Autocomplete calls are free: they don't use credits. See [API credits and pricing](https://www.forager.ai/docs/api-overview/credit-pricing.md).

## For AI agents

Resolve every filter value through autocomplete before calling a search endpoint. Never guess an ID or pass free text in an ID filter.


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