Keyword Tool API V1 Documentation

Table of contents


Endpoints

API endpoints correspond to search engine that you would like to get keywords from.

Search EngineEndpoint
Googlehttp://api.keywordtool.io/v1/search/google
YouTubehttp://api.keywordtool.io/v1/search/youtube
Binghttp://api.keywordtool.io/v1/search/bing
Amazonhttp://api.keywordtool.io/v1/search/amazon
App Storehttp://api.keywordtool.io/v1/search/app-store

The lookup call will return keyword suggestions for your seed keyword appending and prepending it with alphabets of the language that you specify.


Supported parameters

The API endpoint supports both GET and POST request methods. For larger requests, we recommend using POST method.

ParameterDescriptionDefault ValueRequired
apikeyYour key to access API.noneYes
keywordSeed keyword, that will be used to generate suggestions.noneYes
excludeUse this parameter to specify negative keywords, i.e. the keywords that you want to exclude from your results.

For example, an API call that contains "keyword=iphone&exclude=case|game|price" will return keyword suggestions for the keyword "iphone" but there will be no keyword suggestions that contain words "case", "game", or "price".

Meaning the keyword suggestion "best iphone price" will not show up in the results.
noneNo
countryCountry, you want to get keyword suggestions for.usNo
languageLanguage, you want to get keyword suggestions for.enNo
metricsAllows to get search volume, CPC and AdWords competition data for keywords in English language if this parameter is set to "true".falseNo
typeType of search query. Available types are: "suggestions" and "questions".suggestionsNo
outputOutput of your API request.jsonNo
completeAllows to get the full set of autocomplete results. Please note that certain percent of requests might return an error if this parameter is set to "true".falseNo

Please note that we do not guarantee that every API request will return the full set of results for every autocomplete search query. As some of the requests from our side to get the live autocomplete data might not be completed due to the restrictions imposed by our data providers.

If it is necessary for you to get the full set of results you can use the following URL parameter in your API request: "complete=true". If you opt for "complete=true", all API requests that will not be able to return the full set of results will show the error with a code #-0. The workaround is to keep repeating the same request until the results will be returned. By default "complete" will be set to false.


Supported values for "country" parameter

ValueCountry
adAndorra (google.ad)
aeUnited Arab Emirates (google.ae)
afAfghanistan (google.com.af)
agAntigua and Barbuda (google.com.ag)
aiAnguilla (google.com.ai)
alAlbania (google.al)
amArmenia (google.am)
aoAngola (google.co.ao)
arArgentina (google.com.ar)
asAmerican Samoa (google.as)
atAustria (google.at)
auAustralia (google.com.au)
azAzerbaijan (google.az)
baBosnia and Herzegovina (google.ba)
bdBangladesh (google.com.bd)
beBelgium (google.be)
bfBurkina Faso (google.bf)
bgBulgaria (google.bg)
bhBahrain (google.com.bh)
biBurundi (google.bi)
bjBenin (google.bj)
bnBrunei (google.com.bn)
boBolivia (google.com.bo)
brBrazil (google.com.br)
bsBahamas (google.bs)
btBhutan (google.bt)
bwBotswana (google.co.bw)
byBelarus (google.by)
bzBelize (google.com.bz)
caCanada (google.ca)
catCatalan Countries (google.cat)
cdDemocratic Republic of the Congo (google.cd)
cfCentral African Republic (google.cf)
cgRepublic of the Congo (google.cg)
chSwitzerland (google.ch)
ciIvory Coast (google.ci)
ckCook Islands (google.co.ck)
clChile (google.cl)
cmCameroon (google.cm)
coColombia (google.com.co)
crCosta Rica (google.co.cr)
cuCuba (google.com.cu)
cvCape Verde (google.cv)
cyCyprus (google.com.cy)
czCzech Republic (google.cz)
deGermany (google.de)
djDjibouti (google.dj)
dkDenmark (google.dk)
dmDominica (google.dm)
doDominican Republic (google.com.do)
dzAlgeria (google.dz)
ecEcuador (google.com.ec)
eeEstonia (google.ee)
egEgypt (google.com.eg)
esSpain (google.es)
etEthiopia (google.com.et)
fiFinland (google.fi)
fjFiji (google.com.fj)
fmFederated States of Micronesia (google.fm)
frFrance (google.fr)
gaGabon (google.ga)
geGeorgia (google.ge)
ggGuernsey (google.gg)
ghGhana (google.com.gh)
giGibraltar (google.com.gi)
glGreenland (google.gl)
gmGambia (google.gm)
gpGuadeloupe (google.gp)
grGreece (google.gr)
gtGuatemala (google.com.gt)
gyGuyana (google.gy)
hkHong Kong (google.com.hk)
hnHonduras (google.hn)
hrCroatia (google.hr)
htHaiti (google.ht)
huHungary (google.hu)
idIndonesia (google.co.id)
ieIreland (google.ie)
ilIsrael (google.co.il)
imIsle of Man (google.im)
inIndia (google.co.in)
iqIraq (google.iq)
isIceland (google.is)
itItaly (google.it)
jeJersey (google.je)
jmJamaica (google.com.jm)
joJordan (google.jo)
jpJapan (google.co.jp)
keKenya (google.co.ke)
kgKyrgyzstan (google.kg)
khCambodia (google.com.kh)
kiKiribati (google.ki)
krSouth Korea (google.co.kr)
kwKuwait (google.com.kw)
kzKazakhstan (google.kz)
laLaos (google.la)
lbLebanon (google.com.lb)
liLiechtenstein (google.li)
lkSri Lanka (google.lk)
lsLesotho (google.co.ls)
ltLithuania (google.lt)
luLuxembourg (google.lu)
lvLatvia (google.lv)
lyLibya (google.com.ly)
maMorocco (google.co.ma)
mdMoldova (google.md)
meMontenegro (google.me)
mgMadagascar (google.mg)
mkMacedonia (google.mk)
mlMali (google.ml)
mmBurma (google.com.mm)
mnMongolia (google.mn)
msMontserrat (google.ms)
mtMalta (google.com.mt)
muMauritius (google.mu)
mvMaldives (google.mv)
mwMalawi (google.mw)
mxMexico (google.com.mx)
myMalaysia (google.com.my)
mzMozambique (google.co.mz)
naNamibia (google.com.na)
neNiger (google.ne)
nfNorfolk Island (google.com.nf)
ngNigeria (google.com.ng)
niNicaragua (google.com.ni)
nlNetherlands (google.nl)
noNorway (google.no)
npNepal (google.com.np)
nrNauru (google.nr)
nuNiue (google.nu)
nzNew Zealand (google.co.nz)
omOman (google.com.om)
paPanama (google.com.pa)
pePeru (google.com.pe)
pgPapua New Guinea (google.com.pg)
phPhilippines (google.com.ph)
pkPakistan (google.com.pk)
plPoland (google.pl)
pnPitcairn Islands (google.pn)
prPuerto Rico (google.com.pr)
psPalestine (google.ps)
ptPortugal (google.pt)
pyParaguay (google.com.py)
qaQatar (google.com.qa)
roRomania (google.ro)
rsSerbia (google.rs)
ruRussia (google.ru)
rwRwanda (google.rw)
saSaudi Arabia (google.com.sa)
sbSolomon Islands (google.com.sb)
scSeychelles (google.sc)
seSweden (google.se)
sgSingapore (google.com.sg)
shSaint Helena, Ascension and Tristan da Cunha (google.sh)
siSlovenia (google.si)
skSlovakia (google.sk)
slSierra Leone (google.com.sl)
smSan Marino (google.sm)
snSenegal (google.sn)
soSomalia (google.so)
stSão Tomé and Príncipe (google.st)
svEl Salvador (google.com.sv)
tdChad (google.td)
tgTogo (google.tg)
thThailand (google.co.th)
tjTajikistan (google.com.tj)
tkTokelau (google.tk)
tlTimor-Leste (google.tl)
tmTurkmenistan (google.tm)
tnTunisia (google.tn)
toTonga (google.to)
trTurkey (google.com.tr)
ttTrinidad and Tobago (google.tt)
twTaiwan (google.com.tw)
tzTanzania (google.co.tz)
uaUkraine (google.com.ua)
ugUganda (google.co.ug)
ukUnited Kingdom (google.co.uk)
usUnited States (google.com)
uyUruguay (google.com.uy)
uzUzbekistan (google.co.uz)
vcSaint Vincent and the Grenadines (google.com.vc)
veVenezuela (google.co.ve)
vgBritish Virgin Islands (google.vg)
viUnited States Virgin Islands (google.co.vi)
vnVietnam (google.com.vn)
vuVanuatu (google.vu)
wsSamoa (google.ws)
zaSouth Africa (google.co.za)
zmZambia (google.co.zm)
zwZimbabwe (google.co.zw)
ValueCountry
adAndorra
aeUnited Arab Emirates (الإمارات العربيّة المتّحدة)
afAfghanistan (افغانستان)
agAntigua and Barbuda
aiAnguilla
alAlbania (Shqipëria)
amArmenia (Hayastán)
aoAngola
aqAntarctica
arArgentina
asAmerican Samoa (Amerika Sāmoa)
atAustria (Österreich)
auAustralia
awAruba
azAzerbaijan (Azərbaycan)
baBosnia and Herzegovina (Bosna i Hercegovina)
bbBarbados
bdBangladesh (বাংলাদেশ)
beBelgium (België)
bfBurkina Faso
bgBulgaria
bhBahrain (البحرين)
biBurundi
bjBenin (Bénin)
bmBermuda
bnBrunei (بروني)
boBolivia
brBrazil (Brasil)
bsBahamas
btBhutan (འབྲུག་ཡུལ)
bvBouvet Island
bwBotswana
byBelarus (Беларусь)
bzBelize
caCanada
ccCocos (Keeling) Islands
cdCongo - Democratic Republic of
cfCentral African Republic (République Centrafricaine)
cgCongo
chSwitzerland (Schweiz)
ciCote d'Ivoire
ckCook Islands
clChile
cmCameroon (Cameroun)
coColombia
crCosta Rica
cvCape Verde (Cabo Verde)
cxChristmas Island
cyCyprus (Kypros)
czCzech Republic (Česká Republika)
deGermany (Deutschland)
djDjibouti (جيبوتي)
dkDenmark (Danmark)
dmDominica
doDominican Republic (República Dominicana)
dzAlgeria (الجزائر)
ecEcuador
eeEstonia (Eesti)
egEgypt (مصر)
ehWestern Sahara
erEritrea (إرتريا)
esSpain (España)
etEthiopia (Ityop'ia)
fiFinland (Suomi)
fjFiji
fkFalkland Islands (Islas Malvinas)
fmMicronesia - Federated States of
foFaroe Islands (Føroyar)
frFrance
gaGabon
gdGrenada
geGeorgia (Sak'art'velo)
gfFrench Guiana (Guyane)
ghGhana
giGibraltar
glGreenland (Kalaallit Nunaat)
gmGambia
gnGuinea (Guinée)
gpGuadeloupe
gqEquatorial Guinea (Guinea Ecuatorial)
grGreece (Hellas)
gsSouth Georgia and the South Sandwich Islands
gtGuatemala
guGuam (Guåhån)
gwGuinea-Bissau (Guiné-Bissau)
gyGuyana
hkHong Kong (香港)
hmHeard Island and McDonald Islands
hnHonduras
hrCroatia (Hrvatska)
htHaiti (Haïti)
huHungary (Magyarország)
idIndonesia
ieIreland (Éire)
ilIsrael (إسرائيل)
inIndia
ioBritish Indian Ocean Territory
iqIraq
isIceland (Ísland)
itItaly (Italia)
jmJamaica
joJordan (الأردن)
jpJapan (日本)
keKenya
kgKyrgyzstan (Кыргызстан)
khCambodia (Kampuchea)
kiKiribati
kmComoros (جزر القمر)
knSaint Kitts and Nevis
krSouth Korea (한국)
kwKuwait (الكويت)
kyCayman Islands
kzKazakhstan (Қазақстан)
laLaos (Lao)
lbLebanon (لبنان)
lcSaint Lucia
liLiechtenstein
lkSri Lanka (Sri Lankā)
lrLiberia
lsLesotho
ltLithuania (Lietuva)
luLuxembourg (Lëtzebuerg)
lvLatvia (Latvija)
lyLibya
maMorocco (Amerruk)
mcMonaco
mdMoldova
mgMadagascar (Madagasikara)
mhMarshall Islands
mkMacedonia (Makedonija)
mlMali
mnMongolia (Mongol Uls)
moMacao
mpNorthern Mariana Islands
mqMartinique
mrMauritania (Muritan)
msMontserrat
mtMalta
muMauritius (Maurice)
mvMaldives (Dhivehi Raajje)
mwMalawi
mxMexico (México)
myMalaysia
mzMozambique (Moçambique)
naNamibia
ncNew Caledonia (Nouvelle-Calédonie)
neNiger
nfNorfolk Island
ngNigeria
niNicaragua
nlNetherlands (Nederland)
noNorway (Norge)
npNepal (Nepāla)
nrNauru
nuNiue
nzNew Zealand
omOman (عُمان)
paPanama (Panamá)
pePeru (Perú)
pfFrench Polynesia (Polynésie Française)
pgPapua New Guinea
phPhilippines (Pilipinas)
pkPakistan (پاکستان)
plPoland (Polska)
pmSaint Pierre and Miquelon
pnPitcairn
prPuerto Rico
psWest Bank
ptPortugal
pwPalau (Belau)
pyParaguay
qaQatar (قطر)
reReunion (Réunion)
roRomania (România)
ruRussia (Россия)
rwRwanda
saSaudi Arabia (المملكة العربية السعودية)
sbSolomon Islands
scSeychelles (Sesel)
seSweden (Sverige)
sgSingapore
shSaint Helena
siSlovenia (Slovenija)
sjSvalbard and Jan Mayen
skSlovakia (Slovensko)
slSierra Leone
smSan Marino
snSenegal (Sénégal)
soSomalia (Soomaaliya)
srSuriname
stSao Tome and Principe (São Tomé e Príncipe)
svEl Salvador
szSwaziland
tcTurks and Caicos Islands
tdChad (Tchad)
tfFrench Southern Territories
tgTogo
thThailand (ประเทศไทย)
tjTajikistan (Тоҷикистон)
tkTokelau
tlTimor-Leste
tmTurkmenistan (Türkmenistan)
tnTunisia (Tunes)
toTonga
trTurkey (Türkiye)
ttTrinidad and Tobago
tvTuvalu
twTaiwan (中華民國)
tzTanzania
uaUkraine (Україна)
ugUganda
ukUnited Kingdom
umUnited States Minor Outlying Islands
usUnited States
uyUruguay (República Oriental del Uruguay)
uzUzbekistan (Ўзбекистон)
vaHoly See (Vatican City State) (Città del Vaticano)
vcSaint Vincent and the Grenadines
veVenezuela
vgBritish Virgin Islands
viUnited States Virgin Islands
vnVietnam (Việt Nam)
vuVanuatu
wfWallis and Futuna (Wallis-et-Futuna)
wsSamoa
yeYemen (اليمن)
ytMayotte
zaSouth Africa (Suid-Afrika)
zmZambia
zwZimbabwe
ValueCountry
arArgentina
atAustria (Österreich)
auAustralia
beBelgium (België)
brBrazil (Brasil)
caCanada
chSwitzerland (Schweiz)
cnPeople's Republic of China
deGermany (Deutschland)
esSpain (España)
frFrance
gbUnited Kingdom
hkHong Kong (香港)
idIndonesia
inIndia
itItaly (Italia)
jpJapan (日本)
koKorea (한국)
mxMexico (México)
myMalaysia
nlNetherlands (Nederland)
noNorway (Norge)
nzNew Zealand
phRepublic of the Philippines
plPoland (Polska)
ruRussia (Россия)
seSweden (Sverige)
trTurkey (Türkiye)
twTaiwan (中華民國)
usUnited States
xaSaudi Arabia (المملكة العربية السعودية)
zaSouth Africa (Suid-Afrika)
ValueCountry
auAustralia
brBrazil (Brasil)
caCanada
cnChina (Zhōngguó)
deGermany (Deutschland)
esSpain (España)
frFrance
gbUnited Kingdom
inIndia
itItaly (Italia)
jpJapan (日本)
mxMexico (México)
nlNetherlands (Nederland)
usUnited States
ValueCountry
aeUnited Arab Emirates (الإمارات العربيّة المتّحدة)
agAntigua & Barbuda
aiAnguilla
alAlbania (Shqipëria)
amArmenia (Hayastán)
aoAngola
arArgentina
atAustria (Österreich)
auAustralia
azAzerbaijan (Azərbaycan)
bbBarbados
beBelgium (België)
bfBurkina-Faso
bgBulgaria
bhBahrain (البحرين)
bjBenin (Bénin)
bmBermuda
bnBrunei (بروني)
boBolivia
brBrazil (Brasil)
bsBahamas
btBhutan (འབྲུག་ཡུལ)
bwBotswana
byBelarus (Беларусь)
bzBelize
caCanada
cdCongo, Republic of
chSwitzerland (Schweiz)
clChile
cnChina (Zhōngguó)
coColombia
crCosta Rica
cvCape Verde (Cabo Verde)
cyCyprus (Kypros)
czCzech Republic (Česká Republika)
deGermany (Deutschland)
dkDenmark (Danmark)
dmDominica
doDominican Republic (República Dominicana)
dzAlgeria (الجزائر)
ecEcuador
eeEstonia (Eesti)
egEgypt (مصر)
esSpain (España)
fiFinland (Suomi)
fjFiji
fmMicronesian, Federated States of
frFrance
gbUnited Kingdom
gdGrenada
ghGhana
gmGambia
gnPapua New Guinea
grGreece (Hellas)
gtGuatemala
gwGuinea Bissau (Guiné Bissau)
gyGuyana
hkHong Kong (香港)
hnHonduras
hrCroatia (Hrvatska)
huHungary (Magyarország)
idIndonesia
ieIreland (Éire)
ilIsrael (إسرائيل)
inIndia
isIceland (Ísland)
itItaly (Italia)
jmJamaica
joJordan (الأردن)
jpJapan (日本)
keKenya
kgKyrgyzstan (Кыргызстан)
khCambodia (Kampuchea)
knSt. Kitts & Nevis
krSouth Korea (한국)
kwKuwait (الكويت)
kyCayman Islands
kzKazakhstan (Қазақстан)
laLaos (Lao)
lbLebanon (لبنان)
lcSt. Lucia
lkSri Lanka (Sri Lankā)
lrLiberia
ltLithuania (Lietuva)
luLuxembourg (Lëtzebuerg)
lvLatvia (Latvija)
mdMoldova
mgMadagascar (Madagasikara)
mkMacedonia (Makedonija)
mlMali
mnMongolia (Mongol Uls)
moMacau
mrMauritania (Muritan)
msMontserrat
mtMalta, Republic of
muMauritius (Maurice)
mwMalawi
mxMexico (México)
myMalaysia
mzMozambique (Moçambique)
naNamibia
neNiger
ngNigeria
niNicaragua
nlNetherlands (Nederland)
noNorway (Norge)
npNepal (Nepāla)
nzNew Zealand
omOman (عُمان)
paPanama (Panamá)
pePeru (Perú)
phPhilippines (Pilipinas)
pkPakistan (پاکستان)
plPoland (Polska)
ptPortugal
pwPalau (Belau)
pyParaguay
qaQatar (قطر)
roRomania (România)
ruRussia (Россия)
saSaudi Arabia (المملكة العربية السعودية)
sbSoloman Islands
scSeychelles (Sesel)
seSweden (Sverige)
sgSingapore
sjSlovenia (Slovenija)
skSlovakia (Slovensko)
slSierra Leone
snSenegal (Sénégal)
srSuriname
stSao Tome e Principe (São Tomé e Príncipe)
svEl Salvador
szSwaziland
tcTurks & Caicos
tdChad (Tchad)
thThailand (ประเทศไทย)
tjTajikistan (Тоҷикистон)
tmTurkmenistan (Türkmenistan)
tnTunisia (Tunes)
trTurkey (Türkiye)
ttTrinidad & Tobago
twTaiwan (中華民國)
tzTanzania
uaUkraine (Україна)
ugUganda
usUnited States
uyUruguay (República Oriental del Uruguay)
uzUzbekistan (Ўзбекистон)
vcSt. Vincent & The Grenadines
veVenezuela
vgBritish Virgin Islands
vnVietnam (Việt Nam)
yeYemen (اليمن)
zaSouth Africa (Suid-Afrika)
zwZimbabwe

Supported values for "language" parameter

ValueLanguage
afAfrikaans
arArabic (العربية)
azAzerbaijani (Azərbaycanca)
beBelarusian (Беларуская)
bgBulgarian (Български)
bhBihari (বিহারী)
bnBengali (বাঙ্গালী)
bsBosnian (Bosanski)
caCatalan (Català)
csCzech (Čeština)
cyWelsh (Cymraeg)
daDanish (Dansk)
deGerman (Deutsch)
elGreek (ελληνικά)
enEnglish
eoEsperanto
esSpanish (Español)
etEstonian (Eesti)
euBasque (Euskal)
faPersian (فارسی)
fiFinnish (Suomi)
foFaroese (Føroyskt)
frFrench (Français)
fyFrisian
gaIrish (Gaeilge)
gdScottish Gaelic (Gàidhlig)
glGalician (Galego)
guGujarati (ગુજરાતી)
hiHindi (हिंदी)
hrCroatian (Hrvatski)
huHungarian (Magyar)
iaInterlingua
idIndonesian (Bahasa Indonesia)
isIcelandic
itItalian (Italiano)
iwHebrew (עברית)
jaJapanese (日本語)
jwJavanese (Jawa)
kaGeorgian (ქართული)
knKannada (ಕನ್ನಡ)
koKorean (한국어)
laLatin (Latine)
ltLithuanian (Lietuvių Kalba)
lvLatvian (Latviešu Valoda)
mkMacedonian (Македонски Јазик)
mlMalayam (മലയാളം)
mrMarathi (मराठी)
msMalay (Bahasa Melayu)
mtMaltese (Malti)
neNepali (नेपाली)
nlDutch (Nederlands)
nnNorwegian (Nynorsk)
noNorwegian (Norsk)
ocOccitan (Lenga d'òc)
paPunjabi (ਪੰਜਾਬੀ ਦੇ)
plPolish (Polski)
pt-BRPortuguese - Brazil (Português - Brasil)
pt-PTPortuguese - Portugal (Português - Portugal)
roRomanian (Român)
ruRussian (Русский)
siSinhalese (සිංහල)
skSlovak (Slovenský)
slSlovenian (Slovenščina)
smAmharic
sqAlbanian (Shqip)
srSerbian (Cрпски)
suSudanese
svSwedish (Svenska)
swSwahili (Kiswahili)
taTamil (தமிழ்)
teTelugu
thThai (ภาษาไทย)
tiTigrinya (ትግርኛ)
tlTagalog
trTurkish (Türk)
ukUkrainian (Українська)
urUrdu (اُردُو‎)
uzUzbek (O'zbekcha)
viVietnamese (Việt)
xhXhosa
zh-CNChinese - Simplified (中国 - 简体)
zh-TWChinese - Traditional (中文 - 繁體)
zuZulu
ValueLanguage
arArabic (العربية)
bgBulgarian (Български)
caCatalan (Català)
csCzech (Čeština)
daDanish (Dansk)
deGerman (Deutsch)
elGreek (ελληνικά)
enEnglish
esSpanish (Español)
etEstonian (Eesti)
fiFinnish (Suomi)
frFrench (Français)
hiHindi (हिंदी)
hrCroatian (Hrvatski)
huHungarian (Magyar)
idIndonesian (Bahasa Indonesia)
isIcelandic
itItalian (Italiano)
iwHebrew (עברית)
jaJapanese (日本語)
koKorean (한국어)
ltLithuanian (Lietuvių Kalba)
lvLatvian (Latviešu Valoda)
nlDutch (Nederlands)
noNorwegian (Norsk)
plPolish (Polski)
ptPortuguese (Português)
roRomanian (Român)
ruRussian (Русский)
skSlovak (Slovenský)
slSlovenian (Slovenščina)
srSerbian (Cрпски)
svSwedish (Svenska)
thThai (ภาษาไทย)
tlTagalog
trTurkish (Türk)
ukUkrainian (Українська)
urUrdu (اُردُو‎)
viVietnamese (Việt)
zh_CNChinese - Simplified (中国 - 简体)
zh_TWChinese - Traditional (中文 - 繁體)
ValueLanguage
arArabic (العربية)
deGerman (Deutsch)
enEnglish
esSpanish (Español)
frFrench (Français)
itItalian (Italiano)
jaJapanese (日本語)
koKorean (한국어)
nlDutch (Nederlands)
noNorwegian (Norsk)
plPolish (Polski)
ptPortuguese (Português)
ruRussian (Русский)
svSwedish (Svenska)
trTurkish (Türk)
zhChinese (中国)
ValueLanguage
deGerman (Deutsch)
enEnglish
esSpanish (Español)
frFrench (Français)
itItalian (Italiano)
jaJapanese (日本語)
nlDutch (Nederlands)
ptPortuguese (Português)
zhChinese (中国)
ValueLanguage
arArabic (العربية)
caCatalan (Català)
csCzech (Čeština)
daDanish (Dansk)
deGerman (Deutsch)
elGreek (ελληνικά)
enEnglish
esSpanish (Español)
fiFinnish (Suomi)
frFrench (Français)
hiHindi (हिंदी)
hrCroatian (Hrvatski)
huHungarian (Magyar)
idIndonesian (Bahasa Indonesia)
itItalian (Italiano)
iwHebrew (עברית)
jaJapanese (日本語)
koKorean (한국어)
msMalay (Bahasa Melayu)
nlDutch (Nederlands)
noNorwegian (Norsk)
plPolish (Polski)
pt-BRPortuguese - Brazil (Português - Brasil)
pt-PTPortuguese - Portugal (Português - Portugal)
roRomanian (Român)
ruRussian (Русский)
skSlovak (Slovenský)
svSwedish (Svenska)
thThai (ภาษาไทย)
trTurkish (Türk)
ukUkrainian (Українська)
viVietnamese (Việt)
zh-CNChinese - Simplified (中国 - 简体)
zh-TWChinese - Traditional (中文 - 繁體)

Supported values for "output" parameter

ValueOutput
jsonJSON
xmlXML

Examples

http://api.keywordtool.io/v1/search/google?apikey=[API_KEY]&keyword=abc&country=us&language=en&output=json
curl -s "http://api.keywordtool.io/v1/search/google?apikey=[API_KEY]&keyword=abc&country=us&language=en&output=json"
<?php

$apikey = '[API_KEY]';

$params = array(
  'apikey' => $apikey,
  'keyword' => 'abc',
  'country' => 'us',
  'language' => 'en',
  'output' => 'json',
);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'http://api.keywordtool.io/v1/search/google?' . http_build_query($params));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
$output = curl_exec($ch);
$response = json_decode($output, TRUE);

var_dump($response);
import urllib2
import json
import pprint

url = 'http://api.keywordtool.io/v1/search/google?apikey=[API_KEY]&keyword=abc&country=us&language=en&output=json'
data = json.loads(urllib2.urlopen(url).read())
pprint.pprint(data)
var request = require('request');

function dump(obj) {
  return require('util').inspect(obj, false, null, true);
}

request('http://api.keywordtool.io/v1/search/google?apikey=[API_KEY]&keyword=abc&country=us&language=en&output=json', function(error, response, body) {
  if (!error && response.statusCode == 200) {
    data = JSON.parse(body);
    console.log(dump(data));
  }
});

Keyword suggestions generated using Keyword Tool API can be pulled right into Google Spreadsheets using ImportXML function.

Here is sample syntax of ImportXML function that you can use:

=IMPORTXML("http://api.keywordtool.io/v1/search/google?apikey=[API_KEY]&keyword=how+to&country=us&language=en&output=xml", "//item/@string")

We have created a Google Spreadsheet template that will allow you generate keyword suggestions for multiple keywords and specify negative keywords (keywords that will be excluded from the suggestions).

You can make a copy of the Google Spreadsheet template using this link.


Limits

You can make up to 5 API requests per minute and 7,200 API requests daily 1. Every API request will return up to 1,400+ keywords for Google and YouTube, 1,900+ for Bing, 760+ for Amazon, and 3,800+ for App Store. 2

In the table below you can see how many keywords you can get per day using the API.

Search EngineMaximum number of keywords returned per 1 API requestNumber of keywords you can get from the API in 1 day
Google1,40010,080,000
YouTube1,40010,080,000
Bing1,90013,680,000
App Store3,80027,360,000
Amazon7605,472,000

1 Daily limits are calculated within the 24 hour timeframe window.
2 These numbers vary depending on the "language" parameter that you use.


Error Codes

Error CodeDescriptionHTTP Code
n/aAPI general error. Please contact support.404
#-0We are unable to process your request at this time, please try again later.404
#-1No such country code.404
#-2No such language code.404
1No search provider.404
2No such search provider supported.404
3No search query provided.404
4No API key provided.404
5The API key provided is invalid.404
6You have tried to use an invalid API key for too many consecutive times.404
7You have reached your limit of searches. Please try again shortly.404
8Please provide not more than 2,000 negative keywords in your request.404
9Sorry, you have reached your daily limit of searches. Please try again another day.404
10Search results could be incomplete, please try again later. This request was not counted against your quota.200