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

AdMob API

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 operations 6 paths 28 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

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_get 1 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_list 2 params → 200
adUnits 1
GET
/v1/accounts/{accountsId}/adUnits
List the ad units under the specified AdMob account.
accounts_adUnits_list 3 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
accounts_networkReport_generate 1 param body → 200
mediationReport 1
POST
/v1/accounts/{accountsId}/mediationReport:generate
Generates an AdMob Mediation report based on the provided report specification. Returns result of a server-side streamin
accounts_mediationReport_generate 1 param body → 200
apps 1
GET
/v1/accounts/{accountsId}/apps
List the apps under the specified AdMob account.
accounts_apps_list 3 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.

Source

admob-api-v1-openapi.yml Raw ↑
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.