GET /v1/regions describes how geo targeting works: the shape of a region object, worked examples, and the popular countries the exit network covers. Like GET /v1/surfaces, it’s public discovery — read it to learn the targeting model without needing a key.
Deliberately unauthenticated, like
GET /v1/surfaces. Every other /v1
route requires Authorization: Bearer <key>; these two discovery routes do
not, so a client can learn the capability and targeting model up front.Request
Response
200 OK
The fields a region object accepts.
country is required; state, city,
and language narrow the capture further.Ready-to-use region objects covering common targeting patterns.
Commonly targeted countries where the v1 exit network has the strongest
coverage.
country accepts any valid ISO 3166-1 alpha-2 code — this list is a
convenience, not an allowlist, so a country outside it is not rejected.A region multiplies fan-out: one search across N surfaces and M regions
creates N × M billed children. See Regional availability
for the full targeting model, including
requested vs. effective region.Regions guide
Targeting, fan-out math, and requested vs. effective region.
List surfaces
The other public discovery endpoint: the live surface matrix.