---
metadata:
  - name: generator
    content: Diplodoc Platform v5.44.0
alternate:
  - https://yandex.ru/dev/webmaster/doc/en/reference/hosts-id.md
  - https://yandex.ru/dev/webmaster/doc/ru/reference/hosts-id.md
keywords:
  - с
  - а
  - й
  - т
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/webmaster/doc/ru/llms.txt


# Получение информации о сайте

Возвращает информацию о сайте.

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

```
GET https://api.webmaster.yandex.net/v4/user/{[user-id](*user-id)}/hosts/{[host-id](*host-id)}
```


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

||
|#

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

### Пример
> 
> 
> {% list tabs %}
> 
> - JSON
> 
>   
>   ```javascript
>   {
>     "host_id": "https:ya.ru:443",
>     "verified": true,
>     "ascii_host_url": "https://ya.ru/",
>     "unicode_host_url": "https://ya.ru/",
>     "main_mirror": {
>       "host_id": "http:xn--d1acpjx3f.xn--p1ai:80",
>       "ascii_host_url": "http://xn--d1acpjx3f.xn--p1ai/",
>       "unicode_host_url": "http://Яндекс рф/",
>       "verified": false
>     },
>     "host_data_status": "[NOT_INDEXED](*index-verify)",
>     "host_display_name": "Ya.ru"
>   }
>   ```
>   
> 
> - XML
> 
>   
>   ```xml
>   <Data>
>       <[host_id](*host_id3)>https:ya.ru:443</host_id>
>       <[verified](*verified2)>true</verified>
>       <[ascii_host_url](*ascii_host_url)>https://ya.ru/</ascii_host_url>
>       <[unicode_host_url](*unicode_host_url)>https://ya.ru/</unicode_host_url>
>       <[main_mirror](*main_mirror)>
>           <[host_id](*host_id3)>http:xn--d1acpjx3f.xn--p1ai:80</host_id>
>           <[ascii_host_url](*ascii_host_url)>http://xn--d1acpjx3f.xn--p1ai/</ascii_host_url>
>           <[unicode_host_url](*unicode_host_url)>http://Яндекс рф/</unicode_host_url>
>           <[verified](*verified)>false</verified>
>       </main_mirror>
>       <[host_data_status](*host_data_status)>[NOT_INDEXED](*index-verify)</host_data_status>
>       <[host_display_name](*host_display_name)>Ya.ru</host_display_name>
>   </Data>
>   ```
> 
> {% endlist %}

#|
||
**Имя**
|
**Обязательный**
|
**Тип**
|
**Описание**
||
||
`host_id`
|
<!-- source: ru/_includes/reference/hosts-id/host_id/req.md -->
Да
<!-- endsource: ru/_includes/reference/hosts-id/host_id/req.md -->
|
<!-- source: ru/_includes/reference/hosts-id/host_id/type.md -->
`host id` (`string`)
<!-- endsource: ru/_includes/reference/hosts-id/host_id/type.md -->
|
<!-- source: ru/_includes/reference/hosts-id/host_id/desc.md -->
ID запрошенного сайта.
<!-- endsource: ru/_includes/reference/hosts-id/host_id/desc.md -->
||
||
`ascii_host_url`
|
<!-- source: ru/_includes/reference/hosts-id/ascii_host_url/req.md -->
Да
<!-- endsource: ru/_includes/reference/hosts-id/ascii_host_url/req.md -->
|
<!-- source: ru/_includes/reference/hosts-id/ascii_host_url/type.md -->
`string`
<!-- endsource: ru/_includes/reference/hosts-id/ascii_host_url/type.md -->
|
<!-- source: ru/_includes/reference/hosts-id/ascii_host_url/desc.md -->
ASCII URL сайта.
<!-- endsource: ru/_includes/reference/hosts-id/ascii_host_url/desc.md -->
||
||
`unicode_host_url`
|
<!-- source: ru/_includes/reference/hosts-id/unicode_host_url/req.md -->
Да
<!-- endsource: ru/_includes/reference/hosts-id/unicode_host_url/req.md -->
|
<!-- source: ru/_includes/reference/hosts-id/unicode_host_url/type.md -->
`string`
<!-- endsource: ru/_includes/reference/hosts-id/unicode_host_url/type.md -->
|
<!-- source: ru/_includes/reference/hosts-id/unicode_host_url/desc.md -->
UTF-8 URL сайта.
<!-- endsource: ru/_includes/reference/hosts-id/unicode_host_url/desc.md -->
||
||
`verified`
|
<!-- source: ru/_includes/reference/hosts-id/verified/req.md -->
Да
<!-- endsource: ru/_includes/reference/hosts-id/verified/req.md -->
|
<!-- source: ru/_includes/reference/hosts-id/verified/type.md -->
`boolean`
<!-- endsource: ru/_includes/reference/hosts-id/verified/type.md -->
|
<!-- source: ru/_includes/reference/hosts-id/verified/desc.md -->
Подтвержден ли сайт.
<!-- endsource: ru/_includes/reference/hosts-id/verified/desc.md -->
||
||
`main_mirror`
|
<!-- source: ru/_includes/reference/hosts-id/main_mirror/req.md -->
Нет
<!-- endsource: ru/_includes/reference/hosts-id/main_mirror/req.md -->
|

|
<!-- source: ru/_includes/reference/hosts-id/main_mirror/desc.md -->
Главный адрес сайта, если есть.
<!-- endsource: ru/_includes/reference/hosts-id/main_mirror/desc.md -->
||
||
`host_data_status`
|
<!-- source: ru/_includes/reference/hosts-id/host_data_status/req.md -->
Нет
<!-- endsource: ru/_includes/reference/hosts-id/host_data_status/req.md -->
|
<!-- source: ru/_includes/reference/hosts-id/host_data_status/type.md -->
`string` ([ApiHostDataStatus](https://yandex.ru/dev/webmaster/doc/ru/reference/hosts-id.md#index-verify))
<!-- endsource: ru/_includes/reference/hosts-id/host_data_status/type.md -->
|
<!-- source: ru/_includes/reference/hosts-id/host_data_status/desc.md -->
Информация о сайте (показывается, если сайт подтвержден).
<!-- endsource: ru/_includes/reference/hosts-id/host_data_status/desc.md -->
||
||
`host_display_name`
|
<!-- source: ru/_includes/reference/hosts-id/host_display_name/req.md -->
Нет
<!-- endsource: ru/_includes/reference/hosts-id/host_display_name/req.md -->
|
<!-- source: ru/_includes/reference/hosts-id/host_display_name/type.md -->
`string`
<!-- endsource: ru/_includes/reference/hosts-id/host_display_name/type.md -->
|
<!-- source: ru/_includes/reference/hosts-id/host_display_name/desc.md -->
Отображаемое имя сайта.
<!-- endsource: ru/_includes/reference/hosts-id/host_display_name/desc.md -->
||
|#

<!-- source: ru/_includes/reference/errors/index-verify.md -->
### Статус индексирования сайта (ApiHostDataStatus) {#index-verify}

#|
||
**Источник**
|
**Описание**
||
||
`NOT_INDEXED`
|
Сайт еще не проиндексирован.
||
||
`NOT_LOADED`
|
Данные о сайте еще не загружены в Яндекс Вебмастер.
||
||
`OK`
|
Сайт проиндексирован, данные доступны в Яндекс Вебмастере.
||
|#
<!-- endsource: ru/_includes/reference/errors/index-verify.md -->

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


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

#|

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


||
200
|
OK
|
||

||
403
|
[INVALID_USER_ID](https://yandex.ru/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](*error_code)>INVALID_USER_ID</error_code>
      <[available_user_id](*available_user_id)>1</available_user_id>
      <[error_message](*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_FOUND](https://yandex.ru/dev/webmaster/doc/ru/reference/errors.md#host-not-found)
|
Сайт отсутствует в списке сайтов пользователя.


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

- JSON

  
  ```javascript
  {
    "error_code": "HOST_NOT_FOUND",
    "host_id": "http:ya.ru:80",
    "error_message": "explicit error message"
  }
  ```
  

- XML

  
  ```xml
  <Data>
      <[error_code](*error_code)>HOST_NOT_FOUND</error_code>
      <[host_id](*host_id)>http:ya.ru:80</host_id>
      <[error_message](*error_message)>explicit error message</error_message>
  </Data>
  ```

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


||
|#

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

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







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

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

[*verified]: **Описание**

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

[*index-verify]: 
### Статус индексирования сайта (ApiHostDataStatus) {#index-verify}

#|
||
**Источник**
|
**Описание**
||
||
`NOT_INDEXED`
|
Сайт еще не проиндексирован.
||
||
`NOT_LOADED`
|
Данные о сайте еще не загружены в Яндекс Вебмастер.
||
||
`OK`
|
Сайт проиндексирован, данные доступны в Яндекс Вебмастере.
||
|#

[*host_id3]: **Обязательный**

<!-- source: ru/_includes/reference/hosts-id/host_id/req.md -->
Да
<!-- endsource: ru/_includes/reference/hosts-id/host_id/req.md -->

**Тип**

<!-- source: ru/_includes/reference/hosts-id/host_id/type.md -->
`host id` (`string`)
<!-- endsource: ru/_includes/reference/hosts-id/host_id/type.md -->

**Описание**

<!-- source: ru/_includes/reference/hosts-id/host_id/desc.md -->
ID запрошенного сайта.
<!-- endsource: ru/_includes/reference/hosts-id/host_id/desc.md -->

[*ascii_host_url]: **Обязательный**

<!-- source: ru/_includes/reference/hosts-id/ascii_host_url/req.md -->
Да
<!-- endsource: ru/_includes/reference/hosts-id/ascii_host_url/req.md -->

**Тип**

<!-- source: ru/_includes/reference/hosts-id/ascii_host_url/type.md -->
`string`
<!-- endsource: ru/_includes/reference/hosts-id/ascii_host_url/type.md -->

**Описание**

<!-- source: ru/_includes/reference/hosts-id/ascii_host_url/desc.md -->
ASCII URL сайта.
<!-- endsource: ru/_includes/reference/hosts-id/ascii_host_url/desc.md -->

[*unicode_host_url]: **Обязательный**

<!-- source: ru/_includes/reference/hosts-id/unicode_host_url/req.md -->
Да
<!-- endsource: ru/_includes/reference/hosts-id/unicode_host_url/req.md -->

**Тип**

<!-- source: ru/_includes/reference/hosts-id/unicode_host_url/type.md -->
`string`
<!-- endsource: ru/_includes/reference/hosts-id/unicode_host_url/type.md -->

**Описание**

<!-- source: ru/_includes/reference/hosts-id/unicode_host_url/desc.md -->
UTF-8 URL сайта.
<!-- endsource: ru/_includes/reference/hosts-id/unicode_host_url/desc.md -->

[*verified2]: **Обязательный**

<!-- source: ru/_includes/reference/hosts-id/verified/req.md -->
Да
<!-- endsource: ru/_includes/reference/hosts-id/verified/req.md -->

**Тип**

<!-- source: ru/_includes/reference/hosts-id/verified/type.md -->
`boolean`
<!-- endsource: ru/_includes/reference/hosts-id/verified/type.md -->

**Описание**

<!-- source: ru/_includes/reference/hosts-id/verified/desc.md -->
Подтвержден ли сайт.
<!-- endsource: ru/_includes/reference/hosts-id/verified/desc.md -->

[*main_mirror]: **Обязательный**

<!-- source: ru/_includes/reference/hosts-id/main_mirror/req.md -->
Нет
<!-- endsource: ru/_includes/reference/hosts-id/main_mirror/req.md -->

**Тип**


**Описание**

<!-- source: ru/_includes/reference/hosts-id/main_mirror/desc.md -->
Главный адрес сайта, если есть.
<!-- endsource: ru/_includes/reference/hosts-id/main_mirror/desc.md -->

[*host_data_status]: **Обязательный**

<!-- source: ru/_includes/reference/hosts-id/host_data_status/req.md -->
Нет
<!-- endsource: ru/_includes/reference/hosts-id/host_data_status/req.md -->

**Тип**

<!-- source: ru/_includes/reference/hosts-id/host_data_status/type.md -->
`string` ([ApiHostDataStatus](https://yandex.ru/dev/webmaster/doc/ru/reference/hosts-id.md#index-verify))
<!-- endsource: ru/_includes/reference/hosts-id/host_data_status/type.md -->

**Описание**

<!-- source: ru/_includes/reference/hosts-id/host_data_status/desc.md -->
Информация о сайте (показывается, если сайт подтвержден).
<!-- endsource: ru/_includes/reference/hosts-id/host_data_status/desc.md -->

[*host_display_name]: **Обязательный**

<!-- source: ru/_includes/reference/hosts-id/host_display_name/req.md -->
Нет
<!-- endsource: ru/_includes/reference/hosts-id/host_display_name/req.md -->

**Тип**

<!-- source: ru/_includes/reference/hosts-id/host_display_name/type.md -->
`string`
<!-- endsource: ru/_includes/reference/hosts-id/host_display_name/type.md -->

**Описание**

<!-- source: ru/_includes/reference/hosts-id/host_display_name/desc.md -->
Отображаемое имя сайта.
<!-- endsource: ru/_includes/reference/hosts-id/host_display_name/desc.md -->