Домены-конкуренты в поисковой выдаче (competitors)

competitors — метод возвращает список конкурентов домена из топ-20 поисковой выдачи Google.

Метрики	Описание
result	Инкапсулирует в себе ответ
domain	Домен
visible	Видимость сайта
keywords	Количество найденных ключевых фраз в выбранной поисковой системе
traff	Индекс, который показывает ориентировочный трафик на сайт (количество посетителей)
visible_dynamic	Динамика изменения видимости по сравнению с последней датой обновления
keywords_dynamic	Изменение количества ключевых фраз за период времени N
traff_dynamic	Изменние трафика за последний период времени N
ads_dynamic	Изменение количетсва ключевых фраз в контекстной рекламе
new_keywords	Количество новых ключевых фраз которые появились у домена за последние N-дней
out_keywords	Количество ключевых фраз которые потерял домен за последние N-дней
rised_keywords	Ключевые фразы у которых выросли позиции за последние N-дней
down_keywords	Ключевые фразы у которых упали позиции за последние N-дней
ad_keywords	Количество ключевых фраз в PPC
ads	Количество объявлений ""date""
intersected	Количество фраз у домена, которые содержат искомую фразу
relevance	Общая релевантность домена к искомой фразе
status_msg	Ответ: "OK" или "Error" сообщает об удачном или неудачном запросе
status_code	Код ответа "200" — успешный запрос. В других случаях — превышение лимитов (количество одновременных запросов или ограничение по лимитам аккаунта)
left_lines	Количество оставшихся API строк

Example PHP Python

Request data:

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

Response data:

{  
   "result":[ 
  
       {  
         "domain":"example.com",
         "visible":37407.74866,
         "keywords":15160181,
         "traff":364513732,
         "visible_dynamic":727.32726,
         "keywords_dynamic":22173,
         "traff_dynamic":4746597,
         "ads_dynamic":14946,
         "new_keywords":73480,
         "out_keywords":51307,
         "rised_keywords":811054,
         "down_keywords":1054201,
         "ad_keywords":24252,
         "ads":2315,
         "intersected":350558,
         "not_intersected":14809623,
         "relevance":2.31,
         "new_relevance":2.29,
         "our_relevance":75.31
      }
   ],
   "status_msg":"OK",
   "status_code":200,
   "left_lines":9378
}

<?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',
];
$domain = 'example.com';
// 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\CompetitorsMethod(
    $domain,
    \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 = 'competitors'
params = {
    'query': 'example.com',  # 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)