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


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

Возвращает подробную информацию о файле Sitemap, включая тип файла, дату и способ загрузки файла в Яндекс Вебмастер, дату обработки файла сервисом, количество содержащихся в файле URL, а также количество и тип обнаруженных ошибок.

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

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

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

||
||
`sitemap-id`
|
<!-- source: ru/_includes/popup/sitemap-id.md -->
Тип: `string`. ID файла [Sitemap](https://yandex.com/dev/webmaster/doc/ru/reference/host-sitemaps-get.md#response-format).
<!-- endsource: ru/_includes/popup/sitemap-id.md -->

||
|#

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

### Примеры
> 
> 
> {% list tabs %}
> 
> - JSON
> 
>   
>   ```javascript
>   {
>     "sitemap_id": "c7-fe:80-c0",
>     "sitemap_url": "some url",
>     "last_access_date": "2016-01-01T00:00:00,000+0300",
>     "errors_count": 1,
>     "urls_count": 1,
>     "children_count": 1,
>     "sources": [
>       "[ROBOTS_TXT](*sitemap-source)", ...
>     ],
>     "sitemap_type": "SITEMAP"
>   }
>   ```
>   
> 
> - XML
> 
>   
>   ```xml
>   <Data>
>       <[sitemap_id](*sitemap_id2)>c7-fe:80-c0</sitemap_id>
>       <[sitemap_url](*sitemap_url)>some url</sitemap_url>
>       <[last_access_date](*last_access_date)>2016-01-01T00:00:00,000+0300</last_access_date>
>       <[errors_count](*errors_count)>1</errors_count>
>       <[urls_count](*urls_count)>1</urls_count>
>       <[children_count](*children_count)>1</children_count>
>       <[source](*source)>ROBOTS_TXT</source>
>       ...
>       <[sitemap_type](*sitemap_type)>SITEMAP</sitemap_type>
>   </Data>
>   ```
> 
> {% endlist %}

#|
|| **Имя** | **Обязательный** | **Тип** | **Описание** ||
||`sitemap_id` |
<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_id/req.md -->
Да
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_id/req.md -->
|
<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_id/type.md -->
`string`
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_id/type.md -->
|
<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_id/desc.md -->
Идентификатор файла Sitemap.
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_id/desc.md -->
||
|| `sitemap_url` |
<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_url/req.md -->
Да
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_url/req.md -->
|
<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_url/type.md -->
`string`
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_url/type.md -->
|
<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_url/desc.md -->
URL файла Sitemap.
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_url/desc.md -->
||
|| `last_access_date` |
<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/last_access_date/req.md -->
Да
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/last_access_date/req.md -->
|
<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/last_access_date/type.md -->
`datetime`
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/last_access_date/type.md -->
|
<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/last_access_date/desc.md -->
Дата последней загрузки файла.
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/last_access_date/desc.md -->
||
|| `errors_count` |
<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/errors_count/req.md -->
Да
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/errors_count/req.md -->
|
<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/errors_count/type.md -->
`int32`
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/errors_count/type.md -->
|
<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/errors_count/desc.md -->
Количество ошибок в файле.
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/errors_count/desc.md -->
||
|| `urls_count` |
<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/urls_count/req.md -->
Да
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/urls_count/req.md -->
|
<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/urls_count/type.md -->
`int64`
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/urls_count/type.md -->
|
<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/urls_count/desc.md -->
Количество ссылок в файле.
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/urls_count/desc.md -->
||
|| `children_count` |
<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/children_count/req.md -->
Да
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/children_count/req.md -->
|
<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/children_count/type.md -->
`int32`
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/children_count/type.md -->
|
<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/children_count/desc.md -->
Количество дочерних файлов Sitemap.
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/children_count/desc.md -->
||
|| `source` |
<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/source/req.md -->
Да
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/source/req.md -->
|
<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/source/type.md -->
`string` ([ApiSitemapSource](https://yandex.com/dev/webmaster/doc/ru/reference/host-sitemaps-sitemap-id-get.md#sitemap-source))
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/source/type.md -->
|
<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/source/desc.md -->
Источники, из которых робот узнал об этом файле.
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/source/desc.md -->
||
|| `sitemap_type` |
<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_type/req.md -->
Да
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_type/req.md -->
|
<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_type/type.md -->
`string` ([ApiSitemapType](https://yandex.com/dev/webmaster/doc/ru/reference/host-sitemaps-sitemap-id-get.md#sitemap-type))
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_type/type.md -->
|
<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_type/desc.md -->
Тип файла Sitemap.
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_type/desc.md -->
||
|#

<!-- source: ru/_includes/reference/errors/sitemap-source.md -->
### Источник файла Sitemap (ApiSitemapSource) {#sitemap-source}

#|
||
**Источник**
|
**Описание**
||
||
`ROBOTS_TXT`
|
Sitemap указан в файле `robots.txt` сайта.
||
||
`WEBMASTER`
|
Sitemap добавлен пользователем в Яндекс Вебмастере.
||
||
`INDEX_SITEMAP`
|
Sitemap найден в другом (индексном) файле `Sitemap`.
||
|#
<!-- endsource: ru/_includes/reference/errors/sitemap-source.md -->

<!-- source: ru/_includes/reference/errors/sitemap-type.md -->
### Тип файла Sitemap (ApiSitemapType) {#sitemap-type}

#|
||
**Тип**
|
**Описание**
||
||
`SITEMAP`
|
Обычный файл `Sitemap`, содержащий URL страниц сайта.
||
||
`INDEX_SITEMAP`
|
Индексный файл `Sitemap`, содержащий URL других файлов `Sitemap`.
||
|#
<!-- endsource: ru/_includes/reference/errors/sitemap-type.md -->


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


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

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

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

{% list tabs %}

- JSON

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

- XML

  
  ```xml
  <Data>
    <[error_code](*error_code)>HOST_NOT_VERIFIED</error_code>  
    <[host_id](*host_id)>http:ya.ru:80</host_id>
    <[error_message](*error_message)>some string</error_message>
  </Data>
  ```

{% endlist %}
 ||
|| 404 | [HOST_NOT_LOADED](https://yandex.com/dev/webmaster/doc/ru/reference/errors.md#host-not-loaded) | Данные о сайте еще не загружены в Яндекс Вебмастер.

{% list tabs %}

- JSON

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

- XML

  
  ```xml
  <Data>
    <[error_code](*error_code)>HOST_NOT_LOADED</error_code>  
    <[host_id](*host_id)>http:ya.ru:80</host_id>
    <[error_message](*error_message)>some string</error_message>
  </Data>
  ```

{% endlist %}
 ||
|| 404 | [SITEMAP_NOT_FOUND](https://yandex.com/dev/webmaster/doc/ru/reference/errors.md#sitemap-not-found) | Файл Sitemap не найден.

{% list tabs %}

- JSON

  ```javascript 
  {
   "error_code": "SITEMAP_NOT_FOUND",
   "host_id": "http:ya.ru:80",
   "sitemap_id": "c7-fe:80-c0",
   "error_message": "some string"
  } 
  ```

- XML

  ```xml 
  <Data>
   <[error_code](*error_code)>SITEMAP_NOT_FOUND</error_code> 
   <[host_id](*host_id)>http:ya.ru:80</host_id>  
   <[sitemap_id](*sitemap_id)>c7-fe:80-c0</sitemap_id>  
   <[error_message](*error_message)>some string</error_message>
  </Data> 
  ```

{% endlist %}

||
|#

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

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







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

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

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

Код ошибки.

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

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

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

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

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

ID файла `Sitemap`.

[*sitemap-id]: Тип: `string`. ID файла [Sitemap](https://yandex.com/dev/webmaster/doc/ru/reference/host-sitemaps-get.md#response-format).

[*sitemap-source]: 
### Источник файла Sitemap (ApiSitemapSource) {#sitemap-source}

#|
||
**Источник**
|
**Описание**
||
||
`ROBOTS_TXT`
|
Sitemap указан в файле `robots.txt` сайта.
||
||
`WEBMASTER`
|
Sitemap добавлен пользователем в Яндекс Вебмастере.
||
||
`INDEX_SITEMAP`
|
Sitemap найден в другом (индексном) файле `Sitemap`.
||
|#

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

<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_id/req.md -->
Да
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_id/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_id/type.md -->
`string`
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_id/type.md -->

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

<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_id/desc.md -->
Идентификатор файла Sitemap.
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_id/desc.md -->

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

<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_url/req.md -->
Да
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_url/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_url/type.md -->
`string`
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_url/type.md -->

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

<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_url/desc.md -->
URL файла Sitemap.
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_url/desc.md -->

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

<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/last_access_date/req.md -->
Да
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/last_access_date/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/last_access_date/type.md -->
`datetime`
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/last_access_date/type.md -->

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

<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/last_access_date/desc.md -->
Дата последней загрузки файла.
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/last_access_date/desc.md -->

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

<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/errors_count/req.md -->
Да
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/errors_count/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/errors_count/type.md -->
`int32`
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/errors_count/type.md -->

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

<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/errors_count/desc.md -->
Количество ошибок в файле.
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/errors_count/desc.md -->

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

<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/urls_count/req.md -->
Да
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/urls_count/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/urls_count/type.md -->
`int64`
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/urls_count/type.md -->

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

<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/urls_count/desc.md -->
Количество ссылок в файле.
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/urls_count/desc.md -->

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

<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/children_count/req.md -->
Да
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/children_count/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/children_count/type.md -->
`int32`
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/children_count/type.md -->

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

<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/children_count/desc.md -->
Количество дочерних файлов Sitemap.
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/children_count/desc.md -->

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

<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/source/req.md -->
Да
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/source/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/source/type.md -->
`string` ([ApiSitemapSource](https://yandex.com/dev/webmaster/doc/ru/reference/host-sitemaps-sitemap-id-get.md#sitemap-source))
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/source/type.md -->

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

<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/source/desc.md -->
Источники, из которых робот узнал об этом файле.
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/source/desc.md -->

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

<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_type/req.md -->
Да
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_type/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_type/type.md -->
`string` ([ApiSitemapType](https://yandex.com/dev/webmaster/doc/ru/reference/host-sitemaps-sitemap-id-get.md#sitemap-type))
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_type/type.md -->

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

<!-- source: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_type/desc.md -->
Тип файла Sitemap.
<!-- endsource: ru/_includes/reference/host-sitemaps-sitemap-id-get/sitemap_type/desc.md -->