Geotargeting

Local content

Every request can be routed through one of more than 190 countries, by subdivision and city:

$ curl -H "Authorization: Bearer $AGENT_FIRST_TOKEN" \
  'https://api.agentfirst.dev/search'\
  '?terms=musical+instruments'\
  '&country=us'

View subdivision-targeting example

View city-targeting example

These are the available geotargeting keys and values:

Key	Required	Value
`country`	⬜	The two-letter ISO code of the country to browse from (these codes are case insensitive); a random country will be used by default
`subdivision`	⬜	The alphanumeric second part (proceeding the separator) of a first-level subdivision code in the (prerequisite) country to browse from (these codes are case insensitive); a random subdivision will be used by default
`city`	⬜	The commonly spelled name of the city in the (prerequisite) country to browse from (these names are temporarily case sensitive and required to include form- or URL-encoded spaces and punctuation marks); a random city will be used by default

The city takes precedence over the subdivision if both are targeted.