Keyword Tool API V1 Documentation


Table of Contents

Endpoints

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

Search Engine Endpoint
Google https://api.keywordtool.io/v1/search/google
YouTube https://api.keywordtool.io/v1/search/youtube
Bing https://api.keywordtool.io/v1/search/bing
Amazon https://api.keywordtool.io/v1/search/amazon
eBay https://api.keywordtool.io/v1/search/ebay
App Store https://api.keywordtool.io/v1/search/app-store

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


Supported Parameters

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

Parameter Description Default Value Required
apikey Your key to access API. none Yes
keyword Seed keyword, that will be used to generate suggestions. none Yes
exclude Use this parameter to specify negative keywords, i.e. the keywords that you want to exclude from your results.

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

Meaning the keyword suggestion "best iphone price" will not show up in the results.
none No
country Country, you want to get keyword suggestions for. us No
language Language, you want to get keyword suggestions for. en No
metrics Allows to get search volume, CPC and AdWords competition data for keywords in English language if this parameter is set to "true". false No
type Type of search query. Available types are: "suggestions" and "questions". suggestions 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

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

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


Supported values for "country" parameter

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 "output" parameter

Value Output
json JSON
xml XML

Examples

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

$apikey = '[API_KEY]';

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

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

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

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

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

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

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

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

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

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

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


Limits

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

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

Search Engine Maximum number of keywords returned per 1 API request Number of keywords you can get from the API in 1 day
Google 1,400 10,080,000
YouTube 1,400 10,080,000
Bing 900 6,480,000
App Store 3,800 27,360,000
Amazon 760 5,472,000

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


Error Codes

Error 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
22 A keyword exceeds the maximum allowed length. The length of any given keyword cannot exceed 80 characters. 404