Getting the list of Sitemap files

Returns a list of Sitemap files detected by Yandex robots.

  1. Request format
  2. Response format
  3. Response codes

Request format

GET https://api.webmaster.yandex.net/v3.2/user/{user-id}/hosts/{host-id}/sitemaps/[?parent_id={parent_id}&limit={limit}&from={from}]

Path parameters

Name Required Type Default value Description
user-id Yes int64 User ID. Required when calling all Yandex.Webmaster API resources. To get it, use the GET /user method.
host-id Yes host id The site ID. To get it, use the GET /user/{user-id}/hosts method.
Name Required Type Default value Description
user-id Yes int64 User ID. Required when calling all Yandex.Webmaster API resources. To get it, use the GET /user method.
host-id Yes host id The site ID. To get it, use the GET /user/{user-id}/hosts method.

Query parameters

Name Required Type Default value Description
parent_id No sitemap id The parent Sitemap ID.
limit No int32 10 Page size (1-100).
from No sitemap id Get Sitemap files starting after the specified one (not including it).
Name Required Type Default value Description
parent_id No sitemap id The parent Sitemap ID.
limit No int32 10 Page size (1-100).
from No sitemap id Get Sitemap files starting after the specified one (not including it).

Response format

If successful, the server returns 200 OK and the list of the site's Sitemap files.

Examples

{
  "sitemaps": [
    {
      "sitemap_id": "c7-fe:80-c0",
      "sitemap_url": "explicit error message",
      "last_access_date": "2016-01-01T00:00:00,000+0300",
      "errors_count": 1,
      "urls_count": 1,
      "children_count": 1,
      "sources": [
        "ROBOTS_TXT"
      ], ...
      "sitemap_type": "SITEMAP"
    }, ...
  ]
}
Name Required Type Description
sitemap_id Yes string ID of the Sitemap file.
sitemap_url Yes string The Sitemap URL.
last_access_date No yyyy-MM-ddTHH:mm:ss,sssZ Date the file was last uploaded.
errors_count Yes int32 The number of errors in the file.
urls_count Yes int64 The number of links in the file.
children_count Yes int32 The number of child Sitemap files.
source Yes ApiSitemapSource The sources that led the robot to this file.
sitemap_type Yes ApiExplicitVerificationType Type of the Sitemap file.
Name Required Type Description
sitemap_id Yes string ID of the Sitemap file.
sitemap_url Yes string The Sitemap URL.
last_access_date No yyyy-MM-ddTHH:mm:ss,sssZ Date the file was last uploaded.
errors_count Yes int32 The number of errors in the file.
urls_count Yes int64 The number of links in the file.
children_count Yes int32 The number of child Sitemap files.
source Yes ApiSitemapSource The sources that led the robot to this file.
sitemap_type Yes ApiExplicitVerificationType Type of the Sitemap file.

Source of the Sitemap file (ApiSitemapSource)

Source Description
ROBOTS_TXT Sitemap is specified in the site's robots.txt file.
WEBMASTER The user added the Sitemap in Yandex.Webmaster.
INDEX_SITEMAP Sitemap found in another (index) Sitemap file.
Source Description
ROBOTS_TXT Sitemap is specified in the site's robots.txt file.
WEBMASTER The user added the Sitemap in Yandex.Webmaster.
INDEX_SITEMAP Sitemap found in another (index) Sitemap file.

Type of Sitemap file (ApiSitemapType)

Type Description
SITEMAP Normal Sitemap file that contains the URLs of site pages.
INDEX_SITEMAP The Sitemap index file that contains the URLs of other Sitemap files.
Type Description
SITEMAP Normal Sitemap file that contains the URLs of site pages.
INDEX_SITEMAP The Sitemap index file that contains the URLs of other Sitemap files.

Response codes

To view the response structure in detail, click the reason.

Code Reason Description
200 OK
403

INVALID_USER_ID

The ID of the user who issued the token differs from the one specified in the request. In the examples below, {user_id} shows the correct uid of the OAuth token owner.

{
  "error_code": "INVALID_USER_ID",
  "available_user_id": 1,
  "error_message": "Invalid user id. {user_id} should be used."
}
404 HOST_NOT_VERIFIED
Site management rights are not verified.
{
  "error_code": "HOST_NOT_VERIFIED",
  "host_id": "http:ya.ru:80",
  "error_message": "some string"
}
Code Reason Description
200 OK
403

INVALID_USER_ID

The ID of the user who issued the token differs from the one specified in the request. In the examples below, {user_id} shows the correct uid of the OAuth token owner.

{
  "error_code": "INVALID_USER_ID",
  "available_user_id": 1,
  "error_message": "Invalid user id. {user_id} should be used."
}
404 HOST_NOT_VERIFIED
Site management rights are not verified.
{
  "error_code": "HOST_NOT_VERIFIED",
  "host_id": "http:ya.ru:80",
  "error_message": "some string"
}