Getting TIC history

Description

Gets the history of changes to the site's TIC (Citation Index) value over the past six months, including the current month. For each month, the list contains dates when the TIC value changed. If the TIC did not change in a certain month, the list will have a single entry for this month with the value of the TIC at that time.

Request format

Send a GET request to the operation address for the tic-history resource for the user's site.

GET https://api.webmaster.yandex.net/v3/user/{user-id}/hosts/{host-id}/tic-history/[&date_from={date_from}&date_to={date_to}]

Path parameters

Name Required Type Default value Description
user-id Yes int64 The user ID.
host-id Yes host id Site ID.

Query arguments

Name Required Type Default value Description
date_from No yyyy-MM-ddTHH:mm:ss,sssZ Start of the data range to display.
date_to No yyyy-MM-ddTHH:mm:ss,sssZ End of the data range to display.

Response format

If successful, the server returns 200 OK and the history of TIC values:

Samples

{
  "points": [
    {
      "date": "2016-01-01T00:00:00,000+0300",
      "value": 1
    }, ...
  ]
}
Name Required Type Description
Date Yes yyyy-MM-ddTHH:mm:ss,sssZ Date.
value Yes int64 Indicator value.

Errors

403 Forbidden

The user ID for the token doesn't match the one specified in the request. In the examples below, {user_id} is the correct uid for the owner of the OAuth token.

{
  "error_code": "INVALID_USER_ID",
  "available_user_id": 1,
  "error_message": "Invalid user id. {user_id} should be used."
}
Parameter Description
error_code Error code.
available_user_id ID of the user who allowed access.
error_message Error message.

404 Not Found

  • HOST_NOT_INDEXED error

    {
      "error_code": "HOST_NOT_INDEXED",
      "host_id": "http:ya.ru:80",
      "error_message": "explicit error message"
    }
    Parameter Description
    error_code The site hasn't been indexed yet.
    host_id Site ID.
    error_message Error message.
  • HOST_NOT_LOADED error

    {
      "error_code": "HOST_NOT_LOADED",
      "host_id": "http:ya.ru:80",
      "error_message": "explicit error message"
    }
    Parameter Description
    error_code The site data hasn't been loaded to Yandex.Webmaster yet.
    host_id Site ID.
    error_message Error message.
  • HOST_NOT_VERIFIED error

    {
      "error_code": "HOST_NOT_VERIFIED",
      "host_id": "http:ya.ru:80",
      "error_message": "explicit error message"
    }
    Parameter Description
    error_code The site hasn't been added to the list of sites, or the user hasn't verified site management rights.
    host_id Site ID.
    error_message Error message.