List Google Search Console sitemaps

List sitemaps submitted for a Search Console property.

← All Google Search Console endpoints · Capability overview

GET/v1/google-search-console/sitemaps

https://api.vee3.io/v1/google-search-console/sitemaps

5 tokens

List sitemaps submitted for a Search Console property.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

google-search-console.list_sitemaps

Parameters2 fields

site_urlstringOptional

Optional verified property URL from google-search-console.list_sites. When omitted, the default property is used. The user or agent passes an exact site_url value from that response.

sitemap_indexstringOptional

Optional sitemap index URL. When set, only child sitemaps under that index are returned.

Response14 fields

site_urlstring

Search Console property URL used for the request.

sitemapsarrayitems

12 fields

Sitemaps submitted for the property.

pathstring

Full sitemap URL path for the property.

last_submittedstring

Timestamp when the sitemap was last submitted.

is_pendingboolean

Whether Search Console is still processing the sitemap.

is_sitemaps_indexboolean

Whether this entry is a sitemap index.

sitemap_typestring

Sitemap type reported by Search Console.

last_downloadedstring

Timestamp when Google last downloaded the sitemap.

warningsstring

Warning count reported for the sitemap.

errorsstring

Error count reported for the sitemap.

contentsarrayitems

3 fields

Per-content-type submitted and indexed counts.

content_typestring

Sitemap content type reported by Search Console.

submittedstring

Number of submitted URLs of this content type, when available.

indexedstring

Number of indexed URLs of this content type, when available.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, google_search_console_connection_required, google_search_console_connection_refresh_failed, google_search_console_connection_scopes_insufficient, google_search_console_upstream_error, google_search_console_site_not_found, google_search_console_rate_limited, dns_not_using_namecheap

Example request

Python

import requests

url = "https://api.vee3.io/v1/google-search-console/sitemaps"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "site_url": "https://example.com/"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Sample sitemap list for a property.

submitted_sitemaps.json

{
  "site_url": "https://example.com/",
  "sitemaps": [
    {
      "path": "https://example.com/sitemap.xml",
      "last_submitted": "2026-07-01T12:00:00.000Z",
      "is_pending": false,
      "is_sitemaps_index": false,
      "sitemap_type": "WEB",
      "last_downloaded": "2026-07-02T08:00:00.000Z",
      "warnings": "0",
      "errors": "0",
      "contents": [
        {
          "content_type": "web",
          "submitted": "120",
          "indexed": "110"
        }
      ]
    }
  ]
}