Домени-конкуренти в пошуковій видачі (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 рядків що залишилися

Частина відповіді API, за яку знімається 1 ліміт:

{
"domain": "kicksusa.com",
"visible": 10.99955,
"keywords": 300529,
"traff": 4565959,
"visible_dynamic": -1.14701,
"keywords_dynamic": -256,
"traff_dynamic": -1043552,
"ads_dynamic": 0,
"new_keywords": 3644,
"out_keywords": 3900,
"rised_keywords": 3914,
"down_keywords": 5986,
"ad_keywords": 1,
"ads": 1,
"intersected": 209719,
"not_intersected": 90810,
"relevance": 69.78,
"new_relevance": 8.99,
"our_relevance": 9.36
}

Example PHP Python

Request data:

Конкуренты для домену:

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

Конкуренты для ключу:

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

Response data:

{
  "result": [
    {
      "domain": "nike.com",
      "visible": 222.73664,
      "keywords": 2241695,
      "traff": 186806239,
      "visible_dynamic": 0,
      "keywords_dynamic": 0,
      "traff_dynamic": 0,
      "ads_dynamic": 0,
      "new_keywords": 220163,
      "out_keywords": 56190,
      "rised_keywords": 44456,
      "down_keywords": 66590,
      "ad_keywords": 4704,
      "ads": 3546,
      "prev_date": null,
      "intersected": 2241695,
      "relevance": 100,
      "new_relevance": 100,
      "our_relevance": 100
    },
    {
      "domain": "kicksusa.com",
      "visible": 10.99955,
      "keywords": 300529,
      "traff": 4565959,
      "visible_dynamic": -1.14701,
      "keywords_dynamic": -256,
      "traff_dynamic": -1043552,
      "ads_dynamic": 0,
      "new_keywords": 3644,
      "out_keywords": 3900,
      "rised_keywords": 3914,
      "down_keywords": 5986,
      "ad_keywords": 1,
      "ads": 1,
      "intersected": 209719,
      "not_intersected": 90810,
      "relevance": 69.78,
      "new_relevance": 8.99,
      "our_relevance": 9.36
    }
  ],
  "status_msg": "OK",
  "status_code": 200,
  "left_lines": 947652
}

<?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)