The AdMob API lets you manage your AdMob Mediation setup programmatically.
You can create and update [mediation
groups](https://developers.google.com/admob/api/v1/mediation-groups), add [ad source
instances](https://developers.google.com/admob/api/v1/ad-sources), and
provide the [ad unit
mappings](https://developers.google.com/admob/api/v1/ad-unit-mappings) to enable calls
to multiple [third-party networks](https://developers.google.com/admob/api/v1/ad-sources-reference.md.txt).

The following activities are available through the AdMob API and UI.

|   | Create | Patch | List |
|---|---|---|---|
| App | Yes |   | Yes |
| Ad unit | Yes |   | Yes |
| Ad unit mappings | Yes |   | Yes |
| Mediation group | Yes | Yes | Yes |

<br />

> [!NOTE]
> **Note:** This feature is in limited access. To get access, contact your account manager.

<br />

With the AdMob API you can:

- Create apps, link them to app stores, and add ad units.
- Create ad unit mappings for all of the waterfall ad sources you want included in your setup.
- Create a mediation group with geo targeting and waterfall ad sources with their associated ad unit mappings.
- Update a mediation group's ad sources, ad unit mappings, and eCPM values.

A mediation group can have many ad source instances, each having their own ad
unit mapping. For instance, mediation group `A` could have the following lines:

- Ad source `B` with eCPM $10 and ad unit mapping `b`
- Ad source `C` with eCPM $8 and ad unit mapping `c`
- Ad source `D` with eCPM $6 and ad unit mapping `d`

The hierarchy of objects and maps is as follows:

![Mediation overview](https://developers.google.com/static/admob/api/v1/images/mediation-overview.png)

## Get started

Start creating mediation groups, group lines, and mapping ad units
programmatically with the following examples:

- Complete your [setup](https://developers.google.com/admob/api/v1/getting-started.md.txt) to make requests using Curl.
- Programmatically get information on [ad
  sources](https://developers.google.com/admob/api/v1/ad-sources) and [adapters](https://developers.google.com/admob/api/v1/adapters-guide.md.txt) to [create ad
  unit mappings](https://developers.google.com/admob/api/v1/ad-unit-mappings).
- Create [apps and ad units](https://developers.google.com/admob/api/v1/app-ad-units.md.txt).
- Create [mediation
  groups](https://developers.google.com/admob/api/v1/mediation-groups).