Reference Guide

Important: This is an old version of this page. For the latest version, use the links in the left-side navbar.

This document provides detailed reference information for the Webmaster Tools Data API.


This document is intended for programmers who want to write client applications that can interact with Google Webmaster Tools.

It's a reference document; it assumes you understand the concepts presented in the developer's guide, and the general ideas behind the Google Data APIs protocol and Sitemaps.


  1. Audience
  2. Webmaster Tools feeds
    1. Sites feed
    2. Keywords feed
    3. Sitemaps feed
    4. Messages feed
    5. Crawl Issues feed
  3. Webmaster Tools element reference
    1. Sites feed
    2. Keywords feed
    3. Sitemaps feed
    4. Messages feed
    5. Crawl Issues feed
  4. Webmaster Tools Schema Reference

Webmaster Tools feeds

The Webmaster Tools Data API currently provides the following representations of Webmaster Tools data:

Feed ID
Site data sites
Keyword data keywords
Sitemaps data sitemaps
Message Center messages data messages
Crawl Errors feed crawlissues

Sites feed

The Sites feed lists sites in an authenticated user account:

To access individual entries, add the SiteID, which is your site URL encoded using URL encoding:

For example, to access entries for the site, use the following URL:

Keywords feed

The Keywords feed represents a snapshot of how Google sees your site. It lists keywords found on your site (internal) as well as in the anchor text of external links to your site:

To retrieve the Keywords feed, add the SiteID, which is your site URL encoded using URL encoding:

Sitemaps feed

The Sitemaps feed lists the Sitemaps sbumitted for a specified site in an authenticated user account:

For example, to view a list of Sitemaps for the site, add your SiteID, which is your site URL encoded using URL encoding:

To access an individual Sitemap entry, you need to specify both SiteID and SitemapID. The SitemapID is the full Sitemap URL encoded using URL encoding. For example, to access an entry (in this example, submitted for the site, use the following URL:

Messages feed

The Messages feed lists the messages that the user has received via the Message Center in Google Webmaster Tools:

To access individual messages, add the MessageID, which is the the URL of the message encoded using URL encoding, plus the token that identifies each message:

For example, to view a message with the ID AB9YKzKy-cxuP3jKPovozsi1ZQ6iFz5RJjMNlXxkVvVklU_dJ58iz5xG2bJPH3V-xaHPSrz1cvBCGpJ99Gn5KwVKnksi6iXZSA, use the following URL:

Crawl feed

The Crawl Issues feed lists issues that Googlebot found when crawling your verified site:

To retrieve the Crawl Issues feed, add the SiteID, which is your site URL encoded using URL encoding:

Webmaster Tools elements reference

For information about the elements used in Google Data APIs, see the Atom specification and the Google extensions.

In addition to these standard elements, the Webmaster Tools Data API uses the wt namespace for extension elements. The schema URL for the wt namespace is Elements and attributes in the wt namespace are used to describe properties of sites and associated Sitemaps.

Sites feed


Indicates the desired crawl rate (the time Google will spend crawling your site). Accepted values are normal, slower, and faster. Some of the values may not be available for a particular site. More information about crawl rate.



Indicates the country or region associated with the website. Note that the values must be one of the accepted country codes. Only sites with a geographically neutral top-level domain (such as .com, .net, .edu, or .gov) can be associated with a location. Sites with country-specific domains, such as, are already associated with a geographic location. More information about setting a geographic target.



Indicates the domain you would like used to index your pages. If the value is none, Google will treat and as different sites. If the value is preferwww, we'll treat as if it were If the value is prefernowww, we'll treat as if it were More information about setting your preferred domain.



Indicates the verification method (HTML file or meta tag) used to verify ownership of the site. Each site entry in the Sites feed will have two <wt:verification-method> elements, one for each verification method.

type The type of verification. Can be either htmlpage or metatag.
file-content The file content for HTML file verification.
in-use Deprecated.
<wt:verification-method type="metatag" in-use="false"><meta name="google-site-verification" content="a2Ai" /></wt:verification-method>
<wt:verification-method type="htmlpage" in-use="true" file-content="google-site-verification: 456456-google.html">456456-google.html</wt:verification-method>


Boolean value (xs:boolean) indicating whether the site ownership has been verified by one of the two accepted verification methods (uploading an HTML page with a specified filename and content, or adding a specified meta tag to the site's home page). More information about site verification.


Keywords feed


Lists a keyword

source Indicates whether Google found the keyword in the content of your own site or in the anchor text of external links to your site. Can be either internal or external.
<wt:keyword>true source='internal'></wt:keyword>

Sitemaps feed


No longer supported


Indicates the most recent date the Sitemap was downloaded by Google. The date format is YYYY-M-DT00:00:00.000Z, as specified in RFC 3399.



No longer supported


The <wt:sitemap-mobile-markup-language> specifies the markup language. Acceptable values (HTML, WML, and CHTML) are listed in the <wt:sitemap-mobile> element of the Sitemap feed.



The <wt:sitemap-news> element contains a list of <wt:publication-label> elements specifying the acceptable values (in the example below, Publication1) for the <wt:sitemap-news-publication-label> element required when submitting a News Sitemap. More information about News Sitemaps.

<wt:publication-label>Publication1</wt:publication-label> </wt:sitemap-news>


Specifies the publication label. Allowed values are listed in the <wt:sitemap-news> element of the Sitemap feed.

<wt:sitemap-news-publication-label>Irish Times</wt:sitemap-news-publication-label> 


Indicates the type of Sitemap. Allowed values include WEB, VIDEO, or CODE. It is not used when submitting News or Mobile Sitemaps.



Indicates the number of URLs contained in the Sitemap.


Messages feed


Lists the body of the message sent to the Message Center in Webmaster Tools.

<wt:body body='We've received a request from a site owner to change the
rate at which Googlebot crawls this site:  - Old crawl
rate: Slower  - New crawl rate: Normal  This new crawl rate will stay in effect
for 90 days.  A faster crawl will enable us to crawl your site more quickly,
but may put more load on your server. If you find that this is the case, you
can change the crawl rate again:  1. On the Dashboard, select the site you want.
2. On the Dashboard, under Tools, click Crawl rate.  '></wt:body>


Indicates the date in which the message was sent to the Message Center in Webmaster Tools. This may not be the same as the updated value for the entry.



Indicates the language of the message subject and body. Must be one of two-character language codes described in ISO 639-2. Supported languages.

<wt:language language='en'></wt:language>


Indicates whether the message has been marked as read. Possible values are true and false.



Lists the subject of the message sent to the Message Center in Webmaster Tools.

<wt:subject subject='Crawl rate change request for'>

Crawl Issues feed


Indicates the type of crawl. Allowed values include:

  • web-crawl
  • mobile-crawl-CHTML
  • mobile-operator-crawl
  • mobile-xHTML-WML-crawl
  • news-crawl

Not all crawl types will be available for all sites. For example, news-crawl issues are available only for sites included in the Google News index.



The issue-type element indicates the type of issue found when crawling your site. Possible values include:

  • http-error
  • in-sitemap
  • news-error
  • not-followed
  • not-found
  • restricted-robots-txt
  • timed-out
  • unreachable


The detail element indicates the type of issue found when crawling your site. Allowed values include, but are not limited to:

  • 4xx error
  • 404 (Not found)
  • DNS lookup timeout
  • Domain name not found
  • Failed to connect
  • Network unreachable
  • Redirect error
  • URL restricted by robots.txt

Not all errors may be actual problems. For example, you may have chosen to deliberately block crawlers from some pages. If that's the case, there's no need to address URLs restricted by robots.txt errors for these pages. More information about HTTP status codes.

<detail>404 (Not found)</detail>


Indicates the URL on which the problem link was found.



The date the crawl issue was first detected.


Webmaster Tools Schema Reference

  1. Messages Feed
  2. Sitemaps Feed
  3. Sites Feed