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