Search Analytics API now supports Discover, Google News, and Regex
Stay organized with collections
Save and categorize content based on your preferences.
Monday, October 25, 2021
The Google Search Console Performance reports already show data about Search,
Discover, and Google News to site owners that have this type of traffic. Since we launched the Discover
and Google News performance reports, we’ve been receiving requests from
users to also add these stats to the Search Analytics API.
We are happy to announce that this is happening today.
The searchType parameter, which previously enabled you to filter API calls by news,
video, image, and web, will be renamed to
type and will support two additional parameters: discover (for Google Discover) and
googleNews (for Google News). Please note that while we renamed the parameter to type,
we’re still supporting the old name searchType.
In the Search Console Performance reports, some metrics and dimensions are compatible only with some data types; for example, queries and positions are not supported by
the Google Discover report. In the same way, if an unsupported dimension is requested, the API will return an error message.
In addition, we are adding Regex support to the query and page dimensions.
Two new operators will be added to the existing match operations: includingRegex and excludingRegex.
Check out the Search Analytics API documentation to learn more.
If you have any questions, you can ask in the Search Central community or
on Twitter.
Posted by Ziv Hodak and Roman Priborkin, Search Console team
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.
[null,null,[],[[["\u003cp\u003eGoogle Search Console's Search Analytics API now includes data for Discover and Google News, alongside existing Search data.\u003c/p\u003e\n"],["\u003cp\u003eThe API's \u003ccode\u003esearchType\u003c/code\u003e parameter is renamed to \u003ccode\u003etype\u003c/code\u003e and supports new values \u003ccode\u003ediscover\u003c/code\u003e and \u003ccode\u003egoogleNews\u003c/code\u003e for filtering data.\u003c/p\u003e\n"],["\u003cp\u003eUnsupported dimensions with certain data types will result in error messages from the API, aligning with the Search Console Performance reports' behavior.\u003c/p\u003e\n"],["\u003cp\u003eRegex support is added to the API's query and page dimensions with new operators \u003ccode\u003eincludingRegex\u003c/code\u003e and \u003ccode\u003eexcludingRegex\u003c/code\u003e for enhanced filtering.\u003c/p\u003e\n"]]],["Google Search Console's API now includes data for Google Discover and Google News, accessible via new `discover` and `googleNews` parameters within the renamed `type` parameter (formerly `searchType`). The API will return an error if unsupported dimensions are requested. Regex support has been added to query and page dimensions, with `includingRegex` and `excludingRegex` operators. Users can learn more through documentation and the Search Central community.\n"],null,["# Search Analytics API now supports Discover, Google News, and Regex\n\nMonday, October 25, 2021\n\n\nThe Google Search Console [Performance reports](https://support.google.com/webmasters/answer/7576553) already show data about Search,\nDiscover, and Google News to site owners that have this type of traffic. Since we launched the [Discover](https://support.google.com/webmasters/answer/9216516)\nand [Google News](https://support.google.com/webmasters/answer/10083653) performance reports, we've been receiving requests from\nusers to also add these stats to the [Search Analytics API](/webmaster-tools/search-console-api-original/v3/searchanalytics).\nWe are happy to announce that this is happening today.\n\n\nThe `searchType` parameter, which previously enabled you to filter API calls by `news`,\n`video`, `image`, and `web`, will be renamed to\n`type` and will support two additional parameters: `discover` (for Google Discover) and\n`googleNews` (for Google News). Please note that while we renamed the parameter to `type`,\nwe're still supporting the old name `searchType`.\n\n\nIn the Search Console Performance reports, some metrics and dimensions are compatible only with some data types; for example, queries and positions are not supported by\nthe Google Discover report. In the same way, if an unsupported dimension is requested, the API will return an error message.\n\n\nIn addition, we are adding [Regex support](/search/blog/2021/06/regex-negative-match) to the query and page dimensions.\nTwo new operators will be added to the existing match operations: `includingRegex` and `excludingRegex`.\n\n\nCheck out the [Search Analytics API documentation](/webmaster-tools/search-console-api-original/v3/searchanalytics/query) to learn more.\nIf you have any questions, you can ask in the [Search Central community](https://support.google.com/webmasters/community) or\n[on Twitter](https://twitter.com/googlesearchc).\n\n\nPosted by [Ziv Hodak](/search/blog/authors/ziv-hodak) and Roman Priborkin, Search Console team"]]
