Keyword Tool API Документация

Table of Contents


Get Started

Keyword Tool API can be used to either get the search volume data for the provided keywords or generate keyword suggestions. Hence, the API offers 2 services that are called Search Volume and Keyword Suggestions.

Search Volume Service

Search Volume service allows getting Google search volume data for the keywords that you provide. Every API request accepts from 1 to 800 keywords. Provided search volume can be localized to 86,460 individual locations, 83 languages and "Google" or "Google and search partners" search network. By default, the global search volume for "Google and search partners" is provided.

An API request returns average Google search volume data for the past 12 months, search volume breakdown by individual months, cost-per-click (CPC) and AdWords competition data (CMP). Results can be returned in JSON or XML format.

Keyword Suggestions Service

Keyword Suggestions service allows getting the autocomplete keyword suggestions from the various search engines. Autocomplete suggestions are generated by prepending and appending a seed keyword with the various letters and numbers from the specified language. Keyword suggestions can be localized to 192 countries and 83 languages. By default, keywords are localized to the US and English language.

Every API request returns the list of keyword suggestions and if requested - Google search volume data: average monthly search volume for the last 12 months, search volume breakdown by individual months, cost-per-click (CPC) and AdWords competition data (CMP). Search volume data is localized to the provided country and language. And can be pulled from "Google" or "Google and search partners" network. By default, the search volume for "Google and search partners" is provided.


Endpoints

At the moment, only Google data is provided. That is why there is a single endpoint for retrieving the search volume data:

http://api.keywordtool.io/v2/search/volume/google

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

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


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
keywordKeywords you would like to get the search volume for. 1 to 800 keywords are accepted. Data must be provided in JSON encoded format e.g. ["chair","table","phone case"]noneYes
metrics_locationLocation, that you would like to localize the search volume to. Accepts up to 10 comma-separated location IDs. Location IDs can be found here.noneNo
metrics_languageLanguage, that you would like to localize the search volume to. Accepts up to 5 comma-separated language codes. Language codes can be found here.noneNo
metrics_networkSearch network that will be used to pull the search volume data.googlesearchnetworkNo
metrics_currencyThe currency that will be used to display cost-per-click (CPC) data.USDNo
outputOutput of your API request.jsonNo
ParameterDescriptionDefault valueRequired
apikeyYour key to access API.noneYes
keywordSeed keyword that will be used to generate suggestions. Only 1 keyword is accepted in plain text format.noneYes
excludeUse this parameter to specify negative keywords, i.e. the keywords that you want to exclude from your results.

Must be provided in JSON format. 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
countryA country, you want to get keyword suggestions for. Only a single value is accepted.usNo
languageLanguage, you want to get keyword suggestions for. Only a single value is accepted.enNo
metricsAllows to get Google Search Volume, Cost-Per-Click (CPC), and AdWords Competition (CMP) data for keywords if this parameter is set to "true".falseNo
metrics_locationLocation, that you would like to localize the search volume to. Accepts up to 10 comma-separated location IDs. Location IDs can be found here.noneNo
metrics_languageLanguage, that you would like to localize the search volume to. Accepts up to 5 comma-separated language codes. Language codes can be found here.noneNo
metrics_networkSearch network that will be used to pull the search volume data.googlesearchnetworkNo
metrics_currencyThe currency that will be used to display cost-per-click (CPC) data.USDNo
typeType of search query. Available types are: "suggestions" and "questions".

If set to "questions", the seed keyword will be prepended with the words that typically start questions in English language e.g. "why", "when", "does" etc.
suggestionsNo
outputOutput of your API request.jsonNo

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

ValueЯзык
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
ValueЯзык
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 (中文 - 繁體)
ValueЯзык
deGerman (Deutsch)
enEnglish
esSpanish (Español)
frFrench (Français)
itItalian (Italiano)
jaJapanese (日本語)
nlDutch (Nederlands)
ptPortuguese (Português)
zhChinese (中国)
ValueЯзык
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 (中国)
ValueЯзык
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 "metrics_location" parameter

Введите одно или несколько местоположений по-английски.

Please note that maximum 10 locations are accepted in a single API request.


Supported values for "metrics_language" parameter

ValueЯзык
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)
msMalay (Bahasa Melayu)
nlDutch (Nederlands)
noNorwegian (Norsk)
plPolish (Polski)
ptPortuguese (Português)
roRomanian (Român)
ruRussian (Русский)
skSlovak (Slovenský)
slSlovenian (Slovenščina)
srSerbian (Cрпски)
svSwedish (Svenska)
thThai (ภาษาไทย)
tlFilipino (Tagalog)
trTurkish (Türk)
ukUkrainian (Українська)
urUrdu (اُردُو‎)
viVietnamese (Việt)
zh-CNChinese - Simplified (中国 - 简体)
zh-TWChinese - Traditional (中文 - 繁體)

Supported values for "metrics_network" parameter

ValueDescription
googlesearchGoogle
googlesearchnetworkGoogle и поисковые партнеры

Supported values for "metrics_currency" parameter

ValueВалюта
AEDUnited Arab Emirates Dirham
ARSArgentine Peso
AUDAustralian Dollars
BGNBulgarian Lev
BNDBrunei Dollar
BOBBolivian Boliviano
BRLBrazilian Real
CADCanadian Dollars
CHFSwiss Francs
CLPChilean Peso
CNYYuan Renminbi
COPColombian Peso
CZKCzech Koruna
DKKDenmark Kroner
EGPEgyptian Pound
EUREuros
FJDFiji Dollar
GBPBritish Pounds Sterling
HKDHong Kong Dollars
HRKCroatian Kuna
HUFHungarian Forint
IDRIndonesian Rupiah
ILSIsraeli Shekel
INRIndian Rupee
JPYJapanese Yen
KESKenyan Shilling
KRWSouth Korean Won
MADMoroccan Dirham
MXNMexico Peso
MYRMalaysian Ringgit
NOKNorway Kroner
NZDNew Zealand Dollars
PENPeruvian Nuevo Sol
PHPPhilippine Peso
PKRPakistan Rupee
PLNPolish New Zloty
RONRomanian Leu
RSDSerbian Dinar
RUBRussian Rouble
SARSaudi Riyal
SEKSweden Kronor
SGDSingapore Dollars
THBThai Baht
TRYTurkish Lira
TWDNew Taiwan Dollar
UAHUkrainian Hryvnia
USDUS Dollars
VEFVenezuela Bolivar Fuerte
VNDVietnamese Dong
ZARSouth African Rand

Supported values for "output" parameter

ValueOutput
jsonJSON
xmlXML


Responses

The table below shows the description of the values that can be found in API responses.

ValueDescription
stringA keyword that the search volume data is provided for.
volumeAverage monthly search volume for the last 12 months.
m1...m12Search volume on a given month.
cpcCost-Per-Click (CPC) for the keyword on Google AdWords.
cmpCompetition metric for the keyword on Google AdWords.
(m1...m12)_monthThe exact month number for the "m1" to "m12" values.
(m1...m12)_yearThe exact year for the "m1" to "m12" values.

Below you can see the sample responses from the API endpoints.

Request

http://api.keywordtool.io/v2/search/volume/google?apikey=[API_KEY]&keyword=["snowboarding","sunscreen"]&output=json

Response

{
  "results": {
    "snowboarding": {
      "string": "snowboarding",
      "volume": 1000000,
      "m1": 673000,
      "m2": 550000,
      "m3": 450000,
      "m4": 450000,
      "m5": 450000,
      "m6": 550000,
      "m7": 823000,
      "m8": 1500000,
      "m9": 2240000,
      "m10": 1830000,
      "m11": 1500000,
      "m12": 1000000,
      "cpc": 0.57,
      "cmp": 0.52,
      "m1_month": 9,
      "m1_year": 2016,
      "m2_month": 8,
      "m2_year": 2016,
      "m3_month": 7,
      "m3_year": 2016,
      "m4_month": 6,
      "m4_year": 2016,
      "m5_month": 5,
      "m5_year": 2016,
      "m6_month": 4,
      "m6_year": 2016,
      "m7_month": 3,
      "m7_year": 2016,
      "m8_month": 2,
      "m8_year": 2016,
      "m9_month": 1,
      "m9_year": 2016,
      "m10_month": 12,
      "m10_year": 2015,
      "m11_month": 11,
      "m11_year": 2015,
      "m12_month": 10,
      "m12_year": 2015
    },
    "sunscreen": {
      "string": "sunscreen",
      "volume": 368000,
      "m1": 201000,
      "m2": 368000,
      "m3": 673000,
      "m4": 823000,
      "m5": 673000,
      "m6": 450000,
      "m7": 301000,
      "m8": 201000,
      "m9": 165000,
      "m10": 135000,
      "m11": 135000,
      "m12": 135000,
      "cpc": 1.66,
      "cmp": 0.55,
      "m1_month": 9,
      "m1_year": 2016,
      "m2_month": 8,
      "m2_year": 2016,
      "m3_month": 7,
      "m3_year": 2016,
      "m4_month": 6,
      "m4_year": 2016,
      "m5_month": 5,
      "m5_year": 2016,
      "m6_month": 4,
      "m6_year": 2016,
      "m7_month": 3,
      "m7_year": 2016,
      "m8_month": 2,
      "m8_year": 2016,
      "m9_month": 1,
      "m9_year": 2016,
      "m10_month": 12,
      "m10_year": 2015,
      "m11_month": 11,
      "m11_year": 2015,
      "m12_month": 10,
      "m12_year": 2015
    }
  }
}

Request

http://api.keywordtool.io/v2/search/suggestions/google?apikey=[API_KEY]&keyword=how%20to&metrics=true&output=json

Response

{
  "results": {
    "": [
      {
        "string": "how to",
        "volume": 673000,
        "m1": 673000,
        "m2": 673000,
        "m3": 673000,
        "m4": 673000,
        "m5": 673000,
        "m6": 673000,
        "m7": 673000,
        "m8": 673000,
        "m9": 673000,
        "m10": 673000,
        "m11": 673000,
        "m12": 673000,
        "cpc": 0.54,
        "cmp": 0.01,
        "m1_month": 9,
        "m1_year": 2016,
        "m2_month": 8,
        "m2_year": 2016,
        "m3_month": 7,
        "m3_year": 2016,
        "m4_month": 6,
        "m4_year": 2016,
        "m5_month": 5,
        "m5_year": 2016,
        "m6_month": 4,
        "m6_year": 2016,
        "m7_month": 3,
        "m7_year": 2016,
        "m8_month": 2,
        "m8_year": 2016,
        "m9_month": 1,
        "m9_year": 2016,
        "m10_month": 12,
        "m10_year": 2015,
        "m11_month": 11,
        "m11_year": 2015,
        "m12_month": 10,
        "m12_year": 2015
      }
    ],
    "how to": [
      {
        "string": "how to tie a tie",
        "volume": 1000000,
        "m1": 823000,
        "m2": 673000,
        "m3": 673000,
        "m4": 1000000,
        "m5": 1830000,
        "m6": 1220000,
        "m7": 1000000,
        "m8": 1000000,
        "m9": 823000,
        "m10": 1000000,
        "m11": 823000,
        "m12": 1000000,
        "cpc": 0.83,
        "cmp": 0.01,
        "m1_month": 9,
        "m1_year": 2016,
        "m2_month": 8,
        "m2_year": 2016,
        "m3_month": 7,
        "m3_year": 2016,
        "m4_month": 6,
        "m4_year": 2016,
        "m5_month": 5,
        "m5_year": 2016,
        "m6_month": 4,
        "m6_year": 2016,
        "m7_month": 3,
        "m7_year": 2016,
        "m8_month": 2,
        "m8_year": 2016,
        "m9_month": 1,
        "m9_year": 2016,
        "m10_month": 12,
        "m10_year": 2015,
        "m11_month": 11,
        "m11_year": 2015,
        "m12_month": 10,
        "m12_year": 2015
      },
      {
        "string": "how to move to canada",
        "volume": 22200,
        "m1": 12100,
        "m2": 12100,
        "m3": 22200,
        "m4": 18100,
        "m5": 18100,
        "m6": 12100,
        "m7": 165000,
        "m8": 8100,
        "m9": 6600,
        "m10": 6600,
        "m11": 5400,
        "m12": 4400,
        "cpc": 2.11,
        "cmp": 0.22,
        "m1_month": 9,
        "m1_year": 2016,
        "m2_month": 8,
        "m2_year": 2016,
        "m3_month": 7,
        "m3_year": 2016,
        "m4_month": 6,
        "m4_year": 2016,
        "m5_month": 5,
        "m5_year": 2016,
        "m6_month": 4,
        "m6_year": 2016,
        "m7_month": 3,
        "m7_year": 2016,
        "m8_month": 2,
        "m8_year": 2016,
        "m9_month": 1,
        "m9_year": 2016,
        "m10_month": 12,
        "m10_year": 2015,
        "m11_month": 11,
        "m11_year": 2015,
        "m12_month": 10,
        "m12_year": 2015
      },
      {
        "string": "how to make slime",
        "volume": 246000,
        "m1": 450000,
        "m2": 368000,
        "m3": 368000,
        "m4": 368000,
        "m5": 201000,
        "m6": 201000,
        "m7": 368000,
        "m8": 246000,
        "m9": 90500,
        "m10": 74000,
        "m11": 74000,
        "m12": 74000,
        "cpc": 0.17,
        "cmp": 0.05,
        "m1_month": 9,
        "m1_year": 2016,
        "m2_month": 8,
        "m2_year": 2016,
        "m3_month": 7,
        "m3_year": 2016,
        "m4_month": 6,
        "m4_year": 2016,
        "m5_month": 5,
        "m5_year": 2016,
        "m6_month": 4,
        "m6_year": 2016,
        "m7_month": 3,
        "m7_year": 2016,
        "m8_month": 2,
        "m8_year": 2016,
        "m9_month": 1,
        "m9_year": 2016,
        "m10_month": 12,
        "m10_year": 2015,
        "m11_month": 11,
        "m11_year": 2015,
        "m12_month": 10,
        "m12_year": 2015
      },
      {
        "string": "how to impeach a president",
        "volume": 1900,
        "m1": 1600,
        "m2": 720,
        "m3": 1300,
        "m4": 1900,
        "m5": 1900,
        "m6": 1000,
        "m7": 1300,
        "m8": 480,
        "m9": 1000,
        "m10": 2400,
        "m11": 6600,
        "m12": 880,
        "cpc": 0.62,
        "cmp": 0.01,
        "m1_month": 9,
        "m1_year": 2016,
        "m2_month": 8,
        "m2_year": 2016,
        "m3_month": 7,
        "m3_year": 2016,
        "m4_month": 6,
        "m4_year": 2016,
        "m5_month": 5,
        "m5_year": 2016,
        "m6_month": 4,
        "m6_year": 2016,
        "m7_month": 3,
        "m7_year": 2016,
        "m8_month": 2,
        "m8_year": 2016,
        "m9_month": 1,
        "m9_year": 2016,
        "m10_month": 12,
        "m10_year": 2015,
        "m11_month": 11,
        "m11_year": 2015,
        "m12_month": 10,
        "m12_year": 2015
      },
      {
        "string": "how to screenshot on mac",
        "volume": 301000,
        "m1": 450000,
        "m2": 301000,
        "m3": 201000,
        "m4": 246000,
        "m5": 301000,
        "m6": 368000,
        "m7": 301000,
        "m8": 301000,
        "m9": 301000,
        "m10": 201000,
        "m11": 246000,
        "m12": 246000,
        "cpc": 0.15,
        "cmp": 0,
        "m1_month": 9,
        "m1_year": 2016,
        "m2_month": 8,
        "m2_year": 2016,
        "m3_month": 7,
        "m3_year": 2016,
        "m4_month": 6,
        "m4_year": 2016,
        "m5_month": 5,
        "m5_year": 2016,
        "m6_month": 4,
        "m6_year": 2016,
        "m7_month": 3,
        "m7_year": 2016,
        "m8_month": 2,
        "m8_year": 2016,
        "m9_month": 1,
        "m9_year": 2016,
        "m10_month": 12,
        "m10_year": 2015,
        "m11_month": 11,
        "m11_year": 2015,
        "m12_month": 10,
        "m12_year": 2015
      },
      {
        "string": "how to make",
        "volume": 301000,
        "m1": 368000,
        "m2": 301000,
        "m3": 301000,
        "m4": 246000,
        "m5": 246000,
        "m6": 246000,
        "m7": 246000,
        "m8": 246000,
        "m9": 246000,
        "m10": 246000,
        "m11": 301000,
        "m12": 301000,
        "cpc": 0.21,
        "cmp": 0.01,
        "m1_month": 9,
        "m1_year": 2016,
        "m2_month": 8,
        "m2_year": 2016,
        "m3_month": 7,
        "m3_year": 2016,
        "m4_month": 6,
        "m4_year": 2016,
        "m5_month": 5,
        "m5_year": 2016,
        "m6_month": 4,
        "m6_year": 2016,
        "m7_month": 3,
        "m7_year": 2016,
        "m8_month": 2,
        "m8_year": 2016,
        "m9_month": 1,
        "m9_year": 2016,
        "m10_month": 12,
        "m10_year": 2015,
        "m11_month": 11,
        "m11_year": 2015,
        "m12_month": 10,
        "m12_year": 2015
      },
      {
        "string": "how to play pokemon go",
        "volume": 368000,
        "m1": 301000,
        "m2": 823000,
        "m3": 3350000,
        "m4": 1000,
        "m5": 720,
        "m6": 590,
        "m7": 480,
        "m8": 260,
        "m9": 260,
        "m10": 170,
        "m11": 140,
        "m12": 210,
        "cpc": 0.54,
        "cmp": 0.05,
        "m1_month": 9,
        "m1_year": 2016,
        "m2_month": 8,
        "m2_year": 2016,
        "m3_month": 7,
        "m3_year": 2016,
        "m4_month": 6,
        "m4_year": 2016,
        "m5_month": 5,
        "m5_year": 2016,
        "m6_month": 4,
        "m6_year": 2016,
        "m7_month": 3,
        "m7_year": 2016,
        "m8_month": 2,
        "m8_year": 2016,
        "m9_month": 1,
        "m9_year": 2016,
        "m10_month": 12,
        "m10_year": 2015,
        "m11_month": 11,
        "m11_year": 2015,
        "m12_month": 10,
        "m12_year": 2015
      },
      {
        "string": "how to register to vote",
        "volume": 1000000,
        "m1": 11100000,
        "m2": 60500,
        "m3": 49500,
        "m4": 49500,
        "m5": 40500,
        "m6": 40500,
        "m7": 110000,
        "m8": 90500,
        "m9": 40500,
        "m10": 18100,
        "m11": 18100,
        "m12": 33100,
        "cpc": 2.01,
        "cmp": 0.08,
        "m1_month": 9,
        "m1_year": 2016,
        "m2_month": 8,
        "m2_year": 2016,
        "m3_month": 7,
        "m3_year": 2016,
        "m4_month": 6,
        "m4_year": 2016,
        "m5_month": 5,
        "m5_year": 2016,
        "m6_month": 4,
        "m6_year": 2016,
        "m7_month": 3,
        "m7_year": 2016,
        "m8_month": 2,
        "m8_year": 2016,
        "m9_month": 1,
        "m9_year": 2016,
        "m10_month": 12,
        "m10_year": 2015,
        "m11_month": 11,
        "m11_year": 2015,
        "m12_month": 10,
        "m12_year": 2015
      },
      {
        "string": "how to be single",
        "volume": 1220000,
        "m1": 450000,
        "m2": 673000,
        "m3": 1000000,
        "m4": 1220000,
        "m5": 2240000,
        "m6": 1830000,
        "m7": 2240000,
        "m8": 5000000,
        "m9": 368000,
        "m10": 90500,
        "m11": 135000,
        "m12": 14800,
        "cpc": 0.66,
        "cmp": 0.01,
        "m1_month": 9,
        "m1_year": 2016,
        "m2_month": 8,
        "m2_year": 2016,
        "m3_month": 7,
        "m3_year": 2016,
        "m4_month": 6,
        "m4_year": 2016,
        "m5_month": 5,
        "m5_year": 2016,
        "m6_month": 4,
        "m6_year": 2016,
        "m7_month": 3,
        "m7_year": 2016,
        "m8_month": 2,
        "m8_year": 2016,
        "m9_month": 1,
        "m9_year": 2016,
        "m10_month": 12,
        "m10_year": 2015,
        "m11_month": 11,
        "m11_year": 2015,
        "m12_month": 10,
        "m12_year": 2015
      },
      {
        "string": "how to write a check",
        "volume": 165000,
        "m1": 201000,
        "m2": 201000,
        "m3": 165000,
        "m4": 165000,
        "m5": 165000,
        "m6": 165000,
        "m7": 165000,
        "m8": 165000,
        "m9": 165000,
        "m10": 135000,
        "m11": 135000,
        "m12": 135000,
        "cpc": 4.21,
        "cmp": 0.01,
        "m1_month": 9,
        "m1_year": 2016,
        "m2_month": 8,
        "m2_year": 2016,
        "m3_month": 7,
        "m3_year": 2016,
        "m4_month": 6,
        "m4_year": 2016,
        "m5_month": 5,
        "m5_year": 2016,
        "m6_month": 4,
        "m6_year": 2016,
        "m7_month": 3,
        "m7_year": 2016,
        "m8_month": 2,
        "m8_year": 2016,
        "m9_month": 1,
        "m9_year": 2016,
        "m10_month": 12,
        "m10_year": 2015,
        "m11_month": 11,
        "m11_year": 2015,
        "m12_month": 10,
        "m12_year": 2015
      },
      {
        "string": "how to boil eggs",
        "volume": 201000,
        "m1": 165000,
        "m2": 165000,
        "m3": 165000,
        "m4": 201000,
        "m5": 165000,
        "m6": 165000,
        "m7": 450000,
        "m8": 165000,
        "m9": 201000,
        "m10": 165000,
        "m11": 165000,
        "m12": 165000,
        "cpc": 0.21,
        "cmp": 0.11,
        "m1_month": 9,
        "m1_year": 2016,
        "m2_month": 8,
        "m2_year": 2016,
        "m3_month": 7,
        "m3_year": 2016,
        "m4_month": 6,
        "m4_year": 2016,
        "m5_month": 5,
        "m5_year": 2016,
        "m6_month": 4,
        "m6_year": 2016,
        "m7_month": 3,
        "m7_year": 2016,
        "m8_month": 2,
        "m8_year": 2016,
        "m9_month": 1,
        "m9_year": 2016,
        "m10_month": 12,
        "m10_year": 2015,
        "m11_month": 11,
        "m11_year": 2015,
        "m12_month": 10,
        "m12_year": 2015
      },
      {
        "string": "how to draw",
        "volume": 550000,
        "m1": 550000,
        "m2": 550000,
        "m3": 550000,
        "m4": 550000,
        "m5": 550000,
        "m6": 450000,
        "m7": 550000,
        "m8": 550000,
        "m9": 550000,
        "m10": 550000,
        "m11": 550000,
        "m12": 450000,
        "cpc": 0.95,
        "cmp": 0.03,
        "m1_month": 9,
        "m1_year": 2016,
        "m2_month": 8,
        "m2_year": 2016,
        "m3_month": 7,
        "m3_year": 2016,
        "m4_month": 6,
        "m4_year": 2016,
        "m5_month": 5,
        "m5_year": 2016,
        "m6_month": 4,
        "m6_year": 2016,
        "m7_month": 3,
        "m7_year": 2016,
        "m8_month": 2,
        "m8_year": 2016,
        "m9_month": 1,
        "m9_year": 2016,
        "m10_month": 12,
        "m10_year": 2015,
        "m11_month": 11,
        "m11_year": 2015,
        "m12_month": 10,
        "m12_year": 2015
      },
      {
        "string": "how to make french toast",
        "volume": 201000,
        "m1": 165000,
        "m2": 201000,
        "m3": 201000,
        "m4": 201000,
        "m5": 201000,
        "m6": 165000,
        "m7": 201000,
        "m8": 201000,
        "m9": 246000,
        "m10": 165000,
        "m11": 165000,
        "m12": 165000,
        "cpc": 0.36,
        "cmp": 0.11,
        "m1_month": 9,
        "m1_year": 2016,
        "m2_month": 8,
        "m2_year": 2016,
        "m3_month": 7,
        "m3_year": 2016,
        "m4_month": 6,
        "m4_year": 2016,
        "m5_month": 5,
        "m5_year": 2016,
        "m6_month": 4,
        "m6_year": 2016,
        "m7_month": 3,
        "m7_year": 2016,
        "m8_month": 2,
        "m8_year": 2016,
        "m9_month": 1,
        "m9_year": 2016,
        "m10_month": 12,
        "m10_year": 2015,
        "m11_month": 11,
        "m11_year": 2015,
        "m12_month": 10,
        "m12_year": 2015
      },
      {
        "string": "how to train your dragon",
        "volume": 550000,
        "m1": 450000,
        "m2": 450000,
        "m3": 550000,
        "m4": 550000,
        "m5": 550000,
        "m6": 450000,
        "m7": 550000,
        "m8": 550000,
        "m9": 550000,
        "m10": 550000,
        "m11": 550000,
        "m12": 450000,
        "cpc": 0.42,
        "cmp": 0.05,
        "m1_month": 9,
        "m1_year": 2016,
        "m2_month": 8,
        "m2_year": 2016,
        "m3_month": 7,
        "m3_year": 2016,
        "m4_month": 6,
        "m4_year": 2016,
        "m5_month": 5,
        "m5_year": 2016,
        "m6_month": 4,
        "m6_year": 2016,
        "m7_month": 3,
        "m7_year": 2016,
        "m8_month": 2,
        "m8_year": 2016,
        "m9_month": 1,
        "m9_year": 2016,
        "m10_month": 12,
        "m10_year": 2015,
        "m11_month": 11,
        "m11_year": 2015,
        "m12_month": 10,
        "m12_year": 2015
      },
      {
        "string": "how to lose weight",
        "volume": 550000,
        "m1": 550000,
        "m2": 450000,
        "m3": 368000,
        "m4": 550000,
        "m5": 673000,
        "m6": 673000,
        "m7": 450000,
        "m8": 368000,
        "m9": 673000,
        "m10": 550000,
        "m11": 550000,
        "m12": 368000,
        "cpc": 0.52,
        "cmp": 0.22,
        "m1_month": 9,
        "m1_year": 2016,
        "m2_month": 8,
        "m2_year": 2016,
        "m3_month": 7,
        "m3_year": 2016,
        "m4_month": 6,
        "m4_year": 2016,
        "m5_month": 5,
        "m5_year": 2016,
        "m6_month": 4,
        "m6_year": 2016,
        "m7_month": 3,
        "m7_year": 2016,
        "m8_month": 2,
        "m8_year": 2016,
        "m9_month": 1,
        "m9_year": 2016,
        "m10_month": 12,
        "m10_year": 2015,
        "m11_month": 11,
        "m11_year": 2015,
        "m12_month": 10,
        "m12_year": 2015
      },
      {
        "string": "how to make money",
        "volume": 301000,
        "m1": 246000,
        "m2": 301000,
        "m3": 301000,
        "m4": 301000,
        "m5": 301000,
        "m6": 246000,
        "m7": 301000,
        "m8": 301000,
        "m9": 368000,
        "m10": 301000,
        "m11": 301000,
        "m12": 301000,
        "cpc": 1.48,
        "cmp": 0.55,
        "m1_month": 9,
        "m1_year": 2016,
        "m2_month": 8,
        "m2_year": 2016,
        "m3_month": 7,
        "m3_year": 2016,
        "m4_month": 6,
        "m4_year": 2016,
        "m5_month": 5,
        "m5_year": 2016,
        "m6_month": 4,
        "m6_year": 2016,
        "m7_month": 3,
        "m7_year": 2016,
        "m8_month": 2,
        "m8_year": 2016,
        "m9_month": 1,
        "m9_year": 2016,
        "m10_month": 12,
        "m10_year": 2015,
        "m11_month": 11,
        "m11_year": 2015,
        "m12_month": 10,
        "m12_year": 2015
      },
      {
        "string": "how to get rid of fleas",
        "volume": 90500,
        "m1": 165000,
        "m2": 165000,
        "m3": 135000,
        "m4": 110000,
        "m5": 74000,
        "m6": 49500,
        "m7": 40500,
        "m8": 33100,
        "m9": 49500,
        "m10": 74000,
        "m11": 110000,
        "m12": 135000,
        "cpc": 2.02,
        "cmp": 0.43,
        "m1_month": 9,
        "m1_year": 2016,
        "m2_month": 8,
        "m2_year": 2016,
        "m3_month": 7,
        "m3_year": 2016,
        "m4_month": 6,
        "m4_year": 2016,
        "m5_month": 5,
        "m5_year": 2016,
        "m6_month": 4,
        "m6_year": 2016,
        "m7_month": 3,
        "m7_year": 2016,
        "m8_month": 2,
        "m8_year": 2016,
        "m9_month": 1,
        "m9_year": 2016,
        "m10_month": 12,
        "m10_year": 2015,
        "m11_month": 11,
        "m11_year": 2015,
        "m12_month": 10,
        "m12_year": 2015
      },
      {
        "string": "how to draw a rose",
        "volume": 246000,
        "m1": 246000,
        "m2": 246000,
        "m3": 246000,
        "m4": 246000,
        "m5": 368000,
        "m6": 246000,
        "m7": 246000,
        "m8": 246000,
        "m9": 246000,
        "m10": 246000,
        "m11": 201000,
        "m12": 201000,
        "cpc": 0.8,
        "cmp": 0.01,
        "m1_month": 9,
        "m1_year": 2016,
        "m2_month": 8,
        "m2_year": 2016,
        "m3_month": 7,
        "m3_year": 2016,
        "m4_month": 6,
        "m4_year": 2016,
        "m5_month": 5,
        "m5_year": 2016,
        "m6_month": 4,
        "m6_year": 2016,
        "m7_month": 3,
        "m7_year": 2016,
        "m8_month": 2,
        "m8_year": 2016,
        "m9_month": 1,
        "m9_year": 2016,
        "m10_month": 12,
        "m10_year": 2015,
        "m11_month": 11,
        "m11_year": 2015,
        "m12_month": 10,
        "m12_year": 2015
      },
      {
        "string": "how to write a cover letter",
        "volume": 165000,
        "m1": 165000,
        "m2": 165000,
        "m3": 135000,
        "m4": 135000,
        "m5": 165000,
        "m6": 165000,
        "m7": 165000,
        "m8": 165000,
        "m9": 201000,
        "m10": 110000,
        "m11": 135000,
        "m12": 165000,
        "cpc": 0.52,
        "cmp": 0.16,
        "m1_month": 9,
        "m1_year": 2016,
        "m2_month": 8,
        "m2_year": 2016,
        "m3_month": 7,
        "m3_year": 2016,
        "m4_month": 6,
        "m4_year": 2016,
        "m5_month": 5,
        "m5_year": 2016,
        "m6_month": 4,
        "m6_year": 2016,
        "m7_month": 3,
        "m7_year": 2016,
        "m8_month": 2,
        "m8_year": 2016,
        "m9_month": 1,
        "m9_year": 2016,
        "m10_month": 12,
        "m10_year": 2015,
        "m11_month": 11,
        "m11_year": 2015,
        "m12_month": 10,
        "m12_year": 2015
      },
      {
        "string": "how to get rid of ants",
        "volume": 90500,
        "m1": 74000,
        "m2": 135000,
        "m3": 165000,
        "m4": 135000,
        "m5": 135000,
        "m6": 110000,
        "m7": 60500,
        "m8": 33100,
        "m9": 33100,
        "m10": 27100,
        "m11": 27100,
        "m12": 49500,
        "cpc": 3.36,
        "cmp": 0.19,
        "m1_month": 9,
        "m1_year": 2016,
        "m2_month": 8,
        "m2_year": 2016,
        "m3_month": 7,
        "m3_year": 2016,
        "m4_month": 6,
        "m4_year": 2016,
        "m5_month": 5,
        "m5_year": 2016,
        "m6_month": 4,
        "m6_year": 2016,
        "m7_month": 3,
        "m7_year": 2016,
        "m8_month": 2,
        "m8_year": 2016,
        "m9_month": 1,
        "m9_year": 2016,
        "m10_month": 12,
        "m10_year": 2015,
        "m11_month": 11,
        "m11_year": 2015,
        "m12_month": 10,
        "m12_year": 2015
      }
    ],
    ...
  }
}

General Error

{
  "error": {
    "message": "The API key provided is invalid.",
    "code": 5
  },
  "results": []
}

Incomplete Results

{
  "notice": {
    "message": "Search results could be incomplete, please try again later. This request was not counted against your quota.",
    "code": 10
  },
  "results": {
    "snowboarding": {
      "string": "snowboarding",
      "volume": 1000000,
      "m1": 673000,
      "m2": 550000,
      "m3": 450000,
      "m4": 450000,
      "m5": 450000,
      "m6": 550000,
      "m7": 823000,
      "m8": 1500000,
      "m9": 2240000,
      "m10": 1830000,
      "m11": 1500000,
      "m12": 1000000,
      "cpc": 0.57,
      "cmp": 0.52,
      "m1_month": 9,
      "m1_year": 2016,
      "m2_month": 8,
      "m2_year": 2016,
      "m3_month": 7,
      "m3_year": 2016,
      "m4_month": 6,
      "m4_year": 2016,
      "m5_month": 5,
      "m5_year": 2016,
      "m6_month": 4,
      "m6_year": 2016,
      "m7_month": 3,
      "m7_year": 2016,
      "m8_month": 2,
      "m8_year": 2016,
      "m9_month": 1,
      "m9_year": 2016,
      "m10_month": 12,
      "m10_year": 2015,
      "m11_month": 11,
      "m11_year": 2015,
      "m12_month": 10,
      "m12_year": 2015
    },
    "sunscreen": {
      "string": "sunscreen",
      "volume": null,
      "m1": null,
      "m2": null,
      "m3": null,
      "m4": null,
      "m5": null,
      "m6": null,
      "m7": null,
      "m8": null,
      "m9": null,
      "m10": null,
      "m11": null,
      "m12": null,
      "cpc": null,
      "cmp": null,
      "m1_month": 9,
      "m1_year": 2016,
      "m2_month": 8,
      "m2_year": 2016,
      "m3_month": 7,
      "m3_year": 2016,
      "m4_month": 6,
      "m4_year": 2016,
      "m5_month": 5,
      "m5_year": 2016,
      "m6_month": 4,
      "m6_year": 2016,
      "m7_month": 3,
      "m7_year": 2016,
      "m8_month": 2,
      "m8_year": 2016,
      "m9_month": 1,
      "m9_year": 2016,
      "m10_month": 12,
      "m10_year": 2015,
      "m11_month": 11,
      "m11_year": 2015,
      "m12_month": 10,
      "m12_year": 2015
    }
  }
}


Examples

http://api.keywordtool.io/v2/search/volume/google?apikey=[API_KEY]&keyword=["apple","samsung"]&metrics_location=2840&metrics_language=en&metrics_network=googlesearchnetwork&metrics_currency=USD&output=json
curl -s "http://api.keywordtool.io/v2/search/volume/google?apikey=[API_KEY]&keyword=\[\"apple\",\"samsung\"\]&metrics_location=2840&metrics_language=en&metrics_network=googlesearchnetwork&metrics_currency=USD&output=json"
<?php

$apikey = '[API_KEY]';

$params = array(
  'apikey' => $apikey,
  'keyword' => json_encode(array('apple', 'samsung')),
  'metrics_location' => '2840',
  'metrics_language' => 'en',
  'metrics_network' => 'googlesearchnetwork',
  'metrics_currency' => 'USD',
  'output' => 'json',
);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'http://api.keywordtool.io/v2/search/volume/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/v2/search/volume/google?apikey=[API_KEY]&keyword=["apple","samsung"]&metrics_location=2840&metrics_language=en&metrics_network=googlesearchnetwork&metrics_currency=USD&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/v2/search/volume/google?apikey=[API_KEY]&keyword=["apple","samsung"]&metrics_location=2840&metrics_language=en&metrics_network=googlesearchnetwork&metrics_currency=USD&output=json', function(error, response, body) {
  if (!error && response.statusCode == 200) {
    data = JSON.parse(body);
    console.log(dump(data));
  }
});
http://api.keywordtool.io/v2/search/suggestions/google?apikey=[API_KEY]&keyword=apple&country=us&language=en&metrics=true&metrics_location=2840&metrics_language=en&metrics_network=googlesearchnetwork&metrics_currency=USD&output=json
curl -s "http://api.keywordtool.io/v2/search/suggestions/google?apikey=[API_KEY]&keyword=apple&country=us&language=en&metrics=true&metrics_location=2840&metrics_language=en&metrics_network=googlesearchnetwork&metrics_currency=USD&output=json"
<?php

$apikey = '[API_KEY]';

$params = array(
  'apikey' => $apikey,
  'keyword' => 'apple',
  'country' => 'us',
  'language' => 'en',
  'metrics' => 'true',
  'metrics_location' => '2840',
  'metrics_language' => 'en',
  'metrics_network' => 'googlesearchnetwork',
  'metrics_currency' => 'USD',
  'output' => 'json',
);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'http://api.keywordtool.io/v2/search/suggestions/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/v2/search/suggestions/google?apikey=[API_KEY]&keyword=apple&country=us&language=en&metrics=true&metrics_location=2840&metrics_language=en&metrics_network=googlesearchnetwork&metrics_currency=USD&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/v2/search/suggestions/google?apikey=[API_KEY]&keyword=apple&country=us&language=en&metrics=true&metrics_location=2840&metrics_language=en&metrics_network=googlesearchnetwork&metrics_currency=USD&output=json', function(error, response, body) {
  if (!error && response.statusCode == 200) {
    data = JSON.parse(body);
    console.log(dump(data));
  }
});


Лимиты

All Keyword Tool API subscriptions are limited to 10 API requests per minute, the number of API requests that you can make per day depends on the Keyword Tool API plan that you are subscribed to. Every API request that is made is counted towards the daily quota.

If your use case requires custom API limits, please contact us and will get back to you as soon as possible.

API PlusAPI BasicAPI Lite
Количество API запросов в день 1800400100

1 Daily limits are calculated within the 24 hour timeframe window.



Error Codes

Error CodeDescriptionHTTP Code
0API general error. Please contact support.404
#-0Мы не можем обработать ваш запрос прямо сейчас, пожалуйста, попробуйте позже.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
11Please choose a search mode ("suggestions", or "volume"), e.g. "http://api.keywordtool.io/v2/search/[mode]/[provider]".404
12Please choose a search provider, e.g. "http://api.keywordtool.io/v2/search/[mode]/[provider]".404
13Provider is not supported for search volume mode.404
14Location is invalid.404
15Language is invalid.404
16Network is invalid.404
17Currency is invalid.404
18You can only select up to 10 locations.404
19You can only select up to 5 languages.404
20You cannot send more than 800 keywords in a request.404