# AdSense Management API API

> AdSense Management API API on Apizie: 25 endpoints (Gets information about the selected site., Updates a custom channel. This method can be called only by a restricted set of projects, which are usually…, Deletes a custom channel. This method can be called only by a restricted set of projects, which are usually…, Gets the ad blocking recovery tag of an account., …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/analytics:googleapis-adsense/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `analytics:googleapis-adsense`
- Category: Analytics
- Status: byok
- Source: https://developers.google.com/adsense/management/
- Page: https://zieapi.vercel.app/api/analytics/googleapis-adsense
- OpenAPI: https://zieapi.vercel.app/api/analytics/googleapis-adsense/openapi.json

The AdSense Management API allows publishers to access their inventory and run earnings and performance reports.

## Endpoints

### Gets information about the selected site.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-adsense/adsense-accounts-sites-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Required. Name of the site. Format: accounts/{account}/sites/{site} |

### Updates a custom channel. This method can be called only by a restricted set of projects, which are usually…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-adsense/adsense-accounts-adclients-customchannels-patch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Output only. Resource name of the custom channel. Format: accounts/{account}/adclients/{adclient}/customchannels/{customchannel} |
| updateMask | string | no | The list of fields to update. If empty, a full update is performed. |
| body | object | yes | JSON request body |

### Deletes a custom channel. This method can be called only by a restricted set of projects, which are usually…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-adsense/adsense-accounts-adclients-customchannels-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Required. Name of the custom channel to delete. Format: accounts/{account}/adclients/{adclient}/customchannels/{customchannel} |

### Gets the ad blocking recovery tag of an account.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-adsense/adsense-accounts-get-ad-blocking-recovery-tag` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Required. The name of the account to get the tag for. Format: accounts/{account} |

### Lists all accounts available to this user.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-adsense/adsense-accounts-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| pageSize | integer | no | The maximum number of accounts to include in the response, used for paging. If unspecified, at most 10000 accounts will be returned. The… |
| pageToken | string | no | A page token, received from a previous `ListAccounts` call. Provide this to retrieve the subsequent page. When paginating, all other… |

### Lists all accounts directly managed by the given AdSense account.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-adsense/adsense-accounts-list-child-accounts` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| pageSize | integer | no | The maximum number of accounts to include in the response, used for paging. If unspecified, at most 10000 accounts will be returned. The… |
| pageToken | string | no | A page token, received from a previous `ListChildAccounts` call. Provide this to retrieve the subsequent page. When paginating, all other… |
| parent | string | yes | Required. The parent account, which owns the child accounts. Format: accounts/{account} |

### Gets the ad unit code for a given ad unit. For more information, see [About the AdSense…
`GET https://zieapi.vercel.app/v1/analytics:googleapis-adsense/adsense-accounts-adclients-adunits-get-adcode` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Required. Name of the adunit for which to get the adcode. Format: accounts/{account}/adclients/{adclient}/adunits/{adunit} |

### Lists all the ad clients available in an account.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-adsense/adsense-accounts-adclients-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| pageSize | integer | no | The maximum number of ad clients to include in the response, used for paging. If unspecified, at most 10000 ad clients will be returned.… |
| pageToken | string | no | A page token, received from a previous `ListAdClients` call. Provide this to retrieve the subsequent page. When paginating, all other… |
| parent | string | yes | Required. The account which owns the collection of ad clients. Format: accounts/{account} |

### Lists all ad units under a specified account and ad client.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-adsense/adsense-accounts-adclients-adunits-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| pageSize | integer | no | The maximum number of ad units to include in the response, used for paging. If unspecified, at most 10000 ad units will be returned. The… |
| pageToken | string | no | A page token, received from a previous `ListAdUnits` call. Provide this to retrieve the subsequent page. When paginating, all other… |
| parent | string | yes | Required. The ad client which owns the collection of ad units. Format: accounts/{account}/adclients/{adclient} |

### Creates an ad unit. This method can be called only by a restricted set of projects, which are usually owned…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-adsense/adsense-accounts-adclients-adunits-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| parent | string | yes | Required. Ad client to create an ad unit under. Format: accounts/{account}/adclients/{adclient} |
| body | object | yes | JSON request body |

### Lists all the custom channels available for an ad unit.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-adsense/adsense-accounts-adclients-adunits-list-linked-custom-channe` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| pageSize | integer | no | The maximum number of custom channels to include in the response, used for paging. If unspecified, at most 10000 custom channels will be… |
| pageToken | string | no | A page token, received from a previous `ListLinkedCustomChannels` call. Provide this to retrieve the subsequent page. When paginating, all… |
| parent | string | yes | Required. The ad unit which owns the collection of custom channels. Format: accounts/{account}/adclients/{adclient}/adunits/{adunit} |

### Lists all the custom channels available in an ad client.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-adsense/adsense-accounts-adclients-customchannels-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| pageSize | integer | no | The maximum number of custom channels to include in the response, used for paging. If unspecified, at most 10000 custom channels will be… |
| pageToken | string | no | A page token, received from a previous `ListCustomChannels` call. Provide this to retrieve the subsequent page. When paginating, all other… |
| parent | string | yes | Required. The ad client which owns the collection of custom channels. Format: accounts/{account}/adclients/{adclient} |

### Creates a custom channel. This method can be called only by a restricted set of projects, which are usually…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-adsense/adsense-accounts-adclients-customchannels-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| parent | string | yes | Required. The ad client to create a custom channel under. Format: accounts/{account}/adclients/{adclient} |
| body | object | yes | JSON request body |

### Lists all the ad units available for a custom channel.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-adsense/adsense-accounts-adclients-customchannels-list-linked-ad-uni` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| pageSize | integer | no | The maximum number of ad units to include in the response, used for paging. If unspecified, at most 10000 ad units will be returned. The… |
| pageToken | string | no | A page token, received from a previous `ListLinkedAdUnits` call. Provide this to retrieve the subsequent page. When paginating, all other… |
| parent | string | yes | Required. The custom channel which owns the collection of ad units. Format:… |

### Lists active url channels.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-adsense/adsense-accounts-adclients-urlchannels-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| pageSize | integer | no | The maximum number of url channels to include in the response, used for paging. If unspecified, at most 10000 url channels will be… |
| pageToken | string | no | A page token, received from a previous `ListUrlChannels` call. Provide this to retrieve the subsequent page. When paginating, all other… |
| parent | string | yes | Required. The ad client which owns the collection of url channels. Format: accounts/{account}/adclients/{adclient} |

### Lists all the alerts available in an account.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-adsense/adsense-accounts-alerts-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| languageCode | string | no | The language to use for translating alert messages. If unspecified, this defaults to the user's display language. If the given language is… |
| parent | string | yes | Required. The account which owns the collection of alerts. Format: accounts/{account} |

### Lists all the payments available for an account.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-adsense/adsense-accounts-payments-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| parent | string | yes | Required. The account which owns the collection of payments. Format: accounts/{account} |

### Lists all the policy issues where the specified account is involved, both directly and through any AFP child…
`GET https://zieapi.vercel.app/v1/analytics:googleapis-adsense/adsense-accounts-policy-issues-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| pageSize | integer | no | The maximum number of policy issues to include in the response, used for paging. If unspecified, at most 10000 policy issues will be… |
| pageToken | string | no | A page token, received from a previous `ListPolicyIssues` call. Provide this to retrieve the subsequent page. When paginating, all other… |
| parent | string | yes | Required. The account for which policy issues are being retrieved. Format: accounts/{account} |

### Generates an ad hoc report.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-adsense/adsense-accounts-reports-generate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| account | string | yes | Required. The account which owns the collection of reports. Format: accounts/{account} |
| currencyCode | string | no | The [ISO-4217 currency code](https://en.wikipedia.org/wiki/ISO_4217) to use when reporting on monetary metrics. Defaults to the account's… |
| dateRange | string | no | Date range of the report, if unset the range will be considered CUSTOM. |
| dimensions | string | no | Dimensions to base the report on. |
| endDate.day | integer | no | Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day… |
| endDate.month | integer | no | Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. |
| endDate.year | integer | no | Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. |
| filters | string | no | A list of [filters](/adsense/management/reporting/filtering) to apply to the report. All provided filters must match in order for the data… |
| languageCode | string | no | The language to use for translating report output. If unspecified, this defaults to English ("en"). If the given language is not… |
| limit | integer | no | The maximum number of rows of report data to return. Reports producing more rows than the requested limit will be truncated. If unset,… |
| metrics | string | no | Required. Reporting metrics. |
| orderBy | string | no | The name of a dimension or metric to sort the resulting report on, can be prefixed with "+" to sort ascending or "-" to sort descending.… |
| reportingTimeZone | string | no | Timezone in which to generate the report. If unspecified, this defaults to the account timezone. For more information, see [changing the… |
| startDate.day | integer | no | Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day… |
| startDate.month | integer | no | Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. |
| startDate.year | integer | no | Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. |

### Generates a csv formatted ad hoc report.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-adsense/adsense-accounts-reports-generate-csv` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| account | string | yes | Required. The account which owns the collection of reports. Format: accounts/{account} |
| currencyCode | string | no | The [ISO-4217 currency code](https://en.wikipedia.org/wiki/ISO_4217) to use when reporting on monetary metrics. Defaults to the account's… |
| dateRange | string | no | Date range of the report, if unset the range will be considered CUSTOM. |
| dimensions | string | no | Dimensions to base the report on. |
| endDate.day | integer | no | Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day… |
| endDate.month | integer | no | Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. |
| endDate.year | integer | no | Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. |
| filters | string | no | A list of [filters](/adsense/management/reporting/filtering) to apply to the report. All provided filters must match in order for the data… |
| languageCode | string | no | The language to use for translating report output. If unspecified, this defaults to English ("en"). If the given language is not… |
| limit | integer | no | The maximum number of rows of report data to return. Reports producing more rows than the requested limit will be truncated. If unset,… |
| metrics | string | no | Required. Reporting metrics. |
| orderBy | string | no | The name of a dimension or metric to sort the resulting report on, can be prefixed with "+" to sort ascending or "-" to sort descending.… |
| reportingTimeZone | string | no | Timezone in which to generate the report. If unspecified, this defaults to the account timezone. For more information, see [changing the… |
| startDate.day | integer | no | Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day… |
| startDate.month | integer | no | Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. |
| startDate.year | integer | no | Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. |

### Gets the saved report from the given resource name.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-adsense/adsense-accounts-reports-get-saved` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Required. The name of the saved report to retrieve. Format: accounts/{account}/reports/{report} |

### Generates a saved report.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-adsense/adsense-accounts-reports-saved-generate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| currencyCode | string | no | The [ISO-4217 currency code](https://en.wikipedia.org/wiki/ISO_4217) to use when reporting on monetary metrics. Defaults to the account's… |
| dateRange | string | no | Date range of the report, if unset the range will be considered CUSTOM. |
| endDate.day | integer | no | Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day… |
| endDate.month | integer | no | Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. |
| endDate.year | integer | no | Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. |
| languageCode | string | no | The language to use for translating report output. If unspecified, this defaults to English ("en"). If the given language is not… |
| name | string | yes | Required. Name of the saved report. Format: accounts/{account}/reports/{report} |
| reportingTimeZone | string | no | Timezone in which to generate the report. If unspecified, this defaults to the account timezone. For more information, see [changing the… |
| startDate.day | integer | no | Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day… |
| startDate.month | integer | no | Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. |
| startDate.year | integer | no | Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. |

### Generates a csv formatted saved report.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-adsense/adsense-accounts-reports-saved-generate-csv` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| currencyCode | string | no | The [ISO-4217 currency code](https://en.wikipedia.org/wiki/ISO_4217) to use when reporting on monetary metrics. Defaults to the account's… |
| dateRange | string | no | Date range of the report, if unset the range will be considered CUSTOM. |
| endDate.day | integer | no | Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day… |
| endDate.month | integer | no | Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. |
| endDate.year | integer | no | Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. |
| languageCode | string | no | The language to use for translating report output. If unspecified, this defaults to English ("en"). If the given language is not… |
| name | string | yes | Required. Name of the saved report. Format: accounts/{account}/reports/{report} |
| reportingTimeZone | string | no | Timezone in which to generate the report. If unspecified, this defaults to the account timezone. For more information, see [changing the… |
| startDate.day | integer | no | Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day… |
| startDate.month | integer | no | Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. |
| startDate.year | integer | no | Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. |

### Lists saved reports.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-adsense/adsense-accounts-reports-saved-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| pageSize | integer | no | The maximum number of reports to include in the response, used for paging. If unspecified, at most 10000 reports will be returned. The… |
| pageToken | string | no | A page token, received from a previous `ListSavedReports` call. Provide this to retrieve the subsequent page. When paginating, all other… |
| parent | string | yes | Required. The account which owns the collection of reports. Format: accounts/{account} |

### Lists all the sites available in an account.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-adsense/adsense-accounts-sites-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| pageSize | integer | no | The maximum number of sites to include in the response, used for paging. If unspecified, at most 10000 sites will be returned. The maximum… |
| pageToken | string | no | A page token, received from a previous `ListSites` call. Provide this to retrieve the subsequent page. When paginating, all other… |
| parent | string | yes | Required. The account which owns the collection of sites. Format: accounts/{account} |

## Example
```
curl "https://zieapi.vercel.app/v1/analytics:googleapis-adsense/adsense-accounts-sites-get" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the AdSense Management API API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/analytics:googleapis-adsense/adsense-accounts-sites-get with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the AdSense Management API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. AdSense Management API itself also needs your own key from googleapis.com.

### Can AI agents use the AdSense Management API API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key analytics:googleapis-adsense.

### What is the status of the AdSense Management API API?
Needs your own provider key (bring your own key)