Countries and languages
SEO endpoints take a country and a language. Countries are ISO 3166-1 alpha-2 codes and languages are ISO 639-1 codes, the same two letter codes you already know. Both are optional: country defaults to US, and language defaults to the main language of the country you chose.
The language default matters. Search data for a country exists in the
languages people search it in, so ES with en returns nothing while ES
with es is the whole Spanish market. Leave language out unless you have a
reason to set it.
Countries
| Region | Codes and default language |
|---|---|
| Americas | US en · CA en · MX es · BR pt · AR es · CO es · CL es · PE es · EC es · UY es · PY es · BO es · VE es · CR es · PA es · GT es · HN es · SV es · NI es · DO es · PR es · CU es |
| Europe | GB en · IE en · ES es · PT pt · FR fr · DE de · AT de · CH de · IT it · NL nl · BE fr · SE sv · NO no · DK da · FI fi · PL pl · CZ cs · RO ro · HU hu · GR el · TR tr · RU ru · UA uk |
| Middle East and Africa | IL he · AE ar · SA ar · EG ar · MA fr · ZA en · NG en · KE en |
| Asia Pacific | AU en · NZ en · IN en · PK en · SG en · PH en · ID id · MY ms · TH th · VN vi · JP ja · KR ko · CN zh · TW zh · HK zh |
GET /v1 returns the full list as JSON under countries.
Languages
en, es, pt, fr, de, it, nl, pl, ru, ja, ko, zh, ar, tr, sv, no, da, fi, cs, ro, hu, el, he, id, ms, th, vi, uk, ca.
Any combination is accepted by the API, but not every combination has data. If a domain or keyword returns 404 not_found in a country where you know it has a presence, the language is the first thing to check.
Social endpoints
Instagram, TikTok and Facebook Ads are global and take no country or language. Results are whatever is public for that handle, hashtag, query or page.