Updates to Search Console’s API  |  Google Search Central Blog  |  Google Developers

Wednesday, December 9, 2020

A few months ago we announced an API infrastructure upgrade
to improve the performance of the Search Console API as demand grows. Today we’re happy to announce
some more updates coming your way:

• Addition of fresh data and news filter in the Search Console API
• Domain property support in the Sitemaps API
• Guidelines on how to migrate the Discovery doc

If you make your own calls to the API, read on.

Fresh data and news filter in the Search Console API

The Performance report already supports fresh data that is less than a day old. You can now access this data through the API by passing the request parameter
dataState with value set to all. The data you get for this value will also include fresh data that is not yet final. If you wish to get only final data,
you can either pass this parameter with value set to final or not pass it at all and you will get only final data by default.

A few months ago, we added a News tab on Search filter to the
Performance report. This information is now also available in the API, and you can access it by setting the value of searchType
parameter in the request to news.

Domain property support in the Sitemaps API

The Sitemaps API now supports domain properties, as other Search Console APIs already do. You can query, add, and delete your sitemaps on
domain properties, for example:

GET https://www.googleapis.com/webmasters/v3/sites/sc-domain:example.com/sitemaps

Discovery doc migration

We’ll drop the support in the Webmasters discovery document. If you’re querying the Search Console API using an external API library, or querying
the Webmasters API discovery document directly, you will
need to update your API calls to include the following changes.

API library changes

For updates on the API library changes, refer to the Java and
Python quickstart guides,
for an updated API usage guide.

Java

For all Webmasters service-related imports, change the webmasters package to the searchconsole.v1 package,
and the service name, Webmasters, to SearchConsole. Examples:

• Importing the API service:

  import com.google.api.services.webmasters.Webmasters;

  import com.google.api.services.searchconsole.v1.SearchConsole;

• Importing a response object:

  import com.google.api.services.webmasters.model.WmxSite;

  import com.google.api.services.searchconsole.v1.model.WmxSite;

Note that besides the service object, other API objects are exactly the same as before, only the package changes.

Python

When building the Webmasters service object, make the following change:

webmasters_service = build('webmasters', 'v3', http=http)

webmasters_service = build('searchconsole', 'v1', http=http)

Again, there’s no change in how objects behave.

Direct discovery document query

The discovery document querying changes include:

If you have any questions, you can ask in the Search
Central community or on Twitter.

Posted by Nati Yosephian, Gilad Amar, and Michael Huzman, Search Console team