Ключевые фразы по URL (url_keywords)

url_keywords — метод возвращает ключевые фразы в топе поисковой системы по заданному URL.

Пагинация

Для пагинации используйте параметры:

page_size : количество результатов на страницу (по умолчанию — 100, максимум — 1000);
page : номер страницы (по умолчанию — 1-я страница).

Для фильтрации результатов используйте следующие параметры:

Параметр	Описание	Возможные значения
position_from	Минимальная позиция ключевого слова	1-100
position_to	Максимальная позиция ключевого слова	1-100
queries_from	Минимальное количество запросов в месяц	0-100000000
queries_to	Максимальное количество запросов в месяц	0-100000000
cost_from	Минимальная стоимость за клик	0-200
cost_to	Максимальная стоимость за клик	0-200
concurrency_from	Минимальное значение конкуренции	1-100
concurrency_to	Максимальное значение конкуренции	1-100
right_spelling	Фильтрация по фразам с неправильным написанием	not_contains - содержит фразы с неправильным написанием; contains - не содержит фразы с неправильным написанием

Для сортировки результата используйте параметры:

sort : поле, по которому нужно выполнить сортировку;
order : направление сортировки (asc — по возрастанию, desc — по убыванию).

Метрики	Описание
result	Инкапсулирует в себе ответ
total	Количество найденных ключевых фраз, по которым ранжируется страница в топ-100
region_queries_count	Частотность ключевой фразы в выбранном регионе
region_queries_count_wide	Частотность ключевой фразы в широком соответствии
domain	Домен
keyword_length	Количество слов, разделенных пробелом в ключевой фразе
keyword	Ключевая фраза, по которой отображается объявление
url	URL, который отображается в поисковой выдаче по данному запросу
dynamic	Показывает, как изменилась позиция заданной ключевой фразы
traff	Индекс, который показывает ориентировочный трафик на сайт (количество посетителей)
keyword_crc	Контрольная сумма для быстрого поиска
types	Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое ).
found_results	Количество найденных результатов по ключевой фразе ""keywords""
url_crc	crc код от переменной ""url""
cost	Цена за клик, $
concurrency	Конкуренция ключевой фразы в PPC (0-100)
position	Позиция ключевой фразы в поисковой выдаче
keyword_id	ID ключевой фразы в нашей базе
subdomain	Поддомен сайта, который отображается в поисковой выдаче по заданной фразе
types	Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое )
geo_names	Список топонимов в массиве, если топоним присутствует в ключевой фразе. Если нет — массив пустой.
status_msg	Ответ: "OK" или "Error" сообщает об удачном или неудачном запросе
status_code	Код ответа "200" — успешный запрос. В других случаях — превышение лимитов (количество одновременных запросов или ограничение по лимитам аккаунта)
left_lines	Количество оставшихся API строк

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

{
"region_queries_count": 10,
"domain": "example.com",
"keyword_length": 2,
"keyword": "site example.com",
"url": "https://example.com/",
"dynamic": null,
"traff": 1,
"found_results": "36500000",
"cost": 0,
"concurrency": 0,
"position": 2,
"subdomain": null,
"region_queries_count_wide": 0,
"types": [

],
"geo_names": [

],
"_id": "239122007-2"
}

Example PHP Python

Request data:

api.serpstat.com/v3/url_keywords?query=http://example.com/page.html&token=XXX&se=XXX

Response data:

{
  "result": {
    "total": 9,
    "hits": [
      {
        "region_queries_count": 10,
        "domain": "example.com",
        "keyword_length": 3,
        "keyword": "example for domain",
        "url": "https://example.com/",
        "dynamic": 2,
        "traff": 1,
        "found_results": "451000000",
        "cost": 5.83,
        "concurrency": 67,
        "position": 2,
        "subdomain": null,
        "region_queries_count_wide": 0,
        "types": [
          "also_asks",
          "graph"
        ],
        "geo_names": [
          
        ],
        "difficulty": 17.78,
        "_id": "6388089-2"
      },
      {
        "region_queries_count": 10,
        "domain": "example.com",
        "keyword_length": 2,
        "keyword": "site example.com",
        "url": "https://example.com/",
        "dynamic": null,
        "traff": 1,
        "found_results": "36500000",
        "cost": 0,
        "concurrency": 0,
        "position": 2,
        "subdomain": null,
        "region_queries_count_wide": 0,
        "types": [
          
        ],
        "geo_names": [
          
        ],
        "_id": "239122007-2"
      },
    ]
  },
  "status_msg": "OK",
  "status_code": 200,
  "left_lines": 343980
}

<?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',
];
$url = 'http://example.com/page1/';
// 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\UrlKeywordsMethod(
    $url,
    \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 = 'url_keywords'
params = {
    'query': 'http%3A%2F%2Fwww.amazon.com%2FWinter-Is-Coming%2Fdp%2FB007HJ84ZK',  # 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)"