Суммарный отчет по домену

Метод SerpstatDomainProcedure.getDomainsInfo возвращает суммарную информацию по массиву доменов.
Общие параметры запроса и инструкция по использованию Serpstat API

Перечень доступных баз и стран

Параметры запроса
Параметр	Описание	Опциональный	Варианты значений
id	Идентификатор запроса: ответ будет содержать этот же идентификатор. Ввод числового (number) или текстового (string) значения.	нет	1, test
method	Название метода API	нет	SerpstatDomainProcedure.getDomainsInfo
params	Объект с параметрами {...}, в нем перечисляются все нижеследующие параметры и массивы [...]	нет
domains	Массив доменов	нет	["nike.com", "adidas.com" ]
se	Идентификатор поисковой базы, по которой будет проходить поиск (доступна Google например: g_us).	нет	g_us
filters	Условия фильтрации	да	"visible": 35 "visible_from": 20 "visible_to": 30 "traff": 1000 "traff_from": 500 "traff_to": 2000

Параметры ответа
Параметр	Описание
id	Идентификатор запроса: соответствует id в запросе
result	Содержит в себе ответ
data	Массив с данными ответа
domain	Домен, по которому получена информация
visible	Видимость сайта
keywords	Количество найденных ключевых фраз в выбранной поисковой системе
traff	Индекс, который показывает ориентировочный трафик на сайт (количество посетителей)
visible_dynamic	Динамика изменения видимости по сравнению с последней датой обновления
keywords_dynamic	Изменение количества ключевых фраз по сравнению с последней датой обновления
traff_dynamic	Изменение трафика по сравнению с последней датой обновления
ads_dynamic	Динамика изменений в объявлениях PPC
new_keywords	Количество новых ключевых фраз, которые появились у домена по сравнению с последней датой обновления
out_keywords	Количество ключевых фраз, которые потерял домен по сравнению с последней датой обновления
rised_keywords	Ключевые фразы, по которым выросли позиции по сравнению с последней датой обновления
down_keywords	Ключевые фразы, по которым упали позиции по сравнению с последней датой обновления
ad_keywords	Количество ключевых фраз в PPC
ads	Количество объявлений в PPC
prev_date	Предыдущая дата проверки
summary_info	Объект с данными ответа
page	Номер страницы
left_lines	Количество оставшихся API строк

Лимиты: за каждый домен, по которому получена информация снимается 5 лимитов. Часть ответа API, за которую снимается 5 лимитов:

{
    "domain": "adidas.com",
    "visible": 38.226520000000001,
    "keywords": 1360672,
    "traff": 54388418,
    "visible_dynamic": 0.47296000000000049,
    "keywords_dynamic": -5503,
    "traff_dynamic": -370839,
    "ads_dynamic": 66,
    "new_keywords": 21333,
    "out_keywords": 26836,
    "rised_keywords": 33457,
    "down_keywords": 31140,
    "ad_keywords": 203,
    "ads": 199,
    "prev_date": "2021-05-13"
}

Example Python

Request data:

{
 "id": "1",
 "method": "SerpstatDomainProcedure.getDomainsInfo",
 "params": {
   "domains": ["nike.com", "adidas.com"],
   "se": "g_us"
 }
}

Response data:

{
    "id": "1",
    "result": {
        "data": [
            {
                "domain": "nike.com",
                "visible": 222.88057000000001,
                "keywords": 2613344,
                "traff": 255497238,
                "visible_dynamic": 10.063649999999996,
                "keywords_dynamic": 9610,
                "traff_dynamic": 15189516,
                "ads_dynamic": -99,
                "new_keywords": 40573,
                "out_keywords": 30963,
                "rised_keywords": 49642,
                "down_keywords": 43635,
                "ad_keywords": 1098,
                "ads": 840,
                "prev_date": "2021-04-29"
            },
            {
                "domain": "adidas.com",
                "visible": 38.226520000000001,
                "keywords": 1360672,
                "traff": 54388418,
                "visible_dynamic": 0.47296000000000049,
                "keywords_dynamic": -5503,
                "traff_dynamic": -370839,
                "ads_dynamic": 66,
                "new_keywords": 21333,
                "out_keywords": 26836,
                "rised_keywords": 33457,
                "down_keywords": 31140,
                "ad_keywords": 203,
                "ads": 199,
                "prev_date": "2021-05-13"
            }
        ],
        "summary_info": {
            "page": 1,
            "left_lines": 997711
        }
    }
}

Шаблоны запросов к Serpstat API: ссылка