Доступные даты для выгрузок поисковых запросов
Позволяет получить список дат, по которым доступны данные для выгрузки.
Формат запроса
GET /v4/user/{user-id}/hosts/{host-id}/pro/serp/dates
Параметр |
Тип |
Обязательно |
Описание |
|
|
Да |
ID пользователя. Необходим для вызова любых ресурсов API Яндекс Вебмастера. Чтобы получить его, используйте метод GET /v4/user. |
|
|
Да |
ID сайта. Чтобы получить его, используйте метод GET /v4/user/{user‑id}/hosts. |
Заголовки запроса
Для запроса необходимо указать два HTTP-заголовка:
-
Authorization
Authorization: OAuth {ваш_токен}
-
Accept
Accept: application/json
Пример запроса
GET https://api.webmaster.yandex.net/v4/user/{user-id}/hosts/{host-id}/pro/serp/dates
Формат ответа
Пример
{
"dates": [
"2025-09-20",
"2025-09-10",
"2025-09-01"
]
}
Параметр |
Тип |
Обязательно |
Описание |
|
|
Да |
Список дат, по которым доступны данные для выгрузки. |
Коды ответа
Чтобы посмотреть структуру ответа подробнее, нажмите на причину.
Код |
Причина |
Описание |
200 |
OK |
Успешно. |
400 |
Регионы некорректны.
|
|
400 |
Пустые пути.
|
|
400 |
Пустые даты.
|
|
400 |
Некоторые даты недоступны (слишком старые или еще не обработаны).
|
|
400 |
Некоторые переданные пути/URL некорректны.
|
|
403 |
Превышены лимиты расширенного доступа.
|
|
413 |
Превышен размер запроса по количеству дат и URL.
|
Узнайте больше
OAuth-токен для доступа к API.
Указывает, что ответ должен быть в формате JSON.
Тип: int64
. ID пользователя. Необходим для вызова любых ресурсов API Яндекс Вебмастера. Чтобы получить его, используйте метод GET /v4/user.
Тип: host id (string)
. ID сайта. Чтобы получить его, используйте метод GET /v4/user/{user‑id}/hosts.
Тип: integer
. Максимально допустимый суммарный размер (дат + URL).
Тип: string
. Полный список недоступных дат.