Using the Ad Experience Report API

The Ad Experience Report API is a publicly available, open API (application programming interface) that allows you to get:

  • A list of sites that have a status of "Failing."
  • The status of any site.

The API lets developers build applications that interact directly with the Ad Experience Report. 

To learn more (English only), read the Ad Experience Report API documentation.

If you're not a developer, you can use the APIs explorer

If you're not a developer but want to use the Ad Experience Report API, you can do so via the APIs explorer to:

Get a list of sites that have a status of "Failing"

Note that sites that have a review status of "Passing" or "Not reviewed" ARE NOT included in the violatingSites response
  1. Visit the Ad Experience Report APIs explorer at https://developers.google.com/apis-explorer/#s/adexperiencereport/v1/adexperiencereport.violatingSites.list. The "Try this API" page is displayed.
  2. Clear the Google OAuth 2.0 checkbox.
  3. Click Execute. In the response section of the page, sites that are in "Failing" status are listed. Results for both desktop and mobile environments are listed.

Get the status of any site

  1. Visit the Ad Experience Report APIs explorer at https://developers.google.com/apis-explorer/#s/adexperiencereport/v1/adexperiencereport.sites.get. The "Try this API" page is displayed.
  2. In the "Request parameters" section, enter sites/ followed by the URL-encoded site name in the name field. For example, for https://www.google.com, you'd enter sites/https%3A%2F%2Fwww.google.com.
  3. Clear the Google OAuth 2.0 checkbox.
  4. Click Execute. In the response section of the page, the desktop and mobile better ads status of the specified site is listed.
Was this helpful?
How can we improve it?