Keyword Tool API (V1) Documentation

Endpoints

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

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.

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

Supported values for "language" parameter

Supported values for "output" parameter

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 = [

    '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));

    }

});

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

Limits

You can make up to 5 API requests per minute and 7,200 API requests daily ¹ . Every API request will return up to 760+ keywords for Google and YouTube, 1,900+ for Bing, and 760+ for Amazon. ²

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

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

Error Codes