REST/JSON API providing programmatic access to AdMob account data, apps, ad units, mediation configuration, and network, mediation and campaign performance reports. v1 is read-only; v1beta adds the write surface for apps, ad units, ad unit mappings, mediation groups and mediation A/B experiments. Authorized with Google OAuth 2.0 user credentials; service accounts are not supported.
This API exposes
6 operations
across 6 paths,
organized into 5 resource areas,
and defines 28 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 operations6 paths28 schemas4 GET2 POST
Metadata
The identity and technical contract details declared by the specification.
AdMob API 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. See https://developers.google.com/admob/api/v1/auth
Paths & Operations 6
Across 6 paths, the API surfaces 6 operations — 4 GET, 2 POST. They span 5 resource areas: accounts, adUnits, networkReport, mediationReport, apps. 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_get1 param→ 200
GET
/v1/accounts
Lists the AdMob publisher account that was most recently signed in to from the AdMob UI. For more information, see https
accounts_list2 params→ 200
adUnits 1
GET
/v1/accounts/{accountsId}/adUnits
List the ad units under the specified AdMob account.
accounts_adUnits_list3 params→ 200
networkReport 1
POST
/v1/accounts/{accountsId}/networkReport:generate
Generates an AdMob Network report based on the provided report specification. Returns result of a server-side streaming
Generates an AdMob Mediation report based on the provided report specification. Returns result of a server-side streamin
accounts_mediationReport_generate1 parambody→ 200
apps 1
GET
/v1/accounts/{accountsId}/apps
List the apps under the specified AdMob account.
accounts_apps_list3 params→ 200
Schemas 28
The contract defines 28 schemas that model the data the API accepts and returns. The most detailed are MediationReportSpec (8 properties), NetworkReportSpec (8 properties), AdUnit (6 properties), App (6 properties). Each schema is shown below with its type and property counts.
DateRange
object
Specification of a single date range. Both dates are inclusive.
2 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
AppLinkedAppInfo
object
Information from the app store if the app is linked to an app store.
2 properties
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
AppManualAppInfo
object
Information provided for manual apps which are not linked to an application store (Example: Google Play, App Store).
1 property
ReportWarning
object
Warnings associated with generation of the report.
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
MediationReportSpecSortCondition
object
Sorting direction to be applied on a dimension or a metric.
3 properties
GenerateNetworkReportRequest
object
Request to generate an AdMob Network report.
1 property
ReportRow
object
A row of the returning report.
2 properties
AdUnit
object
Describes an AdMob ad unit.
6 properties
ListPublisherAccountsResponse
object
Response for the publisher account list request.
2 properties
ListAdUnitsResponse
object
Response for the ad units list request.
2 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
ReportHeader
object
Groups data helps to treat the generated report. Always sent as a first message in the stream response.
3 properties
GenerateMediationReportRequest
object
Request to generate an AdMob Mediation report.
1 property
NetworkReportSpecSortCondition
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
ReportRowDimensionValue
object
Representation of a dimension value.
2 properties
StringList
object
List of string values.
1 property
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
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
LocalizationSettings
object
Localization settings for reports, such as currency and language. It affects how metrics are calculated.
2 properties
MediationReportSpecDimensionFilter
object
Describes which report rows to match based on their dimension values.
2 properties
ListAppsResponse
object
Response for the apps list request.
2 properties
NetworkReportSpecDimensionFilter
object
Describes which report rows to match based on their dimension values.
2 properties
ReportRowMetricValue
object
Representation of a metric value.
3 properties
Specification
The full machine-readable OpenAPI contract behind this narrative.
Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.
Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.
MCP tools for apis
4 tools reach this content
search_api_evangelistSearch every content type across the network at once.
find_relatedThe shared-tag relevance graph — what else covers this.
get_tagEverything one tag labels, across all content types.
guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
A second provider on the same verified email joins the account you already have.
Your account
ⓘWhere this information came from
This is an independent, third-party profile of AdMob API, 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.