Получение истории появления и исключения страниц из поиска
Возвращает количество страниц, появившихся в поиске и исключенных из него, за определенный период. По умолчанию возвращаются данные за текущий день.
Формат запроса
GET https://api.webmaster.yandex.net/v4/user/{user-id}/hosts/{host-id}/search-urls/events/history
? [date_from=<datetime>]
& [date_to=<datetime>]
user-id | Тип: int64. ID пользователя. Необходим для вызова любых ресурсов API Яндекс Вебмастера. Чтобы получить его, используйте метод GET /v4/user. |
host-id | Тип: host id (string). ID сайта. Чтобы получить его, используйте метод GET /v4/user/{user-id}/hosts. |
user-id | Тип: int64. ID пользователя. Необходим для вызова любых ресурсов API Яндекс Вебмастера. Чтобы получить его, используйте метод GET /v4/user. |
host-id | Тип: host id (string). ID сайта. Чтобы получить его, используйте метод GET /v4/user/{user-id}/hosts. |
date_from | Начало диапазона дат. |
date_to | Конец диапазона дат. |
date_from | Начало диапазона дат. |
date_to | Конец диапазона дат. |
Формат ответа
Примеры
{
"indicators": {
"APPEARED_IN_SEARCH": [
{
"date": "2016-01-01T00:00:00,000+0300",
"value": 1
}
]
}
}
<Data>
<indicators>
<APPEARED_IN_SEARCH>
<date>2016-01-01T00:00:00,000+0300</date>
<value>1</value>
</APPEARED_IN_SEARCH>
</indicators>
</Data>
Имя | Обязательный | Тип | Описание |
---|---|---|---|
APPEARED_IN_SEARCH | Да | Состояние страницы (ApiSearchEventEnum). | |
date | Да | datetime | Дата и время обновления поисковой выдачи. |
value | Да | int64 | Количество страниц. |
Имя | Обязательный | Тип | Описание |
---|---|---|---|
APPEARED_IN_SEARCH | Да | Состояние страницы (ApiSearchEventEnum). | |
date | Да | datetime | Дата и время обновления поисковой выдачи. |
value | Да | int64 | Количество страниц. |
Состояние страницы сайта в результатах поиска (ApiSearchEventEnum)
Индикатор | Описание |
---|---|
APPEARED_IN_SEARCH | Страница появилась в результатах поиска. |
REMOVED_FROM_SEARCH | Страница исключена из результатов поиска. |
Индикатор | Описание |
---|---|
APPEARED_IN_SEARCH | Страница появилась в результатах поиска. |
REMOVED_FROM_SEARCH | Страница исключена из результатов поиска. |
Коды ответа
Чтобы посмотреть структуру ответа подробнее, нажмите на причину.
Код | Причина | Описание |
---|---|---|
200 OK | ||
403 | ID пользователя, выдавшего токен, отличается от указанного в запросе. В примерах ниже | |
404 | HOST_NOT_VERIFIED | Не подтверждены права на управление сайтом. |
HOST_NOT_INDEXED | Сайт еще не проиндексирован. | |
HOST_NOT_LOADED | Данные о сайте еще не загружены в Яндекс Вебмастер. |
Код | Причина | Описание |
---|---|---|
200 OK | ||
403 | ID пользователя, выдавшего токен, отличается от указанного в запросе. В примерах ниже | |
404 | HOST_NOT_VERIFIED | Не подтверждены права на управление сайтом. |
HOST_NOT_INDEXED | Сайт еще не проиндексирован. | |
HOST_NOT_LOADED | Данные о сайте еще не загружены в Яндекс Вебмастер. |