Топ по ключевой фразе (keyword_top)

keyword_top — метод возвращает последний топ 100 в Google или топ 50 в Яндексе по ключевой фразе.

Метрики	Описание
result	Инкапсулирует в себе ответ
results	Количество результатов
top	Инкапсулирует результат
url	Страница которая находится на позиции (указано в ""position"")
domain	Домен
position	Позиция по ключевой фразе в поисковой выдаче
ads	Инкапсулирует результаты контекстной рекламы (если она есть)
status_msg	Ответ: "OK" или "Error" сообщает об удачном или неудачном запросе
status_code	Код ответа "200" — успешный запрос. В других случаях — превышение лимитов (количество одновременных запросов или ограничение по лимитам аккаунта)
left_lines	Количество оставшихся API строк

Часть ответа API, за которую снимается 1 лимит:

{
"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"
]
}

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)

Топ по ключевой фразе (keyword_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": 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"
]
}