Мы запустили рейтинг зарплат интернет-маркетологов! Прими участие в анонимном опросе.

Закрыть

Сравнение доменов (domains_intersection)

domains_intersection — метод возвращает общие ключевые слова для доменов.

Пагинация

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

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

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

Example PHP Python

Request data:

api.serpstat.com/v3/domains_intersection?query=domain1,domain2,domain3&se=XXX&token=XXX

Response data:

{  
   "result":{  
      "total":18,
      "hits":[

         {  
            "keyword":"example",
            "keyword_length":1,
            "keyword_id":15894313,
            "keyword_crc":548882016,
            "date":"2017-10-09",
            "types":[  
               "ads_top",
               "related_search"
            ],
            "found_results":135000,
            "cost":0.040297,
            "concurrency":7,
            "region_queries_count":2900,
            "region_queries_count_wide":0,
            "region_queries_count_last":4400,
            "url_crc":-1081796528,
            "geo_names":[  

            ],
            "traff":870,
            "domain2":"example.com",
            "subdomain2":null,
            "url2":"https:\/\/example.com\/",
            "position2":88,
            "dynamic2":3,
            "domain1":"example.com",
            "subdomain1":null,
            "url1":"https:\/\/example.com\/",
            "position1":16,
            "dynamic1":-3,
            "domain3":"example.com",
            "subdomain3":"www.example.com",
            "url3":"https:\/\/www.example.com\/",
            "position3":9,
            "dynamic3":-4
         }
      ]
   },
   "status_msg":"OK",
   "status_code":200,
   "left_lines":9560
}

<?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',
];
$domains = ['example.com','example1.com','example2.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\DomainsIntersectionMethod(
    $domains,
    \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 = 'domains_intersection'

params = {
    'query': ','.join(['example1.com', 'example2.com', 'example3.com']),
    'se': 'g_us',
    'token': 'ijmiom4f5m34905g03um8342dm04923lre3w'}

api_url = "{host}/{method}?{params}".format(
    host=host,
    method=method,
    params=urlencode(params, safe=',')
)

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)