Keyword Tool API Documentation


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 43,007 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:

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

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

Search Engine Endpoint
Google https://api.keywordtool.io/v2/search/suggestions/google
YouTube https://api.keywordtool.io/v2/search/suggestions/youtube
Bing https://api.keywordtool.io/v2/search/suggestions/bing
Amazon https://api.keywordtool.io/v2/search/suggestions/amazon
eBay https://api.keywordtool.io/v2/search/suggestions/ebay
App Store https://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.

Parameter Description Default value Required
apikey Your key to access API. none Yes
keyword Keywords 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"] none Yes
metrics_location Location, that you would like to localize the search volume to. Accepts up to 10 comma-separated location IDs. Location IDs can be found here. none No
metrics_language Language, that you would like to localize the search volume to. Accepts up to 5 comma-separated language codes. Language codes can be found here. none No
metrics_network Search network that will be used to pull the search volume data. googlesearchnetwork No
metrics_currency The currency that will be used to display cost-per-click (CPC) data. USD No
output Output of your API request. json No
complete Allows 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". false No

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

Parameter Description Default value Required
apikey Your key to access API. none Yes
keyword Seed keyword that will be used to generate suggestions. Only 1 keyword is accepted in plain text format. none Yes
exclude Use 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.
none No
country A country, you want to get keyword suggestions for. Only a single value is accepted. us No
language Language, you want to get keyword suggestions for. Only a single value is accepted. en No
metrics Allows to get Google Search Volume, Cost-Per-Click (CPC), and AdWords Competition (CMP) data for keywords if this parameter is set to "true". false No
metrics_location Location, that you would like to localize the search volume to. Accepts up to 10 comma-separated location IDs. Location IDs can be found here. none No
metrics_language Language, that you would like to localize the search volume to. Accepts up to 5 comma-separated language codes. Language codes can be found here. none No
metrics_network Search network that will be used to pull the search volume data. googlesearchnetwork No
metrics_currency The currency that will be used to display cost-per-click (CPC) data. USD No
type Type 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.
suggestions No
output Output of your API request. json No

Supported values for "country" parameter

Value Country
af Afghanistan (google.com.af)
al Albania (google.al)
dz Algeria (google.dz)
as American Samoa (google.as)
ad Andorra (google.ad)
ao Angola (google.co.ao)
ai Anguilla (google.com.ai)
ag Antigua and Barbuda (google.com.ag)
ar Argentina (google.com.ar)
am Armenia (google.am)
au Australia (google.com.au)
at Austria (google.at)
az Azerbaijan (google.az)
bs Bahamas (google.bs)
bh Bahrain (google.com.bh)
bd Bangladesh (google.com.bd)
by Belarus (google.by)
be Belgium (google.be)
bz Belize (google.com.bz)
bj Benin (google.bj)
bt Bhutan (google.bt)
bo Bolivia (google.com.bo)
ba Bosnia and Herzegovina (google.ba)
bw Botswana (google.co.bw)
br Brazil (google.com.br)
vg British Virgin Islands (google.vg)
bn Brunei (google.com.bn)
bg Bulgaria (google.bg)
bf Burkina Faso (google.bf)
bi Burundi (google.bi)
kh Cambodia (google.com.kh)
cm Cameroon (google.cm)
ca Canada (google.ca)
cv Cape Verde (google.cv)
cat Catalan Countries (google.cat)
cf Central African Republic (google.cf)
td Chad (google.td)
cl Chile (google.cl)
co Colombia (google.com.co)
ck Cook Islands (google.co.ck)
cr Costa Rica (google.co.cr)
hr Croatia (google.hr)
cu Cuba (google.com.cu)
cy Cyprus (google.com.cy)
cz Czech Republic (google.cz)
cd Democratic Republic of the Congo (google.cd)
dk Denmark (google.dk)
dj Djibouti (google.dj)
dm Dominica (google.dm)
do Dominican Republic (google.com.do)
ec Ecuador (google.com.ec)
eg Egypt (google.com.eg)
sv El Salvador (google.com.sv)
ee Estonia (google.ee)
et Ethiopia (google.com.et)
fm Federated States of Micronesia (google.fm)
fj Fiji (google.com.fj)
fi Finland (google.fi)
fr France (google.fr)
ga Gabon (google.ga)
gm Gambia (google.gm)
ge Georgia (google.ge)
de Germany (google.de)
gh Ghana (google.com.gh)
gi Gibraltar (google.com.gi)
gr Greece (google.gr)
gl Greenland (google.gl)
gp Guadeloupe (google.gp)
gt Guatemala (google.com.gt)
gg Guernsey (google.gg)
gy Guyana (google.gy)
ht Haiti (google.ht)
hn Honduras (google.hn)
hk Hong Kong (google.com.hk)
hu Hungary (google.hu)
is Iceland (google.is)
in India (google.co.in)
id Indonesia (google.co.id)
iq Iraq (google.iq)
ie Ireland (google.ie)
im Isle of Man (google.im)
il Israel (google.co.il)
it Italy (google.it)
ci Ivory Coast (google.ci)
jm Jamaica (google.com.jm)
jp Japan (google.co.jp)
je Jersey (google.je)
jo Jordan (google.jo)
kz Kazakhstan (google.kz)
ke Kenya (google.co.ke)
ki Kiribati (google.ki)
kw Kuwait (google.com.kw)
kg Kyrgyzstan (google.kg)
la Laos (google.la)
lv Latvia (google.lv)
lb Lebanon (google.com.lb)
ls Lesotho (google.co.ls)
ly Libya (google.com.ly)
li Liechtenstein (google.li)
lt Lithuania (google.lt)
lu Luxembourg (google.lu)
mk Macedonia (google.mk)
mg Madagascar (google.mg)
mw Malawi (google.mw)
my Malaysia (google.com.my)
mv Maldives (google.mv)
ml Mali (google.ml)
mt Malta (google.com.mt)
mu Mauritius (google.mu)
mx Mexico (google.com.mx)
md Moldova (google.md)
mn Mongolia (google.mn)
me Montenegro (google.me)
ms Montserrat (google.ms)
ma Morocco (google.co.ma)
mz Mozambique (google.co.mz)
mm Myanmar (google.com.mm)
na Namibia (google.com.na)
nr Nauru (google.nr)
np Nepal (google.com.np)
nl Netherlands (google.nl)
nz New Zealand (google.co.nz)
ni Nicaragua (google.com.ni)
ne Niger (google.ne)
ng Nigeria (google.com.ng)
nu Niue (google.nu)
nf Norfolk Island (google.com.nf)
no Norway (google.no)
om Oman (google.com.om)
pk Pakistan (google.com.pk)
ps Palestine (google.ps)
pa Panama (google.com.pa)
pg Papua New Guinea (google.com.pg)
py Paraguay (google.com.py)
pe Peru (google.com.pe)
ph Philippines (google.com.ph)
pn Pitcairn Islands (google.pn)
pl Poland (google.pl)
pt Portugal (google.pt)
pr Puerto Rico (google.com.pr)
qa Qatar (google.com.qa)
cg Republic of the Congo (google.cg)
ro Romania (google.ro)
ru Russia (google.ru)
rw Rwanda (google.rw)
sh Saint Helena, Ascension and Tristan da Cunha (google.sh)
vc Saint Vincent and the Grenadines (google.com.vc)
ws Samoa (google.ws)
sm San Marino (google.sm)
sa Saudi Arabia (google.com.sa)
sn Senegal (google.sn)
rs Serbia (google.rs)
sc Seychelles (google.sc)
sl Sierra Leone (google.com.sl)
sg Singapore (google.com.sg)
sk Slovakia (google.sk)
si Slovenia (google.si)
sb Solomon Islands (google.com.sb)
so Somalia (google.so)
za South Africa (google.co.za)
kr South Korea (google.co.kr)
es Spain (google.es)
lk Sri Lanka (google.lk)
sr Suriname (google.sr)
se Sweden (google.se)
ch Switzerland (google.ch)
st São Tomé and Príncipe (google.st)
tw Taiwan (google.com.tw)
tj Tajikistan (google.com.tj)
tz Tanzania (google.co.tz)
th Thailand (google.co.th)
tl Timor-Leste (google.tl)
tg Togo (google.tg)
tk Tokelau (google.tk)
to Tonga (google.to)
tt Trinidad and Tobago (google.tt)
tn Tunisia (google.tn)
tr Turkey (google.com.tr)
tm Turkmenistan (google.tm)
ug Uganda (google.co.ug)
ua Ukraine (google.com.ua)
ae United Arab Emirates (google.ae)
uk United Kingdom (google.co.uk)
us United States (google.com)
vi United States Virgin Islands (google.co.vi)
uy Uruguay (google.com.uy)
uz Uzbekistan (google.co.uz)
vu Vanuatu (google.vu)
ve Venezuela (google.co.ve)
vn Vietnam (google.com.vn)
zm Zambia (google.co.zm)
zw Zimbabwe (google.co.zw)
Value Country
af Afghanistan (افغانستان)
dz Algeria (الجزائر)
as American Samoa (Amerika Sāmoa)
ad Andorra
ao Angola
ai Anguilla
aq Antarctica
ag Antigua and Barbuda
ar Argentina
am Armenia (Hayastán)
aw Aruba
au Australia
at Austria (Österreich)
az Azerbaijan (Azərbaycan)
bs Bahamas
bh Bahrain (البحرين)
bd Bangladesh (বাংলাদেশ)
bb Barbados
by Belarus (Беларусь)
be Belgium (België)
bz Belize
bj Benin (Bénin)
bm Bermuda
bt Bhutan (འབྲུག་ཡུལ)
bo Bolivia
ba Bosnia and Herzegovina (Bosna i Hercegovina)
bw Botswana
bv Bouvet Island
br Brazil (Brasil)
io British Indian Ocean Territory
vg British Virgin Islands
bn Brunei (بروني)
bg Bulgaria
bf Burkina Faso
bi Burundi
kh Cambodia (Kampuchea)
cm Cameroon (Cameroun)
ca Canada
cv Cape Verde (Cabo Verde)
ky Cayman Islands
cf Central African Republic (République Centrafricaine)
td Chad (Tchad)
cl Chile
cx Christmas Island
cc Cocos (Keeling) Islands
co Colombia
km Comoros (جزر القمر)
cg Congo
cd Congo - Democratic Republic of
ck Cook Islands
cr Costa Rica
ci Cote d'Ivoire
hr Croatia (Hrvatska)
cy Cyprus (Kypros)
cz Czech Republic (Česká Republika)
dk Denmark (Danmark)
dj Djibouti (جيبوتي)
dm Dominica
do Dominican Republic (República Dominicana)
tl Timor-Leste
ec Ecuador
eg Egypt (مصر)
sv El Salvador
gq Equatorial Guinea (Guinea Ecuatorial)
er Eritrea (إرتريا)
ee Estonia (Eesti)
et Ethiopia (Ityop'ia)
fk Falkland Islands (Islas Malvinas)
fo Faroe Islands (Føroyar)
fj Fiji
fi Finland (Suomi)
fr France
gf French Guiana (Guyane)
pf French Polynesia (Polynésie Française)
tf French Southern Territories
ga Gabon
gm Gambia
ge Georgia (Sak'art'velo)
de Germany (Deutschland)
gh Ghana
gi Gibraltar
gr Greece (Hellas)
gl Greenland (Kalaallit Nunaat)
gd Grenada
gp Guadeloupe
gu Guam (Guåhån)
gt Guatemala
gn Guinea (Guinée)
gw Guinea-Bissau (Guiné-Bissau)
gy Guyana
ht Haiti (Haïti)
hm Heard Island and McDonald Islands
va Holy See (Vatican City State) (Città del Vaticano)
hn Honduras
hk Hong Kong (香港)
hu Hungary (Magyarország)
is Iceland (Ísland)
in India
id Indonesia
iq Iraq
ie Ireland (Éire)
il Israel (إسرائيل)
it Italy (Italia)
jm Jamaica
jp Japan (日本)
jo Jordan (الأردن)
kz Kazakhstan (Қазақстан)
ke Kenya
ki Kiribati
kw Kuwait (الكويت)
kg Kyrgyzstan (Кыргызстан)
la Laos (Lao)
lv Latvia (Latvija)
lb Lebanon (لبنان)
ls Lesotho
lr Liberia
ly Libya
li Liechtenstein
lt Lithuania (Lietuva)
lu Luxembourg (Lëtzebuerg)
mo Macao
mk Macedonia (Makedonija)
mg Madagascar (Madagasikara)
mw Malawi
my Malaysia
mv Maldives (Dhivehi Raajje)
ml Mali
mt Malta
mh Marshall Islands
mq Martinique
mr Mauritania (Muritan)
mu Mauritius (Maurice)
yt Mayotte
mx Mexico (México)
fm Micronesia - Federated States of
md Moldova
mc Monaco
mn Mongolia (Mongol Uls)
ms Montserrat
ma Morocco (Amerruk)
mz Mozambique (Moçambique)
na Namibia
nr Nauru
np Nepal (Nepāla)
nl Netherlands (Nederland)
nc New Caledonia (Nouvelle-Calédonie)
nz New Zealand
ni Nicaragua
ne Niger
ng Nigeria
nu Niue
nf Norfolk Island
mp Northern Mariana Islands
no Norway (Norge)
om Oman (عُمان)
pk Pakistan (پاکستان)
pw Palau (Belau)
pa Panama (Panamá)
pg Papua New Guinea
py Paraguay
pe Peru (Perú)
ph Philippines (Pilipinas)
pn Pitcairn
pl Poland (Polska)
pt Portugal
pr Puerto Rico
qa Qatar (قطر)
re Reunion (Réunion)
ro Romania (România)
ru Russia (Россия)
rw Rwanda
kn Saint Kitts and Nevis
lc Saint Lucia
vc Saint Vincent and the Grenadines
ws Samoa
sm San Marino
st Sao Tome and Principe (São Tomé e Príncipe)
sa Saudi Arabia (المملكة العربية السعودية)
sn Senegal (Sénégal)
sc Seychelles (Sesel)
sl Sierra Leone
sg Singapore
sk Slovakia (Slovensko)
si Slovenia (Slovenija)
sb Solomon Islands
so Somalia (Soomaaliya)
za South Africa (Suid-Afrika)
gs South Georgia and the South Sandwich Islands
kr South Korea (한국)
es Spain (España)
lk Sri Lanka (Sri Lankā)
sh Saint Helena
pm Saint Pierre and Miquelon
sr Suriname
sj Svalbard and Jan Mayen
sz Swaziland
se Sweden (Sverige)
ch Switzerland (Schweiz)
tw Taiwan (中華民國)
tj Tajikistan (Тоҷикистон)
tz Tanzania
th Thailand (ประเทศไทย)
tg Togo
tk Tokelau
to Tonga
tt Trinidad and Tobago
tn Tunisia (Tunes)
tr Turkey (Türkiye)
tm Turkmenistan (Türkmenistan)
tc Turks and Caicos Islands
tv Tuvalu
ug Uganda
ua Ukraine (Україна)
ae United Arab Emirates (الإمارات العربيّة المتّحدة)
uk United Kingdom
um United States Minor Outlying Islands
uy Uruguay (República Oriental del Uruguay)
uz Uzbekistan (Ўзбекистон)
vu Vanuatu
ve Venezuela
vn Vietnam (Việt Nam)
us United States
vi United States Virgin Islands
wf Wallis and Futuna (Wallis-et-Futuna)
ps West Bank
eh Western Sahara
ye Yemen (اليمن)
zm Zambia
zw Zimbabwe
Value Country
ar Argentina
au Australia
at Austria (Österreich)
be Belgium (België)
br Brazil (Brasil)
ca Canada
fr France
de Germany (Deutschland)
hk Hong Kong (香港)
in India
id Indonesia
it Italy (Italia)
jp Japan (日本)
ko Korea (한국)
my Malaysia
mx Mexico (México)
nl Netherlands (Nederland)
nz New Zealand
no Norway (Norge)
cn People's Republic of China
pl Poland (Polska)
ph Republic of the Philippines
ru Russia (Россия)
xa Saudi Arabia (المملكة العربية السعودية)
za South Africa (Suid-Afrika)
es Spain (España)
se Sweden (Sverige)
ch Switzerland (Schweiz)
tw Taiwan (中華民國)
tr Turkey (Türkiye)
gb United Kingdom
us United States
Value Country
au Australia
br Brazil (Brasil)
ca Canada
cn China (Zhōngguó)
fr France
de Germany (Deutschland)
in India
it Italy (Italia)
jp Japan (日本)
mx Mexico (México)
nl Netherlands (Nederland)
es Spain (España)
gb United Kingdom
us United States
Value Country
au Australia
at Austria (Österreich)
be Belgium (België)
ca Canada
cn China (Zhōngguó)
fr France
de Germany (Deutschland)
hk Hong Kong (香港)
in India
ie Ireland (Éire)
it Italy (Italia)
jp Japan (日本)
my Malaysia
nl Netherlands (Nederland)
ph Philippines (Pilipinas)
pl Poland (Polska)
sg Singapore
es Spain (España)
se Sweden (Sverige)
ch Switzerland (Schweiz)
tw Taiwan (中華民國)
th Thailand (ประเทศไทย)
gb United Kingdom
us United States
Value Country
al Albania (Shqipëria)
dz Algeria (الجزائر)
ao Angola
ai Anguilla
ag Antigua & Barbuda
ar Argentina
am Armenia (Hayastán)
au Australia
at Austria (Österreich)
az Azerbaijan (Azərbaycan)
bs Bahamas
bh Bahrain (البحرين)
bb Barbados
by Belarus (Беларусь)
be Belgium (België)
bz Belize
bj Benin (Bénin)
bm Bermuda
bt Bhutan (འབྲུག་ཡུལ)
bo Bolivia
bw Botswana
br Brazil (Brasil)
vg British Virgin Islands
bn Brunei (بروني)
bg Bulgaria
bf Burkina-Faso
kh Cambodia (Kampuchea)
ca Canada
cv Cape Verde (Cabo Verde)
ky Cayman Islands
td Chad (Tchad)
cl Chile
cn China (Zhōngguó)
co Colombia
cd Congo, Republic of
cr Costa Rica
hr Croatia (Hrvatska)
cy Cyprus (Kypros)
cz Czech Republic (Česká Republika)
dk Denmark (Danmark)
dm Dominica
do Dominican Republic (República Dominicana)
ec Ecuador
eg Egypt (مصر)
sv El Salvador
ee Estonia (Eesti)
fj Fiji
fi Finland (Suomi)
fr France
gm Gambia
de Germany (Deutschland)
gh Ghana
gr Greece (Hellas)
gd Grenada
gt Guatemala
gw Guinea Bissau (Guiné Bissau)
gy Guyana
hn Honduras
hk Hong Kong (香港)
hu Hungary (Magyarország)
is Iceland (Ísland)
in India
id Indonesia
ie Ireland (Éire)
il Israel (إسرائيل)
it Italy (Italia)
jm Jamaica
jp Japan (日本)
jo Jordan (الأردن)
kz Kazakhstan (Қазақстан)
ke Kenya
kw Kuwait (الكويت)
kg Kyrgyzstan (Кыргызстан)
la Laos (Lao)
lv Latvia (Latvija)
lb Lebanon (لبنان)
lr Liberia
lt Lithuania (Lietuva)
lu Luxembourg (Lëtzebuerg)
mo Macau
mk Macedonia (Makedonija)
mg Madagascar (Madagasikara)
mw Malawi
my Malaysia
ml Mali
mt Malta, Republic of
mr Mauritania (Muritan)
mu Mauritius (Maurice)
mx Mexico (México)
fm Micronesian, Federated States of
mn Mongolia (Mongol Uls)
ms Montserrat
md Moldova
mz Mozambique (Moçambique)
na Namibia
np Nepal (Nepāla)
nl Netherlands (Nederland)
nz New Zealand
ni Nicaragua
ne Niger
ng Nigeria
no Norway (Norge)
om Oman (عُمان)
pk Pakistan (پاکستان)
pw Palau (Belau)
pa Panama (Panamá)
gn Papua New Guinea
py Paraguay
pe Peru (Perú)
ph Philippines (Pilipinas)
pl Poland (Polska)
pt Portugal
qa Qatar (قطر)
ro Romania (România)
ru Russia (Россия)
kn St. Kitts & Nevis
lc St. Lucia
vc St. Vincent & The Grenadines
st Sao Tome e Principe (São Tomé e Príncipe)
sa Saudi Arabia (المملكة العربية السعودية)
sn Senegal (Sénégal)
sc Seychelles (Sesel)
sl Sierra Leone
sg Singapore
sk Slovakia (Slovensko)
sj Slovenia (Slovenija)
sb Soloman Islands
za South Africa (Suid-Afrika)
kr South Korea (한국)
es Spain (España)
lk Sri Lanka (Sri Lankā)
sr Suriname
sz Swaziland
se Sweden (Sverige)
ch Switzerland (Schweiz)
tw Taiwan (中華民國)
tj Tajikistan (Тоҷикистон)
tz Tanzania
th Thailand (ประเทศไทย)
tt Trinidad & Tobago
tn Tunisia (Tunes)
tr Turkey (Türkiye)
tm Turkmenistan (Türkmenistan)
tc Turks & Caicos
ug Uganda
ua Ukraine (Україна)
ae United Arab Emirates (الإمارات العربيّة المتّحدة)
gb United Kingdom
us United States
uy Uruguay (República Oriental del Uruguay)
uz Uzbekistan (Ўзбекистон)
ve Venezuela
vn Vietnam (Việt Nam)
ye Yemen (اليمن)
zw Zimbabwe

Supported values for "language" parameter

Value Language
af Afrikaans
sq Albanian (Shqip)
sm Amharic
ar Arabic (العربية)
az Azerbaijani (Azərbaycanca)
eu Basque (Euskal)
be Belarusian (Беларуская)
bn Bengali (বাঙ্গালী)
bh Bihari (বিহারী)
bs Bosnian (Bosanski)
bg Bulgarian (Български)
ca Catalan (Català)
zh-CN Chinese - Simplified (中国 - 简体)
zh-TW Chinese - Traditional (中文 - 繁體)
hr Croatian (Hrvatski)
cs Czech (Čeština)
da Danish (Dansk)
nl Dutch (Nederlands)
en English
eo Esperanto
et Estonian (Eesti)
fo Faroese (Føroyskt)
fi Finnish (Suomi)
fr French (Français)
fy Frisian
gl Galician (Galego)
ka Georgian (ქართული)
de German (Deutsch)
el Greek (ελληνικά)
gu Gujarati (ગુજરાતી)
iw Hebrew (עברית)
hi Hindi (हिंदी)
hu Hungarian (Magyar)
is Icelandic
id Indonesian (Bahasa Indonesia)
ia Interlingua
ga Irish (Gaeilge)
it Italian (Italiano)
ja Japanese (日本語)
jw Javanese (Jawa)
kn Kannada (ಕನ್ನಡ)
ko Korean (한국어)
la Latin (Latine)
lv Latvian (Latviešu Valoda)
lt Lithuanian (Lietuvių Kalba)
mk Macedonian (Македонски Јазик)
ms Malay (Bahasa Melayu)
ml Malayam (മലയാളം)
mt Maltese (Malti)
mr Marathi (मराठी)
mn Mongolian (Монгол)
ne Nepali (नेपाली)
no Norwegian (Norsk)
nn Norwegian (Nynorsk)
oc Occitan (Lenga d'òc)
fa Persian (فارسی)
pl Polish (Polski)
pt-BR Portuguese - Brazil (Português - Brasil)
pt-PT Portuguese - Portugal (Português - Portugal)
pa Punjabi (ਪੰਜਾਬੀ ਦੇ)
ro Romanian (Român)
ru Russian (Русский)
gd Scottish Gaelic (Gàidhlig)
sr Serbian (Cрпски)
si Sinhalese (සිංහල)
sk Slovak (Slovenský)
sl Slovenian (Slovenščina)
es Spanish (Español)
su Sudanese
sw Swahili (Kiswahili)
sv Swedish (Svenska)
tl Tagalog
ta Tamil (தமிழ்)
te Telugu
th Thai (ภาษาไทย)
ti Tigrinya (ትግርኛ)
tr Turkish (Türk)
uk Ukrainian (Українська)
ur Urdu (اُردُو‎)
uz Uzbek (O'zbekcha)
vi Vietnamese (Việt)
cy Welsh (Cymraeg)
xh Xhosa
zu Zulu
Value Language
ar Arabic (العربية)
bg Bulgarian (Български)
ca Catalan (Català)
zh_CN Chinese - Simplified (中国 - 简体)
zh_TW Chinese - Traditional (中文 - 繁體)
hr Croatian (Hrvatski)
cs Czech (Čeština)
da Danish (Dansk)
en English
et Estonian (Eesti)
nl Dutch (Nederlands)
fi Finnish (Suomi)
fr French (Français)
de German (Deutsch)
el Greek (ελληνικά)
iw Hebrew (עברית)
hi Hindi (हिंदी)
hu Hungarian (Magyar)
is Icelandic
id Indonesian (Bahasa Indonesia)
it Italian (Italiano)
ja Japanese (日本語)
ko Korean (한국어)
lv Latvian (Latviešu Valoda)
lt Lithuanian (Lietuvių Kalba)
mn Mongolian (Монгол)
no Norwegian (Norsk)
pl Polish (Polski)
pt Portuguese (Português)
ro Romanian (Român)
ru Russian (Русский)
sr Serbian (Cрпски)
sk Slovak (Slovenský)
sl Slovenian (Slovenščina)
es Spanish (Español)
sv Swedish (Svenska)
tl Tagalog
th Thai (ภาษาไทย)
tr Turkish (Türk)
uk Ukrainian (Українська)
ur Urdu (اُردُو‎)
vi Vietnamese (Việt)
Value Language
ar Arabic (العربية)
zh Chinese (中国)
nl Dutch (Nederlands)
en English
fr French (Français)
de German (Deutsch)
it Italian (Italiano)
ja Japanese (日本語)
ko Korean (한국어)
nb Norwegian (Bokmål)
pl Polish (Polski)
pt Portuguese (Português)
ru Russian (Русский)
es Spanish (Español)
sv Swedish (Svenska)
tr Turkish (Türk)
Value Language
zh Chinese (中国)
nl Dutch (Nederlands)
en English
fr French (Français)
de German (Deutsch)
it Italian (Italiano)
ja Japanese (日本語)
pt Portuguese (Português)
es Spanish (Español)
Value Language
zh-CN Chinese - Simplified (中国 - 简体)
zh-TW Chinese - Traditional (中文 - 繁體)
nl Dutch (Nederlands)
en English
fr French (Français)
de German (Deutsch)
hi Hindi (हिंदी)
it Italian (Italiano)
ja Japanese (日本語)
ms Malay (Bahasa Melayu)
pl Polish (Polski)
es Spanish (Español)
sv Swedish (Svenska)
th Thai (ภาษาไทย)
vi Vietnamese (Việt)
Value Language
ar Arabic (العربية)
ca Catalan (Català)
zh-CN Chinese - Simplified (中国 - 简体)
zh-TW Chinese - Traditional (中文 - 繁體)
hr Croatian (Hrvatski)
cs Czech (Čeština)
da Danish (Dansk)
nl Dutch (Nederlands)
en English
fi Finnish (Suomi)
fr French (Français)
de German (Deutsch)
el Greek (ελληνικά)
iw Hebrew (עברית)
hi Hindi (हिंदी)
hu Hungarian (Magyar)
id Indonesian (Bahasa Indonesia)
it Italian (Italiano)
ja Japanese (日本語)
ko Korean (한국어)
ms Malay (Bahasa Melayu)
no Norwegian (Norsk)
pl Polish (Polski)
pt-BR Portuguese - Brazil (Português - Brasil)
pt-PT Portuguese - Portugal (Português - Portugal)
ro Romanian (Român)
ru Russian (Русский)
sk Slovak (Slovenský)
es Spanish (Español)
sv Swedish (Svenska)
th Thai (ภาษาไทย)
tr Turkish (Türk)
uk Ukrainian (Українська)
vi Vietnamese (Việt)

Supported values for "metrics_location" parameter

Enter one or up to 10 locations to target.

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


Supported values for "metrics_language" parameter

Value Language
ar Arabic (العربية)
bg Bulgarian (Български)
ca Catalan (Català)
zh-CN Chinese - Simplified (中国 - 简体)
zh-TW Chinese - Traditional (中文 - 繁體)
hr Croatian (Hrvatski)
cs Czech (Čeština)
da Danish (Dansk)
nl Dutch (Nederlands)
en English
et Estonian (Eesti)
tl Filipino (Tagalog)
fi Finnish (Suomi)
fr French (Français)
de German (Deutsch)
el Greek (ελληνικά)
iw Hebrew (עברית)
hi Hindi (हिंदी)
hu Hungarian (Magyar)
is Icelandic
id Indonesian (Bahasa Indonesia)
it Italian (Italiano)
ja Japanese (日本語)
ko Korean (한국어)
lv Latvian (Latviešu Valoda)
lt Lithuanian (Lietuvių Kalba)
ms Malay (Bahasa Melayu)
no Norwegian (Norsk)
fa Persian (فارسی)
pl Polish (Polski)
pt Portuguese (Português)
ro Romanian (Român)
ru Russian (Русский)
sr Serbian (Cрпски)
sk Slovak (Slovenský)
sl Slovenian (Slovenščina)
es Spanish (Español)
sv Swedish (Svenska)
th Thai (ภาษาไทย)
tr Turkish (Türk)
uk Ukrainian (Українська)
ur Urdu (اُردُو‎)
vi Vietnamese (Việt)

Supported values for "metrics_network" parameter

Value Description
googlesearch Google
googlesearchnetwork Google and search partners

Supported values for "metrics_currency" parameter

Value Currency
ARS Argentine Peso
AUD Australian Dollar
BOB Bolivian Boliviano
BND Bruneian Dollar
BGN Bulgarian Lev
BRL Brazilian Real
GBP British Pound
CAD Canadian Dollar
CLP Chilean Peso
CNY Chinese Yuan Renminbi
COP Colombian Peso
HRK Croatian Kuna
CZK Czech Koruna
DKK Danish Krone
EGP Egyptian Pound
AED Emirati Dirham
EUR Euro
FJD Fijian Dollar
HKD Hong Kong Dollar
HUF Hungarian Forint
INR Indian Rupee
IDR Indonesian Rupiah
ILS Israeli Shekel
JPY Japanese Yen
KES Kenyan Shilling
MYR Malaysian Ringgit
MXN Mexican Peso
MAD Moroccan Dirham
NZD New Zealand Dollar
NOK Norwegian Krone
PKR Pakistani Rupee
PEN Peruvian Sol
PHP Philippine Peso
PLN Polish Zloty
RON Romanian New Leu
RUB Russian Ruble
SAR Saudi Arabian Riyal
RSD Serbian Dinar
SGD Singapore Dollar
ZAR South African Rand
KRW South Korean Won
SEK Swedish Krona
CHF Swiss Franc
TWD Taiwan New Dollar
THB Thai Baht
TRY Turkish Lira
UAH Ukrainian Hryvnia
USD US Dollar
VEF Venezuelan Bolivar
VND Vietnamese Dong

Supported values for "output" parameter

Value Output
json JSON
xml XML

Responses

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

Value Description
string A keyword that the search volume data is provided for.
volume Average monthly search volume for the last 12 months.
m1...m12 Search volume on a given month.
cpc Cost-Per-Click (CPC) for the keyword on Google AdWords.
cmp Competition metric for the keyword on Google AdWords.
(m1...m12)_month The exact month number for the "m1" to "m12" values.
(m1...m12)_year The exact year for the "m1" to "m12" values.

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

Request

https://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

https://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

GET

https://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

GET

curl \
  'https://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'

POST

curl \
  --data 'apikey=[API_KEY]&keyword=["apple","samsung"]&metrics_location=2840&metrics_language=en&metrics_network=googlesearchnetwork&metrics_currency=USD&output=json' \
  --request POST \
  'https://api.keywordtool.io/v2/search/volume/google'

POST (JSON)

curl \
  --data '{"apikey":"[API_KEY]","keyword":["apple","samsung"],"metrics_location":["2840"],"metrics_language":["en"],"metrics_network":"googlesearchnetwork","metrics_currency":"USD","output":"json"}' \
  --request POST \
  'https://api.keywordtool.io/v2/search/volume/google'

GET

<?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, 'https://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);

POST

<?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, 'https://api.keywordtool.io/v2/search/volume/google');
curl_setopt($ch, CURLOPT_POST, TRUE);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($params));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
$output = curl_exec($ch);
$response = json_decode($output, TRUE);

var_dump($response);

POST (JSON)

<?php

$apikey = '[API_KEY]';

$params = array(
  'apikey' => $apikey,
  'keyword' => array('apple', 'samsung'),  // No need to double encode "keyword" parameter.
  'metrics_location' => array('2840'),  // JSON array instead of comma separated.
  'metrics_language' => array('en'),  // JSON array instead of comma separated.
  'metrics_network' => 'googlesearchnetwork',
  'metrics_currency' => 'USD',
  'output' => 'json',
);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.keywordtool.io/v2/search/volume/google');
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/json'));
curl_setopt($ch, CURLOPT_POST, TRUE);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($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 = 'https://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('https://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));
  }
});

GET

https://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

GET

curl \
  'https://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'

POST

curl \
  --data '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' \
  --request POST \
  'https://api.keywordtool.io/v2/search/suggestions/google'

POST (JSON)

curl \
  --data '{"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"}' \
  --request POST \
  'https://api.keywordtool.io/v2/search/suggestions/google'

GET

<?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, 'https://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);

POST

<?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, 'https://api.keywordtool.io/v2/search/suggestions/google');
curl_setopt($ch, CURLOPT_POST, TRUE);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($params));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
$output = curl_exec($ch);
$response = json_decode($output, TRUE);

var_dump($response);

POST (JSON)

<?php

$apikey = '[API_KEY]';

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

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.keywordtool.io/v2/search/suggestions/google');
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/json'));
curl_setopt($ch, CURLOPT_POST, TRUE);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($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 = 'https://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('https://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));
  }
});

Limits

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 Plus API Basic API Lite
API requests per day 1 800 400 100

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


Error Codes

Error Code Description HTTP Code
0 API general error. Please contact support. 404
#-0 We are unable to process your request at this time, please try again later. 404
#-1 No such country code. 404
#-2 No such language code. 404
1 No search provider. 404
2 No such search provider supported. 404
3 No search query provided. 404
4 No API key provided. 404
5 The API key provided is invalid. 404
6 You have tried to use an invalid API key for too many consecutive times. 404
7 You have reached your limit of searches. Please try again shortly. 404
8 Please provide not more than 2,000 negative keywords in your request. 404
9 Sorry, you have reached your daily limit of searches. Please try again another day. 404
10 Search results could be incomplete, please try again later. This request was not counted against your quota. 200
11 Please choose a search mode ("suggestions", or "volume"), e.g. "https://api.keywordtool.io/v2/search/[mode]/[provider]". 404
12 Please choose a search provider, e.g. "https://api.keywordtool.io/v2/search/[mode]/[provider]". 404
13 Provider is not supported for search volume mode. 404
14 Location is invalid. 404
15 Language is invalid. 404
16 Network is invalid. 404
17 Currency is invalid. 404
18 You can only select up to 10 locations. 404
19 You can only select up to 5 languages. 404
20 You cannot send more than 800 keywords in a request. 404
21 You can only select 1 language for search volume mode. 404
22 A keyword exceeds the maximum allowed length. The length of any given keyword cannot exceed 80 characters. 404