---
metadata:
  - name: generator
    content: Diplodoc Platform v5.44.0
alternate:
  - https://yandex.ru/dev/webmaster/doc/en/reference/hosts.md
  - https://yandex.ru/dev/webmaster/doc/ru/reference/hosts.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
```

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

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


{% list tabs %}

- JSON

  
  ```javascript
  {
    "hosts": [
      {
        "host_id": "http:ya.ru:80",
        "ascii_host_url": "http://xn--d1acpjx3f.xn--p1ai/",
        "unicode_host_url": "http://Яндекс рф/",
        "verified": true,
        "main_mirror": {
          "host_id": "http:ya.ru:80",
          "verified": true,
          "ascii_host_url": "http://xn--d1acpjx3f.xn--p1ai/",
          "unicode_host_url": "http://Яндекс рф/"
        }
      }, ...
    ]
  }
  ```
  

- XML

  
  ```xml
  <Data>
      <host>
          <[host_id](*host_id3)>http:ya.ru: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](*verified2)>yes</verified>
          <[main_mirror](*main_mirror)>
              <[host_id](*host_id3)>http:ya.ru:80</host_id>
              <[verified](*verified2)>false</verified>
              <[ascii_host_url](*ascii_host_url)>http://xn--d1acpjx3f.xn--p1ai/</ascii_host_url>
              <[unicode_host_url](*unicode_host_url)>http://Яндекс рф/</unicode_host_url>
          </main_mirror>
      </host>
      ...
  </Data>
  ```

{% endlist %}

#|
||
**Имя**
|
**Обязательный**
|
**Тип**
|
**Описание**
||
||
`host_id`
|
<!-- source: ru/_includes/reference/hosts/host_id/req.md -->
Да
<!-- endsource: ru/_includes/reference/hosts/host_id/req.md -->
|
<!-- source: ru/_includes/reference/hosts/host_id/type.md -->
`host id` (`string`)
<!-- endsource: ru/_includes/reference/hosts/host_id/type.md -->

|
<!-- source: ru/_includes/reference/hosts/host_id/desc.md -->
ID сайта.
<!-- endsource: ru/_includes/reference/hosts/host_id/desc.md -->

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

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

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

||
||
`unicode_host_url`
|
<!-- source: ru/_includes/reference/hosts/unicode_host_url/req.md -->
Нет
<!-- endsource: ru/_includes/reference/hosts/unicode_host_url/req.md -->

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

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

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

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

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

||
||
`main_mirror`
|
<!-- source: ru/_includes/reference/hosts/main_mirror/req.md -->
Да
<!-- endsource: ru/_includes/reference/hosts/main_mirror/req.md -->

|

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

||
|#

<!-- source: ru/_includes/reference/errors/status-verify.md -->
### Статус подтверждения прав на управление сайтом (ApiVerificationState) {#status-verify}

#|
||
**Статус**
|
**Описание**
||
||
`NONE`
|
Проверка не проводилась, права не подтверждены.
||
||
`VERIFIED`
|
Права подтверждены.
||
||
`IN_PROGRESS`
|
Идет подтверждение прав.
||
||
`VERIFICATION_FAILED`
|
Проверка проводилась, права не подтверждены.
||
||
`INTERNAL_ERROR`
|
В процессе проверки прав произошла непредвиденная ошибка.
||
|#
<!-- endsource: ru/_includes/reference/errors/status-verify.md -->

<!-- source: ru/_includes/reference/errors/denial-verify.md -->
### Причины отказа в подтверждении прав на управление сайтом (ApiVerificationFailReason) {#denial-verify}

#|
||
**Причина отказа**
|
**Описание**
||
||
`DELEGATION CANCELLED`
|
Делегирование прав отменено.
||
||
`DNS_RECORD_NOT_FOUND`
|
Отсутствует указанная DNS-запись.
||
||
`META_TAG_NOT_FOUND`
|
Отсутствует метатег в заголовке главной страницы сайта.
||
||
`WRONG_HTML_PAGE_CONTENT`
|
Содержимое HTML-файла задано неверно.
||
|#
<!-- endsource: ru/_includes/reference/errors/denial-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 -->
||
|#

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

- [Коды ошибок и статусы](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_id3]: **Обязательный**

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

**Тип**

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

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

<!-- source: ru/_includes/reference/hosts/host_id/desc.md -->
ID сайта.
<!-- endsource: ru/_includes/reference/hosts/host_id/desc.md -->

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

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

**Тип**

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

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

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

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

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

**Тип**

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

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

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

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

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

**Тип**

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

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

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

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

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

**Тип**


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

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