Skip to content
OpenParablePublic APIs

AdSense Management API API

by googleapis.com

OAuthHTTPSAnalytics
Open documentation ↗

Overview

Accesses AdSense publishers' inventory and generates performance reports.

AdSense Management API is an analytics API from googleapis.com. Requests are authenticated with OAuth. It is served over HTTPS. Its OpenAPI description documents 39 endpoints.

At a glance

Authentication
OAuth
HTTPS
Yes
CORS
Unknown
Category
Analytics
Base URL
https://www.googleapis.com/adsense/v1.4
Version
v1.4
Endpoints
39
OpenAPI
Specification ↗
Spec updated
2021-09-23

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL
curl -X GET "https://www.googleapis.com/adsense/v1.4/accounts" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN"
JavaScript
const response = await fetch("https://www.googleapis.com/adsense/v1.4/accounts", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "Authorization": "Bearer YOUR_TOKEN",
  },
});
const data = await response.json();
console.log(data);
Python
import requests

response = requests.request(
    "GET",
    "https://www.googleapis.com/adsense/v1.4/accounts",
    headers={
    "Accept": "application/json",
    "Authorization": "Bearer YOUR_TOKEN",
    },
    timeout=30,
)
print(response.json())

Endpoints

MethodPathWhat it does
GET/accountsList all accounts available to this AdSense account.
GET/accounts/{accountId}Get information about the selected AdSense account.
GET/accounts/{accountId}/adclientsList all ad clients in the specified account.
GET/accounts/{accountId}/adclients/{adClientId}/adcodeGet Auto ad code for a given ad client.
GET/accounts/{accountId}/adclients/{adClientId}/adunitsList all ad units in the specified ad client for the specified account.
GET/accounts/{accountId}/adclients/{adClientId}/adunits/{adUnitId}Gets the specified ad unit in the specified ad client for the specified account.
GET/accounts/{accountId}/adclients/{adClientId}/adunits/{adUnitId}/adcodeGet ad code for the specified ad unit.
GET/accounts/{accountId}/adclients/{adClientId}/adunits/{adUnitId}/customchannelsList all custom channels which the specified ad unit belongs to.
GET/accounts/{accountId}/adclients/{adClientId}/customchannelsList all custom channels in the specified ad client for the specified account.
GET/accounts/{accountId}/adclients/{adClientId}/customchannels/{customChannelId}Get the specified custom channel from the specified ad client for the specified account.
GET/accounts/{accountId}/adclients/{adClientId}/customchannels/{customChannelId}/adunitsList all ad units in the specified custom channel.
GET/accounts/{accountId}/adclients/{adClientId}/urlchannelsList all URL channels in the specified ad client for the specified account.
GET/accounts/{accountId}/alertsList the alerts for the specified AdSense account.
DELETE/accounts/{accountId}/alerts/{alertId}Dismiss (delete) the specified alert from the specified publisher AdSense account.
GET/accounts/{accountId}/paymentsList the payments for the specified AdSense account.
GET/accounts/{accountId}/reportsGenerate an AdSense report based on the report request sent in the query parameters. Returns the result as JSON; to retrieve output in CSV format specify "alt=c
GET/accounts/{accountId}/reports/savedList all saved reports in the specified AdSense account.
GET/accounts/{accountId}/reports/{savedReportId}Generate an AdSense report based on the saved report ID sent in the query parameters.
GET/accounts/{accountId}/savedadstylesList all saved ad styles in the specified account.
GET/accounts/{accountId}/savedadstyles/{savedAdStyleId}List a specific saved ad style for the specified account.
GET/adclientsList all ad clients in this AdSense account.
GET/adclients/{adClientId}/adunitsList all ad units in the specified ad client for this AdSense account.
GET/adclients/{adClientId}/adunits/{adUnitId}Gets the specified ad unit in the specified ad client.
GET/adclients/{adClientId}/adunits/{adUnitId}/adcodeGet ad code for the specified ad unit.
GET/adclients/{adClientId}/adunits/{adUnitId}/customchannelsList all custom channels which the specified ad unit belongs to.
GET/adclients/{adClientId}/customchannelsList all custom channels in the specified ad client for this AdSense account.
GET/adclients/{adClientId}/customchannels/{customChannelId}Get the specified custom channel from the specified ad client.
GET/adclients/{adClientId}/customchannels/{customChannelId}/adunitsList all ad units in the specified custom channel.
GET/adclients/{adClientId}/urlchannelsList all URL channels in the specified ad client for this AdSense account.
GET/alertsList the alerts for this AdSense account.
DELETE/alerts/{alertId}Dismiss (delete) the specified alert from the publisher's AdSense account.
GET/metadata/dimensionsList the metadata for the dimensions available to this AdSense account.
GET/metadata/metricsList the metadata for the metrics available to this AdSense account.
GET/paymentsList the payments for this AdSense account.
GET/reportsGenerate an AdSense report based on the report request sent in the query parameters. Returns the result as JSON; to retrieve output in CSV format specify "alt=c
GET/reports/savedList all saved reports in this AdSense account.
GET/reports/{savedReportId}Generate an AdSense report based on the saved report ID sent in the query parameters.
GET/savedadstylesList all saved ad styles in the user's account.
GET/savedadstyles/{savedAdStyleId}Get a specific saved ad style from the user's account.

Questions

Does the AdSense Management API API need an API key?

Yes. The AdSense Management API API uses OAuth authentication; the documentation explains how to get credentials.

Does the AdSense Management API API support HTTPS?

Yes, the AdSense Management API API is served over HTTPS.

How many endpoints does the AdSense Management API API have?

Its OpenAPI description lists 39 endpoints in version v1.4. All of them are shown on this page.

What are alternatives to the AdSense Management API API?

Other Analytics APIs include Google Play Integrity API, versionhistory.googleapis.com API, Doc Converter, Perspective Comment Analyzer API, Safe Browsing API.

Compare alternatives →

Google Play Integrity API

Analytics

The Play Integrity API helps you check that you're interacting with your genuine app on a genuine Android device powered by Google Play services. The Play Integrity API has replaced SafetyNet Attestation and Android Device Verification.

OAuth1 endpoints

versionhistory.googleapis.com API

Analytics

Version History API - Prod

No auth4 endpoints

Doc Converter

Analytics

This api converts file formats of OpenXml and OpenOffice documents formats to vector files (e.g., svg)

No auth1 endpoints

Perspective Comment Analyzer API

Analytics

The Perspective Comment Analyzer API provides information about the potential impact of a comment on a conversation (e.g. it can provide a score for the "toxicity" of a comment). Users can leverage the "SuggestCommentScore" method to submit corrections to improve Perspective over time. Users can set the "doNotStore" flag to ensure that all submitted comments are automatically deleted after scores are returned.

OAuth2 endpoints

Safe Browsing API

Analytics

Enables client applications to check web resources (most commonly URLs) against Google-generated lists of unsafe web resources. The Safe Browsing APIs are for non-commercial use only. If you need to use APIs to detect malicious URLs for commercial purposes – meaning “for sale or revenue-generating purposes” – please refer to the Web Risk API.

No auth7 endpoints

Web Fonts Developer API

Analytics

The Google Web Fonts Developer API lets you retrieve information about web fonts served by Google.

No auth1 endpoints

Listed from APIs.guru (CC0).