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

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

Внимание

Убедитесь, что в настройках приложения, которое вы регистрировали на Яндекс OAuth для работы с API Вебмастера, добавлен доступ Получение информации о внешних ссылках на сайт (webmaster:hostinfo).

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

GET https://api.webmaster.yandex.net/v4/user/{user-id}/hosts/{host-id}/links/external/history
  ? (indicator=<string>)

user-id

Тип: int64. ID пользователя. Необходим для вызова любых ресурсов API Яндекс Вебмастера. Чтобы получить его, используйте метод GET /v4/user.

host-id

Тип: host id (string). ID сайта. Чтобы получить его, используйте метод GET /v4/user/{user‑id}/hosts.

indicator*

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

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

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

Примеры

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

<Data>
    <indicators>
        <LINKS_TOTAL_COUNT>
            <date>2019-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

Общее количество известных внешних ссылок на хост.

Коды ответа

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

Код

Причина

Описание

200

OK

403

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>

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

Тип: int64. ID пользователя. Необходим для вызова любых ресурсов API Яндекс Вебмастера. Чтобы получить его, используйте метод GET /v4/user.

Тип: host id (string). ID сайта. Чтобы получить его, используйте метод GET /v4/user/{user‑id}/hosts.

Смещение в списке. Минимальное значение — 0. Значение по умолчанию: 0.

Количество записей (1-100). Значение по умолчанию: 10.

Описание

Код ошибки.

Описание

Сообщение об ошибке.

Описание

Значение.

Описание

Поле.

Описание

ID запрошенного сайта.

Описание

ID сайта.

Описание

Признак подтверждения сайта.

Описание

ID файла Sitemap.

Описание

Список поддерживаемых типов контента.

Описание

Лимит на количество добавленных сайтов.

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

Описание

Лимит количества фидов.

Описание

Лимит количества добавленных фидов.

Описание

ID пользователя, от имени которого разрешен доступ.

Описание

Дата и время, до которого адрес доступен для создания задачи.

Описание

Список поддерживаемых типов контента.

Описание

Список поддерживаемых типов кодировки.

Описание

Максимальная длина.

Описание

Минимальная длина.

Описание

Доступное количество запросов в сутки.

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

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

Индикатор

Описание

LINKS_TOTAL_COUNT

Общее количество известных внешних ссылок на хост.

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

Индикатор

Описание

LINKS_TOTAL_COUNT

Общее количество известных внешних ссылок на хост.

Обязательный

Да

Тип

date

Описание

Дата обнаружения ссылки.

Обязательный

Да

Тип

string

Описание

Значение индикатора.

Предыдущая
Получение информации о внешних ссылках на сайт
Следующая
Пример управления фидами