Получение истории изменения количества внешних ссылок на сайт

Внимание. Вы открыли документацию API версии 3.2. Яндекс Вебмастер перестал поддерживать версию 3.2 и ниже со второго полугодия 2020 г. Рекомендуем использовать API версии 4.1.

Возвращает историю изменения количества внешних ссылок на сайт.

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

GET https://api.webmaster.yandex.net/v3.2/user/{user-id}/hosts/{host-id}/links/external/history/?indicator={indicator}

Path-параметры


Имя	Обязательный	Тип	Значение по умолчанию	Описание
user-id	Да	`int64`		ID пользователя. Необходим для вызова любых ресурсов API Яндекс Вебмастера. Чтобы получить его, используйте метод GET /user.
host-id	Да	`host id`		ID сайта. Чтобы получить его, используйте метод GET /user/{user-id}/hosts.


Имя	Обязательный	Тип	Значение по умолчанию	Описание
user-id	Да	`int64`		ID пользователя. Необходим для вызова любых ресурсов API Яндекс Вебмастера. Чтобы получить его, используйте метод GET /user.
host-id	Да	`host id`		ID сайта. Чтобы получить его, используйте метод GET /user/{user-id}/hosts.

Query-параметры


Имя	Обязательный	Тип	Значение по умолчанию	Описание
indicator	Да	APIExternalLinksIndicator		Индикатор количества внешних ссылок.


Имя	Обязательный	Тип	Значение по умолчанию	Описание
indicator	Да	APIExternalLinksIndicator		Индикатор количества внешних ссылок.

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

Примеры

{
  "indicators": {
    "LINKS_TOTAL_COUNT": [
      {
        "date": "2016-01-01T00:00:00,000+0300",
        "value": 1
      }
    ]
  }
}

<Data>
    <indicators>
        <LINKS_TOTAL_COUNT>
            <date>2016-01-01T00:00:00,000+0300</date>
            <value>1</value>
        </LINKS_TOTAL_COUNT>
    </indicators>
</Data>


Имя	Обязательный	Тип	Описание
LINKS_TOTAL_COUNT	Да	APIExternalLinksIndicator	Индикатор количества внешних ссылок.
`date`	Да	`date`	Дата обнаружения ссылки.
`value`	Да	`string`	Значение индикатора.


Имя	Обязательный	Тип	Описание
LINKS_TOTAL_COUNT	Да	APIExternalLinksIndicator	Индикатор количества внешних ссылок.
`date`	Да	`date`	Дата обнаружения ссылки.
`value`	Да	`string`	Значение индикатора.

Индикаторы внешних ссылок (ApiExternalLinksIndicator)


Индикатор	Описание
LINKS_TOTAL_COUNT	Общее количество известных внешних ссылок на хост.

Коды ответа

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

Код Причина Описание

200 OK

403

Код	Причина	Описание
200	OK
403	INVALID_USER_ID	ID пользователя, выдавшего токен, отличается от указанного в запросе. В примерах ниже `{user_id}` указан правильный uid владельца OAuth-токена. JSON XML `{ "error_code": "INVALID_USER_ID", "available_user_id": 1, "error_message": "Invalid user id. {user_id} should be used." }` `<Data> <error_code>INVALID_USER_ID</error_code> <available_user_id>1</available_user_id> <error_message>Invalid user id. {user_id} should be used.</error_message> </Data>`
404	HOST_NOT_VERIFIED	Не подтверждены права на управление сайтом. JSON XML `{ "error_code": "HOST_NOT_VERIFIED", "host_id": "http:ya.ru:80", "error_message": "some string" }` `<Data> <error_code>HOST_NOT_VERIFIED</error_code> <host_id>http:ya.ru:80</host_id> <error_message>some string</error_message> </Data>`

INVALID_USER_ID

ID пользователя, выдавшего токен, отличается от указанного в запросе. В примерах ниже {user_id} указан правильный uid владельца OAuth-токена.

{
  "error_code": "INVALID_USER_ID",
  "available_user_id": 1,
  "error_message": "Invalid user id. {user_id} should be used."
}

<Data>
    <error_code>INVALID_USER_ID</error_code>
    <available_user_id>1</available_user_id>
    <error_message>Invalid user id. {user_id} should be used.</error_message>
</Data>

404

HOST_NOT_VERIFIED

Не подтверждены права на управление сайтом.

{
  "error_code": "HOST_NOT_VERIFIED",
  "host_id": "http:ya.ru:80",
  "error_message": "some string"
}

<Data>
  <error_code>HOST_NOT_VERIFIED</error_code>  
  <host_id>http:ya.ru:80</host_id>
  <error_message>some string</error_message>
</Data>

Код Причина Описание

200 OK

403

Код	Причина	Описание
200	OK
403	INVALID_USER_ID	ID пользователя, выдавшего токен, отличается от указанного в запросе. В примерах ниже `{user_id}` указан правильный uid владельца OAuth-токена. JSON XML `{ "error_code": "INVALID_USER_ID", "available_user_id": 1, "error_message": "Invalid user id. {user_id} should be used." }` `<Data> <error_code>INVALID_USER_ID</error_code> <available_user_id>1</available_user_id> <error_message>Invalid user id. {user_id} should be used.</error_message> </Data>`
404	HOST_NOT_VERIFIED	Не подтверждены права на управление сайтом. JSON XML `{ "error_code": "HOST_NOT_VERIFIED", "host_id": "http:ya.ru:80", "error_message": "some string" }` `<Data> <error_code>HOST_NOT_VERIFIED</error_code> <host_id>http:ya.ru:80</host_id> <error_message>some string</error_message> </Data>`

INVALID_USER_ID

{
  "error_code": "INVALID_USER_ID",
  "available_user_id": 1,
  "error_message": "Invalid user id. {user_id} should be used."
}

<Data>
    <error_code>INVALID_USER_ID</error_code>
    <available_user_id>1</available_user_id>
    <error_message>Invalid user id. {user_id} should be used.</error_message>
</Data>

404

HOST_NOT_VERIFIED

Не подтверждены права на управление сайтом.

{
  "error_code": "HOST_NOT_VERIFIED",
  "host_id": "http:ya.ru:80",
  "error_message": "some string"
}

<Data>
  <error_code>HOST_NOT_VERIFIED</error_code>  
  <host_id>http:ya.ru:80</host_id>
  <error_message>some string</error_message>
</Data>