Top for a keyword (keyword_top)

keyword_top

This report shows you Google top 100 organic search results for the keyword you requested.

Metrics	Description
result	Encapsulates the answer
results	Number of results
top	Encapsulates the result
url	Page that is ranking on the ""position""
domain	Domain
position	Domain's position for a keyword
ads	Ads found
status_msg	Response "OK" or "Error" report on a successful or unsuccessful request
status_code	Response code "200" — successful request. Errors occur when limits are exceeded (number of simultaneous requests or account limits)
left_lines	Number of remaining API queries

Example PHP Python

Request data:

api.serpstat.com/v3/keyword_top?query=buy%20laptop&token=XXX&se=XXX

Response data:

// http://api.serpstat.com/v3/keyword_top?query=buy%20laptop&token=XXX&se=g_ua

{
  "result": {
    "top": [
      {
        "position": 1,
        "url": "https://www.bestbuy.com/site/computers-pcs/laptop-computers/abcat0502000.c?id=abcat0502000",
        "domain": "bestbuy.com",
        "subdomain": "www.bestbuy.com",
        "types": [
          "related_search",
          "snip_info"
        ]
      },
      {
        "position": 2,
        "url": "https://www.amazon.com/Notebooks-Laptop-Computers/b?ie=UTF8&node=565108",
        "domain": "amazon.com",
        "subdomain": "www.amazon.com",
        "types": [
          "related_search",
          "snip_info"
        ]
      },
      ""ads"":[  

      ]
   },
   ""status_msg"":""OK"",
   ""status_code"":200,
   ""left_lines"":998691
}"

<?php
// This example works on serpstat-sdk only
// https://github.com/SerpstatGlobal/serpstat-sdk

require_once __DIR__ . '/../vendor/autoload.php';
// configure your application
$config = [
    'token' => '19666fc1ae1724da1d5ea2f3a99d5f5a',
];
$keywords = 'keywords';
// init client with your serpstat api token
$apiClient = new \Serpstat\Sdk\Core\ApiGuzzleHttpClient($config['token']);
// create instance of any api method class
// list of methods classes in folder src\Methods
$apiMethod = new \Serpstat\Sdk\Methods\KeywordTopMethod(
    $keywords,
    \Serpstat\Sdk\Interfaces\IApiClient::SE_GOOGLE_RU
);
try {
    // try call api method
    $response = $apiClient->call($apiMethod);
} catch (\Exception $e) {
    // catch api error
    $response = $e->getMessage();
}

import codecs
import json
import pprint
import urllib.request as urlrequest
from urllib.parse import urlencode

host = 'http://api.serpstat.com/v3'

method = 'keyword_top'
params = {
    'query': 'buy%20laptop',  # string for get info
    'se': 'g_us',  # string search engine
    'token': 'ijmiom4f5m34905g03um8342dm04923lre3w',  # string personal token
}

api_url = "{host}/{method}?{params}".format(
    host=host,
    method=method,
    params=urlencode(params)
)

try:
    json_data = urlrequest.urlopen(api_url).read()
except Exception as e0:
    print("API request error: {error}".format(error=e0))

data = json.loads(json_data)
pprint.pprint(data)