Получение истории изменений важной страницы

Возвращает информацию об изменении указанной страницы (выбранной в Вебмастере на странице Индексирование → Мониторинг важных страниц). Подробно см. в Помощи.

Формат запроса

GET https://api.webmaster.yandex.net/v4/user/{user-id}/hosts/{host-id}/important-urls/history
  ? (url=<url>)

* Обязательный параметр

Формат ответа

Пример

JSON

XML

{
    "history": [
        {
            "url": "https://example.com/",
            "update_date": "2019-09-05T00:00:00.000+03:00",
            "change_indicators": [],
            "indexing_status": {
                "status": "HTTP_2XX",
                "http_code": 200,
                "access_date": "2019-09-04T00:00:00.000+03:00"
            },
            "search_status": {
                "title": "some string",
                "description": "some string",
                "last_access": "2019-09-02T00:00:00.000+03:00",
                "excluded_url_status": NOTHING_FOUND,
                "bad_http_status": 500,
                "searchable": true,
                "target_url": "https://example.com/some/path?a=b"
            }
        }
    ]
}

<Data>
    <url>https://example.com</url>
    <update_date>2019-09-05T00:00:00.000+03:00</update_date>
    <change_indicators>...</change_indicators>
    <indexing_status>
        <status>HTTP_2XX</status>
        <http_code>200</http_code>
        <access_date>2019-09-04T00:00:00.000+03:00</access_date>
    </indexing_status>
    <search_status>
        <title>some string</title>
        <description>some string</description>
        <last_access>2019-09-02T00:00:00.000+03:00<last_access/>
        <excluded_url_status>NOTHING_FOUND</excluded_url_status>
        <bad_http_status>500</bad_http_status>
        <searchable>true</searchable>
        <target_url>https://example.com/some/path?a=b</target_url>
    <search_status/>
</Data>

Параметр	Обязательный	Тип	Описание
url	Да	url	Адрес страницы сайта.
update_date	Нет	datetime	Дата и время обновления информации о состоянии страницы.
change_indicators	Нет	string (ApiImportantUrlChangeIndicator)	Индикатор изменений. Содержит информацию о том, что изменилось по сравнению с предыдущей проверкой.
indexing_status	Нет		Информация об индексировании страницы роботом.
status	Да	string (IndexingStatusEnum)	Обобщенный статус HTTP-кода.
http_code	Нет	int32	HTTP-код.
access_date	Да	datetime	Дата обхода страницы.
search_status	Нет		Состояние страницы в результатах поиска.
title	Да	string	Заголовок страницы.
description	Нет	string	Содержимое метатега Description.
last_access	Да	datetime	Дата последнего обхода страницы до ее появления или исключения.
excluded_url_status	Нет	string (ApiExcludedUrlStatus)	Причина исключения страницы.
bad_http_status	Нет	int32	HTTP-код ответа страницы для статуса HTTP_ERROR.
searchable	Да	boolean	Признак присутствия страницы в результатах поиска. Возможные значения: true — если страница участвует в поиске; false — если страница не участвует в поиске.
target_url	Нет	url	Другой адрес страницы, по которому она известна роботу. Это может быть цель редиректа, канонический адрес или дублирующая страница.

Изменения важных страниц в поиске (ApiImportantUrlChangeIndicator)

Статусы HTTP-кода, полученные роботом при индексировании сайта (IndexingStatusEnum)

Причины исключения страницы сайта из результатов поиска (ApiExcludedUrlStatus)

Коды ответа

Чтобы посмотреть структуру ответа подробнее, нажмите на причину.

{
  "error_code": "INVALID_URL",
  "error_message": "some string"
}

<Data>
  <error_code>INVALID_URL</error_code>  
  <error_message>some string</error_message>
</Data>

Узнайте больше

• Коды ошибок и статусы