Sitemaps: list
Stay organized with collections
Save and categorize content based on your preferences.
Requires authorization
Lists the sitemaps-entries submitted for this site, or included in the sitemap index file (if sitemapIndex is specified in the request).
Try it now.
Request
HTTP request
GET https://www.googleapis.com/webmasters/v3/sites/siteUrl/sitemaps
Parameters
| Parameter name |
Value | url
Description |
| Path parameters |
siteUrl |
string |
The URL of the property as defined in Search Console. For example:
http://www.example.com/
(URL-prefix property),
or sc-domain:example.com
(Domain property).
|
| Optional query parameters |
sitemapIndex |
string |
A URL of a site's sitemap index. For example: http://www.example.com/sitemapindex.xml
|
Authorization
This request requires authorization with at least one of the following scopes (read more about authentication and authorization).
| Scope |
|---|
https://www.googleapis.com/auth/webmasters.readonly |
https://www.googleapis.com/auth/webmasters |
Request body
Do not supply a request body with this method.
Response
If successful, this method returns a response body with the following structure:
{
"sitemap": [
sitemaps Resource
]
}
| Property name |
Value |
Description |
Notes |
sitemap[] |
list |
Contains detailed information about a specific URL submitted as a sitemap. |
|
Try it!
Use the APIs Explorer below to call this method on live data and see the response.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-07-23 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-07-23 UTC."],[[["Lists sitemaps submitted for a site, including those in the sitemap index file."],["Requires authorization with specific scopes for access."],["Employs a simple GET request with optional parameters for filtering."],["Response provides detailed information about each submitted sitemap."],["Allows users to try the API call directly using the provided explorer tool."]]],["This API endpoint retrieves a list of sitemap entries for a specified site. The request, using `GET`, requires the `siteUrl` path parameter, which is the site's URL as defined in Search Console. Optionally, it takes a `sitemapIndex` query parameter to list entries within a specific sitemap index. Authorization is necessary using `webmasters.readonly` or `webmasters` scopes. A successful response returns a list of sitemap resources, each detailing a submitted URL. No request body is needed.\n"]]
