Getting the history of changes to an important page

Returns information about changes to the specified page (selected in Yandex.Webmaster on the Indexing → Monitoring important pages page). For more information, see this Help section.

Request format

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

* Required

Response format

Example

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>

Parameter	Required	Type	Description
url	Yes	url	Site page URL.
update_date	No	datetime	Date and time the page status information was updated.
change_indicators	No	string (ApiImportantUrlChangeIndicator)	Indicator of changes. Contains information about what changed from the previous check.
indexing_status	No		Information about the page indexing by the robot.
status	Yes	string (IndexingStatusEnum)	Generalized status of the HTTP code.
http_code	No	int32	HTTP code.
access_date	Yes	datetime	Date the page was crawled.
search_status	No		The state of the page in the search results.
title	Yes	string	Page heading.
description	No	string	The Description meta tag content.
last_access	Yes	datetime	The date when the page was last crawled before it appeared or was excluded.
excluded_url_status	No	string (ApiExcludedUrlStatus)	The reason the page was excluded.
bad_http_status	No	int32	The page's HTTP response code for the HTTP_ERROR status.
searchable	Yes	boolean	Indicates whether the page is present in the search results. Possible values: true — If the page is included in the search. false — If the page isn't included in the search.
target_url	No	url	Another address of the page that the robot is aware of. This could be a redirect target, canonical address or a duplicate page.

Changes to important pages in the search (ApiImportantUrlChangeIndicator)

HTTP status codes received by the robot during indexing (IndexingStatusEnum)

Reasons for excluding the page from search results (ApiExcludedUrlStatus)

Response codes

To view the response structure in detail, click the reason.

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

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

Related information

• Error codes and statuses