Skip to main content

​
Local content

Every HTTP 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'

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 parameters:
KeyRequiredValue
country⬜The two-letter ISO code of the country to browse from (these codes are case insensitive); a random country is 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 is 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 is used by default
City targeting takes precedence over subdivision targeting if both are specified.