How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Google AdMob API v1

The stable, entirely read-only channel of the AdMob API. Six operations: get and list publisher accounts, list apps, list ad units, and generate network and mediation reports. Converted from Google's first-party Discovery Document (revision 20260731) — 6 operations, 29 schemas. Google publishes no OpenAPI for AdMob.

Google AdMob API v1 is one of 2 APIs that Google AdMob publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 JSON Schema definition.

Tagged areas include Account, Application, and Ad Units. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, a JSON-LD context, and 1 JSON Schema.

This API exposes 6 operations across 6 paths, organized into 5 resource areas, and defines 29 schemas. It is described by OpenAPI 3.1.0, at version v1.

Requests are made against a single base URL, https://admob.googleapis.com.

6 operations 6 paths 29 schemas 4 GET2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
v1
Base URL
https://admob.googleapis.com
Authentication
OAuth 2.0
Contact
Terms of Service
Resource Areas
5

Authentication & Security 1

Google AdMob API v1 declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (GoogleOAuth2) using the authorizationCode flow, exposing 2 scopes. By default, every request must be authenticated.

  • GoogleOAuth2 — Google OAuth 2.0 user authorization. AdMob does not support service accounts.

Paths & Operations 6

Across 6 paths, the API surfaces 6 operations — 4 GET, 2 POST. They span 5 resource areas: accounts, networkReport, adUnits, apps, mediationReport. Each is listed below with its method, path, parameters, and response codes.

accounts 2
GET
/v1/accounts/{accountsId}
Gets information about the specified AdMob publisher account.
accounts_get 1 param → 200400401403429500
GET
/v1/accounts
Lists the AdMob publisher account that was most recently signed in to from the AdMob UI
accounts_list 2 params → 200400401403429500
networkReport 1
POST
/v1/accounts/{accountsId}/networkReport:generate
Generates an AdMob Network report based on the provided report specification
accounts_networkReport_generate 1 param body → 200400401403429500
adUnits 1
GET
/v1/accounts/{accountsId}/adUnits
List the ad units under the specified AdMob account.
accounts_adUnits_list 3 params → 200400401403429500
apps 1
GET
/v1/accounts/{accountsId}/apps
List the apps under the specified AdMob account.
accounts_apps_list 3 params → 200400401403429500
mediationReport 1
POST
/v1/accounts/{accountsId}/mediationReport:generate
Generates an AdMob Mediation report based on the provided report specification
accounts_mediationReport_generate 1 param body → 200400401403429500

Schemas 29

The contract defines 29 schemas that model the data the API accepts and returns. The most detailed are NetworkReportSpec (8 properties), MediationReportSpec (8 properties), AdUnit (6 properties), App (6 properties). Each schema is shown below with its type and property counts.

NetworkReportSpecSortCondition
object
Sorting direction to be applied on a dimension or a metric.
3 properties
MediationReportSpec
object
The specification for generating an AdMob Mediation report. For example, the specification to get observed ECPM sliced by ad source and app for the 'US' and 'C…
8 properties
NetworkReportSpecDimensionFilter
object
Describes which report rows to match based on their dimension values.
2 properties
StringList
object
List of string values.
1 property
GenerateNetworkReportResponse
object
The streaming response for the AdMob Network report where the first response contains the report header, then a stream of row responses, and finally a footer a…
3 properties
ReportHeader
object
Groups data helps to treat the generated report. Always sent as a first message in the stream response.
3 properties
GenerateNetworkReportRequest
object
Request to generate an AdMob Network report.
1 property
LocalizationSettings
object
Localization settings for reports, such as currency and language. It affects how metrics are calculated.
2 properties
AdUnit
object
Describes an AdMob ad unit.
6 properties
ReportRow
object
A row of the returning report.
2 properties
MediationReportSpecSortCondition
object
Sorting direction to be applied on a dimension or a metric.
3 properties
App
object
Describes an AdMob app for a specific platform (For example: Android or iOS).
6 properties
ReportFooter
object
Groups data available after report generation, for example, warnings and row counts. Always sent as the last message in the stream response.
2 properties
ReportWarning
object
Warnings associated with generation of the report.
2 properties
ListPublisherAccountsResponse
object
Response for the publisher account list request.
2 properties
AppManualAppInfo
object
Information provided for manual apps which are not linked to an application store (Example: Google Play, App Store).
1 property
MediationReportSpecDimensionFilter
object
Describes which report rows to match based on their dimension values.
2 properties
GenerateMediationReportResponse
object
The streaming response for the AdMob Mediation report where the first response contains the report header, then a stream of row responses, and finally a footer…
3 properties
PublisherAccount
object
A publisher account contains information relevant to the use of this API, such as the time zone used for the reports.
4 properties
Date
object
Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is…
3 properties
ReportRowDimensionValue
object
Representation of a dimension value.
2 properties
DateRange
object
Specification of a single date range. Both dates are inclusive.
2 properties
ListAppsResponse
object
Response for the apps list request.
2 properties
AppLinkedAppInfo
object
Information from the app store if the app is linked to an app store.
2 properties
ListAdUnitsResponse
object
Response for the ad units list request.
2 properties
ReportRowMetricValue
object
Representation of a metric value.
3 properties
GenerateMediationReportRequest
object
Request to generate an AdMob Mediation report.
1 property
NetworkReportSpec
object
The specification for generating an AdMob Network report. For example, the specification to get clicks and estimated earnings for only the 'US' and 'CN' countr…
8 properties
GoogleRpcStatus
object
Canonical Google API error envelope (google.rpc.Status), returned inside an error wrapper.
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

google-admob-api-v1-openapi.yml Raw ↑

Other APIs Google AdMob publishes across the network.

Google AdMob API v1beta
Where this information came from

This is an independent, third-party profile of Google AdMob API v1, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.