Find valid filter IDs with autocomplete - Forager.ai Docs

Filter IDs from autocomplete: a text value becomes an ID that the search filters accept

Filter IDs from autocomplete: a text value becomes an ID that the search filters accept

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	People search: `person_industries`, `person_industries_exclude`, `organization_industries`, `organization_industries_exclude`. Company search: `industries`, `industries_exclude`
Locations lookup	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	People search: `person_skills`
Organization keywords lookup	People search: `organization_keywords`. Company search: `keywords`
Web technologies lookup	People search: `organization_web_technologies`. Company search: `web_technologies`
Organizations lookup	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).

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:

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.
Autocomplete calls are free: they don’t use credits. See API credits and pricing.

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.

Last modified on October 28, 2026