Skip to main content
GET
Locations lookup

When to use this endpoint

You need the numeric ID of a city, state, country or continent to use in the locations filters of the people, company and job searches.

Example request

cURL
Set FORAGER_API_KEY and FORAGER_ACCOUNT_ID as in the quickstart.

Example response

200 (illustrative values)

Credits

This endpoint is free: it does not use credits. See API credits and pricing.

Authorizations

X-API-KEY
string
header
required

Path Parameters

account_id
integer
required

Account ID. Autocomplete requests are scoped to this account.

Query Parameters

q
string
required

City, State, Country or Continent.

page
integer

Response

Valid response.

results
object[]
pagination
object
Last modified on November 1, 2026