Обзор ключевых слов (keyword_info)

keyword_info — метод возвращает данные по ключевому слову.

Метрики	Описание
result	Инкапсулирует в себе ответ
total	Количество найденных ключевых фраз, по которым ранжируется данный домен в топ-100
keyword	Заданная ключевая фраза
difficulty	Оценка уровня конкуренции по ключевой фразе для продвижения в ТОП-10. Градация сложности рассчитывается от 0 до 100, где: 0-20 - легко; 21-40 - средне; 41-60 - сложно; 61-100 - очень сложно.
cost	Цена за клик, $
concurrency	Конкуренция ключевой фразы в PPC (0-100)
found_results	Количество найденных результатов по ключевой фразе ""keyword""
region_queries_count	Частотность ключевой фразы в выбранном регионе
region_queries_count_wide	Частотность ключевой фразы в широком соответствии
geo_names	Список топонимов в массиве, если топоним присутствует в ключевой фразе. Если нет — массив пустой.
social_domains	Социальные домены, которые находятся в топ-10 по заданной фразе
right_spelling	Рекомендация к исправлению для ключевой фразы с орфографической ошибкой
keyword_length	Количество слов, разделенных пробелом в ключевой фразе
lang	Язык
keyword_id	ID ключевой фразы в нашей базе
status_msg	Ответ: "OK" или "Error" сообщает об удачном или неудачном запросе
status_code	Код ответа "200" — успешный запрос. В других случаях — превышение лимитов (количество одновременных запросов или ограничение по лимитам аккаунта)
left_lines	Количество оставшихся API строк

Example PHP Python

Request data:

api.serpstat.com/v3/keyword_info?query=XXX&token=XXX&se=XXX

Response data:

"{  
   ""result"":{  
      ""keyword"":""example"",
      ""cost"":0.12,
      ""difficulty"":12,
      ""concurrency"":7,
      ""found_results"":88,
      ""region_queries_count"":2400,
      ""region_queries_count_wide"":0,
      ""types"":[  

      ],
      ""geo_names"":[  

      ],
      ""social_domains"":[  
         ""facebook"",
         ""vk"",
         ""youtube"",
         ""twitter"",
         ""instagram""
      ],
      ""right_spelling"":null,
      ""keyword_length"":1,
      ""lang"":""en"",
      ""keyword_id"":""4937779"",
      ""suggestions_count"":169,
      ""keywords_count"":0
   },
   ""status_msg"":""OK"",
   ""status_code"":200,
   ""left_lines"":998814
}"

<?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',
];
$keyword = 'keyword';
// 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\KeywordInfoMethod(
    $keyword,
    \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_info'
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)