---
metadata:
  - name: generator
    content: Diplodoc Platform v5.64.0
alternate:
  - https://www.yandex.com/dev/webmaster/doc/en/reference/host-links-internal-history.md
  - https://www.yandex.com/dev/webmaster/doc/ru/reference/host-links-internal-history.md
  - href: https://www.yandex.com/dev/webmaster/doc/ru/reference/host-links-internal-history.md
    type: text/markdown
    title: Markdown version
  - href: https://www.yandex.com/dev/webmaster/doc/ru/llms.txt?revision=r21838267
    rel: describedby
keywords: сайт
---
> **Documentation Index:** Fetch the complete configuration index at https://www.yandex.com/dev/webmaster/doc/ru/llms.txt?revision=r21838267


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

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

<!-- source: ru/_includes/reference/host-links-internal-samples/id-host-links-internal-samples/access.md -->
{% note alert %}

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

{% endnote %}
<!-- endsource: ru/_includes/reference/host-links-internal-samples/id-host-links-internal-samples/access.md -->

## Формат запроса {#request-format}

```
GET https://api.webmaster.yandex.net/v4/user/{[user-id](*user-id)}/hosts/{[host-id](*host-id)}/links/internal/broken/history
  ? [[date_from](*date_from)=<datetime>]
  & [[date_to](*date_to)=<datetime>]
```

#|
||
`user-id`
|
    
<!-- source: ru/_includes/popup/user-id.md -->
Тип: `int64`. ID пользователя. Необходим для вызова любых ресурсов API Яндекс Вебмастера. Чтобы получить его, используйте метод [GET /v4/user](https://www.yandex.com/dev/webmaster/doc/ru/reference/user.md).
<!-- endsource: ru/_includes/popup/user-id.md -->
    
||
||
`host-id`
|
    
<!-- source: ru/_includes/popup/host-id.md -->
Тип: `string`. ID сайта. Чтобы получить его, используйте метод [GET&nbsp;/v4/user/{user&#x2011;id}/hosts](https://www.yandex.com/dev/webmaster/doc/ru/reference/hosts.md).
<!-- endsource: ru/_includes/popup/host-id.md -->

||
||
`date_from`
|
<!-- source: ru/_includes/popup/date_from.md -->
Дата начала интервала. Если не указан, то данные возвращаются за текущий день.
<!-- endsource: ru/_includes/popup/date_from.md -->
||
||
`date_to`
|
<!-- source: ru/_includes/popup/date_to.md -->
Дата конца интервала. Если не указан, то данные возвращаются за текущий день.
<!-- endsource: ru/_includes/popup/date_to.md -->
||
|#

## Формат ответа {#response-format}

### Примеры
> 
> 
> {% list tabs %}
> 
> - JSON
> 
>   
>   ```javascript
>   {
>       "indicators": {
>           "DISALLOWED_BY_USER": [
>               {
>                   "date": "2019-04-15T00:00:00.000+03:00",
>                   "value": 116
>               }
>           ]
>       }
>   }
>   ```
>   
> 
> - XML
> 
>   
>   ```xml
>   <Data>
>       <indicators>
>           <DISALLOWED_BY_USER>
>               <date>2019-04-15T00:00:00.000+03:00</date>
>               <value>116</value>
>           </DISALLOWED_BY_USER>
>       </indicators>
>   </Data>
>   ```
> 
> {% endlist %}

#|
||
**Имя**
|
**Обязательный**
|
**Тип**
|
**Описание**
||
||
[DISALLOWED_BY_USER](*DISALLOWED_BY_USER)
|
Нет
|
[ApiInternalLinksBrokenIndicator](*ApiInternalLinksBrokenIndicator)
|
Причина, по которой ссылка не работает.
||
|#

<!-- source: ru/_includes/reference/errors/internal-links.md -->
### Индикаторы внутренних ссылок (ApiInternalLinksBrokenIndicator) {#internal-links}

#|
||
**Индикатор**
|
**Описание**
||
||
`SITE_ERROR`
|
Общее количество известных внешних ссылок на сайт.
||
||
`DISALLOWED_BY_USER`
|
Страница не существует или ее [индексирование запрещено](https://yandex.ru/support/webmaster/adding-site/indexing-prohibition.html).
||
||
`UNSUPPORTED_BY_ROBOT`
|
Не поддерживаются основным индексирующим роботом Поиска.
||
|#
<!-- endsource: ru/_includes/reference/errors/internal-links.md -->


## Коды ответа {#errors}


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

#|

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


||
200
|
OK
|
||

||
403
|
[INVALID_USER_ID](https://www.yandex.com/dev/webmaster/doc/ru/reference/errors.md#invalid-user-id)
|
ID пользователя, выдавшего токен, отличается от указанного в запросе. В примерах ниже `{user_id}` указан правильный `uid` владельца OAuth-токена.


<!-- source: ru/_includes/reference/errors/code-inv-id.md -->
{% list tabs %}

- JSON

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

- XML

  
  ```xml
  <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>
  ```

{% endlist %}
<!-- endsource: ru/_includes/reference/errors/code-inv-id.md -->

||


||
404
|
[HOST_NOT_VERIFIED](https://www.yandex.com/dev/webmaster/doc/ru/reference/errors.md#host-not-verif)
|
Не подтверждены права на управление сайтом.

<!-- source: ru/_includes/reference/errors/dl-host-not-ver.md -->
{% list tabs %}

- JSON

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

- XML

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

{% endlist %}
<!-- endsource: ru/_includes/reference/errors/dl-host-not-ver.md -->

||
|#

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

- [Коды ошибок и статусы](https://www.yandex.com/dev/webmaster/doc/ru/reference/errors.md)






[*user-id]: Тип: `int64`. ID пользователя. Необходим для вызова любых ресурсов API Яндекс Вебмастера. Чтобы получить его, используйте метод [GET /v4/user](https://www.yandex.com/dev/webmaster/doc/ru/reference/user.md).

[*host-id]: Тип: `string`. ID сайта. Чтобы получить его, используйте метод [GET&nbsp;/v4/user/{user&#x2011;id}/hosts](https://www.yandex.com/dev/webmaster/doc/ru/reference/hosts.md).

[*date_from]: Дата начала интервала. Если не указан, то данные возвращаются за текущий день.

[*date_to]: Дата конца интервала. Если не указан, то данные возвращаются за текущий день.

[*DISALLOWED_BY_USER]: 
### Индикаторы внутренних ссылок (ApiInternalLinksBrokenIndicator) {#internal-links}

#|
||
**Индикатор**
|
**Описание**
||
||
`SITE_ERROR`
|
Общее количество известных внешних ссылок на сайт.
||
||
`DISALLOWED_BY_USER`
|
Страница не существует или ее [индексирование запрещено](https://yandex.ru/support/webmaster/adding-site/indexing-prohibition.html).
||
||
`UNSUPPORTED_BY_ROBOT`
|
Не поддерживаются основным индексирующим роботом Поиска.
||
|#

[*ApiInternalLinksBrokenIndicator]: 
### Индикаторы внутренних ссылок (ApiInternalLinksBrokenIndicator) {#internal-links}

#|
||
**Индикатор**
|
**Описание**
||
||
`SITE_ERROR`
|
Общее количество известных внешних ссылок на сайт.
||
||
`DISALLOWED_BY_USER`
|
Страница не существует или ее [индексирование запрещено](https://yandex.ru/support/webmaster/adding-site/indexing-prohibition.html).
||
||
`UNSUPPORTED_BY_ROBOT`
|
Не поддерживаются основным индексирующим роботом Поиска.
||
|#