Трафик по маске 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
}
}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
}
}
}