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

Supported values for "language" parameter

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

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

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