Keyword Tool API Documentation
Table of Contents
Get Started
Endpoints
Supported Parameters
Supported values for "country" parameter
Supported values for "language" parameter
Supported values for "metrics_location" parameter
Supported values for "metrics_language" parameter
Supported values for "metrics_network" parameter
Supported values for "metrics_currency" parameter
Supported values for "output" parameter
Responses
Examples
Limits
Error Codes
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 44,049 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 |
|---|---|
https://api.keywordtool.io/v2/search/suggestions/google |
|
| YouTube | https://api.keywordtool.io/v2/search/suggestions/youtube |
| Bing | https://api.keywordtool.io/v2/search/suggestions/bing |
| Amazon | https://api.keywordtool.io/v2/search/suggestions/amazon |
| eBay | https://api.keywordtool.io/v2/search/suggestions/ebay |
| App Store | https://api.keywordtool.io/v2/search/suggestions/app-store |
Supported Parameters
The API endpoint supports both GET and POST request methods. For larger requests, we recommend using POST method.
| Parameter | Description | Default value | Required |
|---|---|---|---|
| apikey | Your key to access API. | none | Yes |
| keyword | Keywords you would like to get the search volume for. 1 to 800 keywords are accepted. Data must be provided in JSON encoded format e.g. ["chair","table","phone case"] | none | Yes |
| metrics_location | Location, that you would like to localize the search volume to. Accepts up to 10 comma-separated location IDs. Location IDs can be found here. | none | No |
| metrics_language | Language, that you would like to localize the search volume to. Accepts up to 5 comma-separated language codes. Language codes can be found here. | none | No |
| metrics_network | Search network that will be used to pull the search volume data. | googlesearchnetwork | No |
| metrics_currency | The currency that will be used to display cost-per-click (CPC) data. | USD | No |
| output | Output of your API request. | json | No |
| complete | Allows to get the full set of autocomplete results. Please note that certain percent of requests might return an error if this parameter is set to "true". | false | No |
The API endpoint supports both GET and POST request methods. For larger requests, we recommend using POST method.
| Parameter | Description | Default value | Required |
|---|---|---|---|
| apikey | Your key to access API. | none | Yes |
| keyword | Seed keyword that will be used to generate suggestions. Only 1 keyword is accepted in plain text format. | none | Yes |
| exclude | Use this parameter to specify negative keywords, i.e. the keywords that you want to exclude from your results. Must be provided in JSON format. For example, an API call that contains "keyword=iphone&exclude=["case","game","price]" will return keyword suggestions for the keyword "iphone" but there will be no keyword suggestions that contain words "case", "game", or "price". Meaning, the keyword suggestion "best iphone price" will not show up in the results. |
none | No |
| country | A country, you want to get keyword suggestions for. Only a single value is accepted. | us | No |
| language | Language, you want to get keyword suggestions for. Only a single value is accepted. | en | No |
| metrics | Allows to get Google Search Volume, Cost-Per-Click (CPC), and AdWords Competition (CMP) data for keywords if this parameter is set to "true". | false | No |
| metrics_location | Location, that you would like to localize the search volume to. Accepts up to 10 comma-separated location IDs. Location IDs can be found here. | none | No |
| metrics_language | Language, that you would like to localize the search volume to. Accepts up to 5 comma-separated language codes. Language codes can be found here. | none | No |
| metrics_network | Search network that will be used to pull the search volume data. | googlesearchnetwork | No |
| metrics_currency | The currency that will be used to display cost-per-click (CPC) data. | USD | No |
| type | Type of search query. Available types are: "suggestions" and "questions". If set to "questions", the seed keyword will be prepended with the words that typically start questions in English language e.g. "why", "when", "does" etc. |
suggestions | No |
| output | Output of your API request. | json | No |
Supported values for "country" parameter
| Value | Country |
|---|---|
| af | Afghanistan (google.com.af) |
| al | Albania (google.al) |
| dz | Algeria (google.dz) |
| as | American Samoa (google.as) |
| ad | Andorra (google.ad) |
| ao | Angola (google.co.ao) |
| ai | Anguilla (google.com.ai) |
| ag | Antigua and Barbuda (google.com.ag) |
| ar | Argentina (google.com.ar) |
| am | Armenia (google.am) |
| au | Australia (google.com.au) |
| at | Austria (google.at) |
| az | Azerbaijan (google.az) |
| bs | Bahamas (google.bs) |
| bh | Bahrain (google.com.bh) |
| bd | Bangladesh (google.com.bd) |
| by | Belarus (google.by) |
| be | Belgium (google.be) |
| bz | Belize (google.com.bz) |
| bj | Benin (google.bj) |
| bt | Bhutan (google.bt) |
| bo | Bolivia (google.com.bo) |
| ba | Bosnia and Herzegovina (google.ba) |
| bw | Botswana (google.co.bw) |
| br | Brazil (google.com.br) |
| vg | British Virgin Islands (google.vg) |
| bn | Brunei (google.com.bn) |
| bg | Bulgaria (google.bg) |
| bf | Burkina Faso (google.bf) |
| bi | Burundi (google.bi) |
| kh | Cambodia (google.com.kh) |
| cm | Cameroon (google.cm) |
| ca | Canada (google.ca) |
| cv | Cape Verde (google.cv) |
| cat | Catalan Countries (google.cat) |
| cf | Central African Republic (google.cf) |
| td | Chad (google.td) |
| cl | Chile (google.cl) |
| co | Colombia (google.com.co) |
| ck | Cook Islands (google.co.ck) |
| cr | Costa Rica (google.co.cr) |
| hr | Croatia (google.hr) |
| cu | Cuba (google.com.cu) |
| cy | Cyprus (google.com.cy) |
| cz | Czech Republic (google.cz) |
| cd | Democratic Republic of the Congo (google.cd) |
| dk | Denmark (google.dk) |
| dj | Djibouti (google.dj) |
| dm | Dominica (google.dm) |
| do | Dominican Republic (google.com.do) |
| ec | Ecuador (google.com.ec) |
| eg | Egypt (google.com.eg) |
| sv | El Salvador (google.com.sv) |
| ee | Estonia (google.ee) |
| et | Ethiopia (google.com.et) |
| fm | Federated States of Micronesia (google.fm) |
| fj | Fiji (google.com.fj) |
| fi | Finland (google.fi) |
| fr | France (google.fr) |
| ga | Gabon (google.ga) |
| gm | Gambia (google.gm) |
| ge | Georgia (google.ge) |
| de | Germany (google.de) |
| gh | Ghana (google.com.gh) |
| gi | Gibraltar (google.com.gi) |
| gr | Greece (google.gr) |
| gl | Greenland (google.gl) |
| gp | Guadeloupe (google.gp) |
| gt | Guatemala (google.com.gt) |
| gg | Guernsey (google.gg) |
| gy | Guyana (google.gy) |
| ht | Haiti (google.ht) |
| hn | Honduras (google.hn) |
| hk | Hong Kong (google.com.hk) |
| hu | Hungary (google.hu) |
| is | Iceland (google.is) |
| in | India (google.co.in) |
| id | Indonesia (google.co.id) |
| iq | Iraq (google.iq) |
| ie | Ireland (google.ie) |
| im | Isle of Man (google.im) |
| il | Israel (google.co.il) |
| it | Italy (google.it) |
| ci | Ivory Coast (google.ci) |
| jm | Jamaica (google.com.jm) |
| jp | Japan (google.co.jp) |
| je | Jersey (google.je) |
| jo | Jordan (google.jo) |
| kz | Kazakhstan (google.kz) |
| ke | Kenya (google.co.ke) |
| ki | Kiribati (google.ki) |
| kw | Kuwait (google.com.kw) |
| kg | Kyrgyzstan (google.kg) |
| la | Laos (google.la) |
| lv | Latvia (google.lv) |
| lb | Lebanon (google.com.lb) |
| ls | Lesotho (google.co.ls) |
| ly | Libya (google.com.ly) |
| li | Liechtenstein (google.li) |
| lt | Lithuania (google.lt) |
| lu | Luxembourg (google.lu) |
| mk | Macedonia (google.mk) |
| mg | Madagascar (google.mg) |
| mw | Malawi (google.mw) |
| my | Malaysia (google.com.my) |
| mv | Maldives (google.mv) |
| ml | Mali (google.ml) |
| mt | Malta (google.com.mt) |
| mu | Mauritius (google.mu) |
| mx | Mexico (google.com.mx) |
| md | Moldova (google.md) |
| mn | Mongolia (google.mn) |
| me | Montenegro (google.me) |
| ms | Montserrat (google.ms) |
| ma | Morocco (google.co.ma) |
| mz | Mozambique (google.co.mz) |
| mm | Myanmar (google.com.mm) |
| na | Namibia (google.com.na) |
| nr | Nauru (google.nr) |
| np | Nepal (google.com.np) |
| nl | Netherlands (google.nl) |
| nz | New Zealand (google.co.nz) |
| ni | Nicaragua (google.com.ni) |
| ne | Niger (google.ne) |
| ng | Nigeria (google.com.ng) |
| nu | Niue (google.nu) |
| nf | Norfolk Island (google.com.nf) |
| no | Norway (google.no) |
| om | Oman (google.com.om) |
| pk | Pakistan (google.com.pk) |
| ps | Palestine (google.ps) |
| pa | Panama (google.com.pa) |
| pg | Papua New Guinea (google.com.pg) |
| py | Paraguay (google.com.py) |
| pe | Peru (google.com.pe) |
| ph | Philippines (google.com.ph) |
| pn | Pitcairn Islands (google.pn) |
| pl | Poland (google.pl) |
| pt | Portugal (google.pt) |
| pr | Puerto Rico (google.com.pr) |
| qa | Qatar (google.com.qa) |
| cg | Republic of the Congo (google.cg) |
| ro | Romania (google.ro) |
| ru | Russia (google.ru) |
| rw | Rwanda (google.rw) |
| sh | Saint Helena, Ascension and Tristan da Cunha (google.sh) |
| vc | Saint Vincent and the Grenadines (google.com.vc) |
| ws | Samoa (google.ws) |
| sm | San Marino (google.sm) |
| sa | Saudi Arabia (google.com.sa) |
| sn | Senegal (google.sn) |
| rs | Serbia (google.rs) |
| sc | Seychelles (google.sc) |
| sl | Sierra Leone (google.com.sl) |
| sg | Singapore (google.com.sg) |
| sk | Slovakia (google.sk) |
| si | Slovenia (google.si) |
| sb | Solomon Islands (google.com.sb) |
| so | Somalia (google.so) |
| za | South Africa (google.co.za) |
| kr | South Korea (google.co.kr) |
| es | Spain (google.es) |
| lk | Sri Lanka (google.lk) |
| sr | Suriname (google.sr) |
| se | Sweden (google.se) |
| ch | Switzerland (google.ch) |
| st | São Tomé and Príncipe (google.st) |
| tw | Taiwan (google.com.tw) |
| tj | Tajikistan (google.com.tj) |
| tz | Tanzania (google.co.tz) |
| th | Thailand (google.co.th) |
| tl | Timor-Leste (google.tl) |
| tg | Togo (google.tg) |
| tk | Tokelau (google.tk) |
| to | Tonga (google.to) |
| tt | Trinidad and Tobago (google.tt) |
| tn | Tunisia (google.tn) |
| tr | Turkey (google.com.tr) |
| tm | Turkmenistan (google.tm) |
| ug | Uganda (google.co.ug) |
| ua | Ukraine (google.com.ua) |
| ae | United Arab Emirates (google.ae) |
| uk | United Kingdom (google.co.uk) |
| us | United States (google.com) |
| vi | United States Virgin Islands (google.co.vi) |
| uy | Uruguay (google.com.uy) |
| uz | Uzbekistan (google.co.uz) |
| vu | Vanuatu (google.vu) |
| ve | Venezuela (google.co.ve) |
| vn | Vietnam (google.com.vn) |
| zm | Zambia (google.co.zm) |
| zw | Zimbabwe (google.co.zw) |
| Value | Country |
|---|---|
| af | Afghanistan (افغانستان) |
| dz | Algeria (الجزائر) |
| as | American Samoa (Amerika Sāmoa) |
| ad | Andorra |
| ao | Angola |
| ai | Anguilla |
| aq | Antarctica |
| ag | Antigua and Barbuda |
| ar | Argentina |
| am | Armenia (Hayastán) |
| aw | Aruba |
| au | Australia |
| at | Austria (Österreich) |
| az | Azerbaijan (Azərbaycan) |
| bs | Bahamas |
| bh | Bahrain (البحرين) |
| bd | Bangladesh (বাংলাদেশ) |
| bb | Barbados |
| by | Belarus (Беларусь) |
| be | Belgium (België) |
| bz | Belize |
| bj | Benin (Bénin) |
| bm | Bermuda |
| bt | Bhutan (འབྲུག་ཡུལ) |
| bo | Bolivia |
| ba | Bosnia and Herzegovina (Bosna i Hercegovina) |
| bw | Botswana |
| bv | Bouvet Island |
| br | Brazil (Brasil) |
| io | British Indian Ocean Territory |
| vg | British Virgin Islands |
| bn | Brunei (بروني) |
| bg | Bulgaria |
| bf | Burkina Faso |
| bi | Burundi |
| kh | Cambodia (Kampuchea) |
| cm | Cameroon (Cameroun) |
| ca | Canada |
| cv | Cape Verde (Cabo Verde) |
| ky | Cayman Islands |
| cf | Central African Republic (République Centrafricaine) |
| td | Chad (Tchad) |
| cl | Chile |
| cx | Christmas Island |
| cc | Cocos (Keeling) Islands |
| co | Colombia |
| km | Comoros (جزر القمر) |
| cg | Congo |
| cd | Congo - Democratic Republic of |
| ck | Cook Islands |
| cr | Costa Rica |
| ci | Cote d'Ivoire |
| hr | Croatia (Hrvatska) |
| cy | Cyprus (Kypros) |
| cz | Czech Republic (Česká Republika) |
| dk | Denmark (Danmark) |
| dj | Djibouti (جيبوتي) |
| dm | Dominica |
| do | Dominican Republic (República Dominicana) |
| tl | Timor-Leste |
| ec | Ecuador |
| eg | Egypt (مصر) |
| sv | El Salvador |
| gq | Equatorial Guinea (Guinea Ecuatorial) |
| er | Eritrea (إرتريا) |
| ee | Estonia (Eesti) |
| et | Ethiopia (Ityop'ia) |
| fk | Falkland Islands (Islas Malvinas) |
| fo | Faroe Islands (Føroyar) |
| fj | Fiji |
| fi | Finland (Suomi) |
| fr | France |
| gf | French Guiana (Guyane) |
| pf | French Polynesia (Polynésie Française) |
| tf | French Southern Territories |
| ga | Gabon |
| gm | Gambia |
| ge | Georgia (Sak'art'velo) |
| de | Germany (Deutschland) |
| gh | Ghana |
| gi | Gibraltar |
| gr | Greece (Hellas) |
| gl | Greenland (Kalaallit Nunaat) |
| gd | Grenada |
| gp | Guadeloupe |
| gu | Guam (Guåhån) |
| gt | Guatemala |
| gn | Guinea (Guinée) |
| gw | Guinea-Bissau (Guiné-Bissau) |
| gy | Guyana |
| ht | Haiti (Haïti) |
| hm | Heard Island and McDonald Islands |
| va | Holy See (Vatican City State) (Città del Vaticano) |
| hn | Honduras |
| hk | Hong Kong (香港) |
| hu | Hungary (Magyarország) |
| is | Iceland (Ísland) |
| in | India |
| id | Indonesia |
| iq | Iraq |
| ie | Ireland (Éire) |
| il | Israel (إسرائيل) |
| it | Italy (Italia) |
| jm | Jamaica |
| jp | Japan (日本) |
| jo | Jordan (الأردن) |
| kz | Kazakhstan (Қазақстан) |
| ke | Kenya |
| ki | Kiribati |
| kw | Kuwait (الكويت) |
| kg | Kyrgyzstan (Кыргызстан) |
| la | Laos (Lao) |
| lv | Latvia (Latvija) |
| lb | Lebanon (لبنان) |
| ls | Lesotho |
| lr | Liberia |
| ly | Libya |
| li | Liechtenstein |
| lt | Lithuania (Lietuva) |
| lu | Luxembourg (Lëtzebuerg) |
| mo | Macao |
| mk | Macedonia (Makedonija) |
| mg | Madagascar (Madagasikara) |
| mw | Malawi |
| my | Malaysia |
| mv | Maldives (Dhivehi Raajje) |
| ml | Mali |
| mt | Malta |
| mh | Marshall Islands |
| mq | Martinique |
| mr | Mauritania (Muritan) |
| mu | Mauritius (Maurice) |
| yt | Mayotte |
| mx | Mexico (México) |
| fm | Micronesia - Federated States of |
| md | Moldova |
| mc | Monaco |
| mn | Mongolia (Mongol Uls) |
| ms | Montserrat |
| ma | Morocco (Amerruk) |
| mz | Mozambique (Moçambique) |
| na | Namibia |
| nr | Nauru |
| np | Nepal (Nepāla) |
| nl | Netherlands (Nederland) |
| nc | New Caledonia (Nouvelle-Calédonie) |
| nz | New Zealand |
| ni | Nicaragua |
| ne | Niger |
| ng | Nigeria |
| nu | Niue |
| nf | Norfolk Island |
| mp | Northern Mariana Islands |
| no | Norway (Norge) |
| om | Oman (عُمان) |
| pk | Pakistan (پاکستان) |
| pw | Palau (Belau) |
| pa | Panama (Panamá) |
| pg | Papua New Guinea |
| py | Paraguay |
| pe | Peru (Perú) |
| ph | Philippines (Pilipinas) |
| pn | Pitcairn |
| pl | Poland (Polska) |
| pt | Portugal |
| pr | Puerto Rico |
| qa | Qatar (قطر) |
| re | Reunion (Réunion) |
| ro | Romania (România) |
| ru | Russia (Россия) |
| rw | Rwanda |
| kn | Saint Kitts and Nevis |
| lc | Saint Lucia |
| vc | Saint Vincent and the Grenadines |
| ws | Samoa |
| sm | San Marino |
| st | Sao Tome and Principe (São Tomé e Príncipe) |
| sa | Saudi Arabia (المملكة العربية السعودية) |
| sn | Senegal (Sénégal) |
| sc | Seychelles (Sesel) |
| sl | Sierra Leone |
| sg | Singapore |
| sk | Slovakia (Slovensko) |
| si | Slovenia (Slovenija) |
| sb | Solomon Islands |
| so | Somalia (Soomaaliya) |
| za | South Africa (Suid-Afrika) |
| gs | South Georgia and the South Sandwich Islands |
| kr | South Korea (한국) |
| es | Spain (España) |
| lk | Sri Lanka (Sri Lankā) |
| sh | Saint Helena |
| pm | Saint Pierre and Miquelon |
| sr | Suriname |
| sj | Svalbard and Jan Mayen |
| sz | Swaziland |
| se | Sweden (Sverige) |
| ch | Switzerland (Schweiz) |
| tw | Taiwan (中華民國) |
| tj | Tajikistan (Тоҷикистон) |
| tz | Tanzania |
| th | Thailand (ประเทศไทย) |
| tg | Togo |
| tk | Tokelau |
| to | Tonga |
| tt | Trinidad and Tobago |
| tn | Tunisia (Tunes) |
| tr | Turkey (Türkiye) |
| tm | Turkmenistan (Türkmenistan) |
| tc | Turks and Caicos Islands |
| tv | Tuvalu |
| ug | Uganda |
| ua | Ukraine (Україна) |
| ae | United Arab Emirates (الإمارات العربيّة المتّحدة) |
| uk | United Kingdom |
| um | United States Minor Outlying Islands |
| uy | Uruguay (República Oriental del Uruguay) |
| uz | Uzbekistan (Ўзбекистон) |
| vu | Vanuatu |
| ve | Venezuela |
| vn | Vietnam (Việt Nam) |
| us | United States |
| vi | United States Virgin Islands |
| wf | Wallis and Futuna (Wallis-et-Futuna) |
| ps | West Bank |
| eh | Western Sahara |
| ye | Yemen (اليمن) |
| zm | Zambia |
| zw | Zimbabwe |
| Value | Country |
|---|---|
| ar | Argentina |
| au | Australia |
| at | Austria (Österreich) |
| be | Belgium (België) |
| br | Brazil (Brasil) |
| ca | Canada |
| fr | France |
| de | Germany (Deutschland) |
| hk | Hong Kong (香港) |
| in | India |
| id | Indonesia |
| it | Italy (Italia) |
| jp | Japan (日本) |
| ko | Korea (한국) |
| my | Malaysia |
| mx | Mexico (México) |
| nl | Netherlands (Nederland) |
| nz | New Zealand |
| no | Norway (Norge) |
| cn | People's Republic of China |
| pl | Poland (Polska) |
| ph | Republic of the Philippines |
| ru | Russia (Россия) |
| xa | Saudi Arabia (المملكة العربية السعودية) |
| za | South Africa (Suid-Afrika) |
| es | Spain (España) |
| se | Sweden (Sverige) |
| ch | Switzerland (Schweiz) |
| tw | Taiwan (中華民國) |
| tr | Turkey (Türkiye) |
| gb | United Kingdom |
| us | United States |
| Value | Country |
|---|---|
| au | Australia |
| br | Brazil (Brasil) |
| ca | Canada |
| cn | China (Zhōngguó) |
| fr | France |
| de | Germany (Deutschland) |
| in | India |
| it | Italy (Italia) |
| jp | Japan (日本) |
| mx | Mexico (México) |
| nl | Netherlands (Nederland) |
| es | Spain (España) |
| gb | United Kingdom |
| us | United States |
| Value | Country |
|---|---|
| au | Australia |
| at | Austria (Österreich) |
| be | Belgium (België) |
| ca | Canada |
| cn | China (Zhōngguó) |
| fr | France |
| de | Germany (Deutschland) |
| hk | Hong Kong (香港) |
| in | India |
| ie | Ireland (Éire) |
| it | Italy (Italia) |
| jp | Japan (日本) |
| my | Malaysia |
| nl | Netherlands (Nederland) |
| ph | Philippines (Pilipinas) |
| pl | Poland (Polska) |
| sg | Singapore |
| es | Spain (España) |
| se | Sweden (Sverige) |
| ch | Switzerland (Schweiz) |
| tw | Taiwan (中華民國) |
| th | Thailand (ประเทศไทย) |
| gb | United Kingdom |
| us | United States |
| Value | Country |
|---|---|
| al | Albania (Shqipëria) |
| dz | Algeria (الجزائر) |
| ao | Angola |
| ai | Anguilla |
| ag | Antigua & Barbuda |
| ar | Argentina |
| am | Armenia (Hayastán) |
| au | Australia |
| at | Austria (Österreich) |
| az | Azerbaijan (Azərbaycan) |
| bs | Bahamas |
| bh | Bahrain (البحرين) |
| bb | Barbados |
| by | Belarus (Беларусь) |
| be | Belgium (België) |
| bz | Belize |
| bj | Benin (Bénin) |
| bm | Bermuda |
| bt | Bhutan (འབྲུག་ཡུལ) |
| bo | Bolivia |
| bw | Botswana |
| br | Brazil (Brasil) |
| vg | British Virgin Islands |
| bn | Brunei (بروني) |
| bg | Bulgaria |
| bf | Burkina-Faso |
| kh | Cambodia (Kampuchea) |
| ca | Canada |
| cv | Cape Verde (Cabo Verde) |
| ky | Cayman Islands |
| td | Chad (Tchad) |
| cl | Chile |
| cn | China (Zhōngguó) |
| co | Colombia |
| cd | Congo, Republic of |
| cr | Costa Rica |
| hr | Croatia (Hrvatska) |
| cy | Cyprus (Kypros) |
| cz | Czech Republic (Česká Republika) |
| dk | Denmark (Danmark) |
| dm | Dominica |
| do | Dominican Republic (República Dominicana) |
| ec | Ecuador |
| eg | Egypt (مصر) |
| sv | El Salvador |
| ee | Estonia (Eesti) |
| fj | Fiji |
| fi | Finland (Suomi) |
| fr | France |
| gm | Gambia |
| de | Germany (Deutschland) |
| gh | Ghana |
| gr | Greece (Hellas) |
| gd | Grenada |
| gt | Guatemala |
| gw | Guinea Bissau (Guiné Bissau) |
| gy | Guyana |
| hn | Honduras |
| hk | Hong Kong (香港) |
| hu | Hungary (Magyarország) |
| is | Iceland (Ísland) |
| in | India |
| id | Indonesia |
| ie | Ireland (Éire) |
| il | Israel (إسرائيل) |
| it | Italy (Italia) |
| jm | Jamaica |
| jp | Japan (日本) |
| jo | Jordan (الأردن) |
| kz | Kazakhstan (Қазақстан) |
| ke | Kenya |
| kw | Kuwait (الكويت) |
| kg | Kyrgyzstan (Кыргызстан) |
| la | Laos (Lao) |
| lv | Latvia (Latvija) |
| lb | Lebanon (لبنان) |
| lr | Liberia |
| lt | Lithuania (Lietuva) |
| lu | Luxembourg (Lëtzebuerg) |
| mo | Macau |
| mk | Macedonia (Makedonija) |
| mg | Madagascar (Madagasikara) |
| mw | Malawi |
| my | Malaysia |
| ml | Mali |
| mt | Malta, Republic of |
| mr | Mauritania (Muritan) |
| mu | Mauritius (Maurice) |
| mx | Mexico (México) |
| fm | Micronesian, Federated States of |
| mn | Mongolia (Mongol Uls) |
| ms | Montserrat |
| md | Moldova |
| mz | Mozambique (Moçambique) |
| na | Namibia |
| np | Nepal (Nepāla) |
| nl | Netherlands (Nederland) |
| nz | New Zealand |
| ni | Nicaragua |
| ne | Niger |
| ng | Nigeria |
| no | Norway (Norge) |
| om | Oman (عُمان) |
| pk | Pakistan (پاکستان) |
| pw | Palau (Belau) |
| pa | Panama (Panamá) |
| gn | Papua New Guinea |
| py | Paraguay |
| pe | Peru (Perú) |
| ph | Philippines (Pilipinas) |
| pl | Poland (Polska) |
| pt | Portugal |
| qa | Qatar (قطر) |
| ro | Romania (România) |
| ru | Russia (Россия) |
| kn | St. Kitts & Nevis |
| lc | St. Lucia |
| vc | St. Vincent & The Grenadines |
| st | Sao Tome e Principe (São Tomé e Príncipe) |
| sa | Saudi Arabia (المملكة العربية السعودية) |
| sn | Senegal (Sénégal) |
| sc | Seychelles (Sesel) |
| sl | Sierra Leone |
| sg | Singapore |
| sk | Slovakia (Slovensko) |
| sj | Slovenia (Slovenija) |
| sb | Soloman Islands |
| za | South Africa (Suid-Afrika) |
| kr | South Korea (한국) |
| es | Spain (España) |
| lk | Sri Lanka (Sri Lankā) |
| sr | Suriname |
| sz | Swaziland |
| se | Sweden (Sverige) |
| ch | Switzerland (Schweiz) |
| tw | Taiwan (中華民國) |
| tj | Tajikistan (Тоҷикистон) |
| tz | Tanzania |
| th | Thailand (ประเทศไทย) |
| tt | Trinidad & Tobago |
| tn | Tunisia (Tunes) |
| tr | Turkey (Türkiye) |
| tm | Turkmenistan (Türkmenistan) |
| tc | Turks & Caicos |
| ug | Uganda |
| ua | Ukraine (Україна) |
| ae | United Arab Emirates (الإمارات العربيّة المتّحدة) |
| gb | United Kingdom |
| us | United States |
| uy | Uruguay (República Oriental del Uruguay) |
| uz | Uzbekistan (Ўзбекистон) |
| ve | Venezuela |
| vn | Vietnam (Việt Nam) |
| ye | Yemen (اليمن) |
| zw | Zimbabwe |
Supported values for "language" parameter
| Value | Language |
|---|---|
| af | Afrikaans |
| sq | Albanian (Shqip) |
| sm | Amharic |
| ar | Arabic (العربية) |
| az | Azerbaijani (Azərbaycanca) |
| eu | Basque (Euskal) |
| be | Belarusian (Беларуская) |
| bn | Bengali (বাঙ্গালী) |
| bh | Bihari (বিহারী) |
| bs | Bosnian (Bosanski) |
| bg | Bulgarian (Български) |
| ca | Catalan (Català) |
| zh-CN | Chinese - Simplified (中国 - 简体) |
| zh-TW | Chinese - Traditional (中文 - 繁體) |
| hr | Croatian (Hrvatski) |
| cs | Czech (Čeština) |
| da | Danish (Dansk) |
| nl | Dutch (Nederlands) |
| en | English |
| eo | Esperanto |
| et | Estonian (Eesti) |
| fo | Faroese (Føroyskt) |
| fi | Finnish (Suomi) |
| fr | French (Français) |
| fy | Frisian |
| gl | Galician (Galego) |
| ka | Georgian (ქართული) |
| de | German (Deutsch) |
| el | Greek (ελληνικά) |
| gu | Gujarati (ગુજરાતી) |
| iw | Hebrew (עברית) |
| hi | Hindi (हिंदी) |
| hu | Hungarian (Magyar) |
| is | Icelandic |
| id | Indonesian (Bahasa Indonesia) |
| ia | Interlingua |
| ga | Irish (Gaeilge) |
| it | Italian (Italiano) |
| ja | Japanese (日本語) |
| jw | Javanese (Jawa) |
| kn | Kannada (ಕನ್ನಡ) |
| ko | Korean (한국어) |
| la | Latin (Latine) |
| lv | Latvian (Latviešu Valoda) |
| lt | Lithuanian (Lietuvių Kalba) |
| mk | Macedonian (Македонски Јазик) |
| ms | Malay (Bahasa Melayu) |
| ml | Malayam (മലയാളം) |
| mt | Maltese (Malti) |
| mr | Marathi (मराठी) |
| mn | Mongolian (Монгол) |
| ne | Nepali (नेपाली) |
| no | Norwegian (Norsk) |
| nn | Norwegian (Nynorsk) |
| oc | Occitan (Lenga d'òc) |
| fa | Persian (فارسی) |
| pl | Polish (Polski) |
| pt-BR | Portuguese - Brazil (Português - Brasil) |
| pt-PT | Portuguese - Portugal (Português - Portugal) |
| pa | Punjabi (ਪੰਜਾਬੀ ਦੇ) |
| ro | Romanian (Român) |
| ru | Russian (Русский) |
| gd | Scottish Gaelic (Gàidhlig) |
| sr | Serbian (Cрпски) |
| si | Sinhalese (සිංහල) |
| sk | Slovak (Slovenský) |
| sl | Slovenian (Slovenščina) |
| es | Spanish (Español) |
| su | Sudanese |
| sw | Swahili (Kiswahili) |
| sv | Swedish (Svenska) |
| tl | Tagalog |
| ta | Tamil (தமிழ்) |
| te | Telugu |
| th | Thai (ภาษาไทย) |
| ti | Tigrinya (ትግርኛ) |
| tr | Turkish (Türk) |
| uk | Ukrainian (Українська) |
| ur | Urdu (اُردُو) |
| uz | Uzbek (O'zbekcha) |
| vi | Vietnamese (Việt) |
| cy | Welsh (Cymraeg) |
| xh | Xhosa |
| zu | Zulu |
| Value | Language |
|---|---|
| ar | Arabic (العربية) |
| bg | Bulgarian (Български) |
| ca | Catalan (Català) |
| zh_CN | Chinese - Simplified (中国 - 简体) |
| zh_TW | Chinese - Traditional (中文 - 繁體) |
| hr | Croatian (Hrvatski) |
| cs | Czech (Čeština) |
| da | Danish (Dansk) |
| en | English |
| et | Estonian (Eesti) |
| nl | Dutch (Nederlands) |
| fi | Finnish (Suomi) |
| fr | French (Français) |
| de | German (Deutsch) |
| el | Greek (ελληνικά) |
| iw | Hebrew (עברית) |
| hi | Hindi (हिंदी) |
| hu | Hungarian (Magyar) |
| is | Icelandic |
| id | Indonesian (Bahasa Indonesia) |
| it | Italian (Italiano) |
| ja | Japanese (日本語) |
| ko | Korean (한국어) |
| lv | Latvian (Latviešu Valoda) |
| lt | Lithuanian (Lietuvių Kalba) |
| mn | Mongolian (Монгол) |
| no | Norwegian (Norsk) |
| pl | Polish (Polski) |
| pt | Portuguese (Português) |
| ro | Romanian (Român) |
| ru | Russian (Русский) |
| sr | Serbian (Cрпски) |
| sk | Slovak (Slovenský) |
| sl | Slovenian (Slovenščina) |
| es | Spanish (Español) |
| sv | Swedish (Svenska) |
| tl | Tagalog |
| th | Thai (ภาษาไทย) |
| tr | Turkish (Türk) |
| uk | Ukrainian (Українська) |
| ur | Urdu (اُردُو) |
| vi | Vietnamese (Việt) |
| Value | Language |
|---|---|
| ar | Arabic (العربية) |
| zh | Chinese (中国) |
| nl | Dutch (Nederlands) |
| en | English |
| fr | French (Français) |
| de | German (Deutsch) |
| it | Italian (Italiano) |
| ja | Japanese (日本語) |
| ko | Korean (한국어) |
| nb | Norwegian (Bokmål) |
| pl | Polish (Polski) |
| pt | Portuguese (Português) |
| ru | Russian (Русский) |
| es | Spanish (Español) |
| sv | Swedish (Svenska) |
| tr | Turkish (Türk) |
| Value | Language |
|---|---|
| zh | Chinese (中国) |
| nl | Dutch (Nederlands) |
| en | English |
| fr | French (Français) |
| de | German (Deutsch) |
| it | Italian (Italiano) |
| ja | Japanese (日本語) |
| pt | Portuguese (Português) |
| es | Spanish (Español) |
| Value | Language |
|---|---|
| zh-CN | Chinese - Simplified (中国 - 简体) |
| zh-TW | Chinese - Traditional (中文 - 繁體) |
| nl | Dutch (Nederlands) |
| en | English |
| fr | French (Français) |
| de | German (Deutsch) |
| hi | Hindi (हिंदी) |
| it | Italian (Italiano) |
| ja | Japanese (日本語) |
| ms | Malay (Bahasa Melayu) |
| pl | Polish (Polski) |
| es | Spanish (Español) |
| sv | Swedish (Svenska) |
| th | Thai (ภาษาไทย) |
| vi | Vietnamese (Việt) |
| Value | Language |
|---|---|
| ar | Arabic (العربية) |
| ca | Catalan (Català) |
| zh-CN | Chinese - Simplified (中国 - 简体) |
| zh-TW | Chinese - Traditional (中文 - 繁體) |
| hr | Croatian (Hrvatski) |
| cs | Czech (Čeština) |
| da | Danish (Dansk) |
| nl | Dutch (Nederlands) |
| en | English |
| fi | Finnish (Suomi) |
| fr | French (Français) |
| de | German (Deutsch) |
| el | Greek (ελληνικά) |
| iw | Hebrew (עברית) |
| hi | Hindi (हिंदी) |
| hu | Hungarian (Magyar) |
| id | Indonesian (Bahasa Indonesia) |
| it | Italian (Italiano) |
| ja | Japanese (日本語) |
| ko | Korean (한국어) |
| ms | Malay (Bahasa Melayu) |
| no | Norwegian (Norsk) |
| pl | Polish (Polski) |
| pt-BR | Portuguese - Brazil (Português - Brasil) |
| pt-PT | Portuguese - Portugal (Português - Portugal) |
| ro | Romanian (Român) |
| ru | Russian (Русский) |
| sk | Slovak (Slovenský) |
| es | Spanish (Español) |
| sv | Swedish (Svenska) |
| th | Thai (ภาษาไทย) |
| tr | Turkish (Türk) |
| uk | Ukrainian (Українська) |
| vi | Vietnamese (Việt) |
Supported values for "metrics_location" parameter
Please note that maximum 10 locations are accepted in a single API request.
Supported values for "metrics_language" parameter
| Value | Language |
|---|---|
| ar | Arabic (العربية) |
| bg | Bulgarian (Български) |
| ca | Catalan (Català) |
| zh-CN | Chinese - Simplified (中国 - 简体) |
| zh-TW | Chinese - Traditional (中文 - 繁體) |
| hr | Croatian (Hrvatski) |
| cs | Czech (Čeština) |
| da | Danish (Dansk) |
| nl | Dutch (Nederlands) |
| en | English |
| et | Estonian (Eesti) |
| tl | Filipino (Tagalog) |
| fi | Finnish (Suomi) |
| fr | French (Français) |
| de | German (Deutsch) |
| el | Greek (ελληνικά) |
| iw | Hebrew (עברית) |
| hi | Hindi (हिंदी) |
| hu | Hungarian (Magyar) |
| is | Icelandic |
| id | Indonesian (Bahasa Indonesia) |
| it | Italian (Italiano) |
| ja | Japanese (日本語) |
| ko | Korean (한국어) |
| lv | Latvian (Latviešu Valoda) |
| lt | Lithuanian (Lietuvių Kalba) |
| ms | Malay (Bahasa Melayu) |
| no | Norwegian (Norsk) |
| fa | Persian (فارسی) |
| pl | Polish (Polski) |
| pt | Portuguese (Português) |
| ro | Romanian (Român) |
| ru | Russian (Русский) |
| sr | Serbian (Cрпски) |
| sk | Slovak (Slovenský) |
| sl | Slovenian (Slovenščina) |
| es | Spanish (Español) |
| sv | Swedish (Svenska) |
| th | Thai (ภาษาไทย) |
| tr | Turkish (Türk) |
| uk | Ukrainian (Українська) |
| ur | Urdu (اُردُو) |
| vi | Vietnamese (Việt) |
Supported values for "metrics_network" parameter
| Value | Description |
|---|---|
| googlesearch | |
| 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 |