Некоторые функции ограничены.
Вход Регистрация

Мы используем файлы cookie для обеспечения работоспособности сервиса, улучшения навигации и маркетинговых активностей Serpstat. Нажимая "Принять и продолжить", вы соглашаетесь с нашей Политика конфиденциальности

Трафик по маске URL V4 (SerpstatUrlProcedure.getSummaryTraffic)

Метод SerpstatUrlProcedure.getSummaryTraffic возвращает отчет по трафику по маске URL.

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

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

Параметры  запроса
Параметр Описание Тип данных Опциональный Варианты значений
id Идентификатор запроса: ответ содержит этот же идентификатор. Ввод числового (number) или текстового (string) значения. int/string нет 1, test
method Название метода API string нет SerpstatUrlProcedure.getSummaryTraffic
params Объект с параметрами {...}, в нем перечисляются все нижеследующие параметры и массивы [...] array нет
domain Домен, по которому нужно получить данные. string нет adidas.com
se
Идентификатор базы данных, из которой нужно получить данные (доступны базы Google и Yandex на выбор, пример: g_us, y_157).
string
нет
g_us
UrlContains
Искомая часть, входящая в URL страницы.
string
нет
/women-shoes

Параметры ответа
Параметр Описание
id Идентификатор запроса: соответствует id в запросе
result
Содержит в себе ответ
totalTraff
Суммарный органический трафик на найденные по маске URL страницы
urls
Количество URL, которые попали под условие поиска.
summary_info
Объект с данными ответа
left_lines
Количество оставшихся лимитов.

Лимиты: При подсчете использованных лимитов учитываются любые запросы по API в соответствие с вашим тарифным планом. В данном методе снимается 1000 API лимитов за 1 запрос. Часть ответа API, за которую снимается 1000 лимитов:

{
    "totalTraff": 5585240,
    "urls": 2879,
    "summary_info": {
        "left_lines": 987129
        }
}

Example
Request data:
{
 "id": 1,
 "method": "SerpstatUrlProcedure.getSummaryTraffic",
 "params" : {
  "se" : "g_us",
  "domain" : "adidas.com",
  "urlContains" : "/women-shoes"
 }
}
Response data:
{
    "id": "1",
    "result": {
        "totalTraff": 5585240,
        "urls": 2879,
        "summary_info": {
            "left_lines": 987129
        }
    }
}