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
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
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
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
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 (العربية)
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 "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