Skip to main content

​
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'

​
Accounting

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

$ curl -H "Authorization: Bearer $AGENT_FIRST_TOKEN" \
  'https://api.agentfirst.dev/browser'\
  '?url=https://guitars.com/'\
  '&country=us'\
  '&city=nashville'
These are the available geotargeting keys and values:
KeyRequiredValue
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
City targeting takes precedence over subdivision targeting if both are specified.