# YouTube Analytics API API

> YouTube Analytics API API on Apizie: 8 endpoints (Returns a collection of group items that match the API request parameters., Creates a group item., Removes an item from a group., Returns a collection of groups that match the API request parameters. For example, you can retrieve all…, …) 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://apizie.tech/v1/dev-tools:google-youtube-analytics/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `dev-tools:google-youtube-analytics`
- Category: Dev Tools
- Status: byok
- Source: https://developers.google.com/youtube/analytics
- Page: https://apizie.tech/api/dev-tools/google-youtube-analytics
- OpenAPI: https://apizie.tech/api/dev-tools/google-youtube-analytics/openapi.json

Retrieves your YouTube Analytics data.

## Endpoints

### Returns a collection of group items that match the API request parameters.
`GET https://apizie.tech/v1/dev-tools:google-youtube-analytics/youtube-analytics-group-items-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| groupId | string | no | The `groupId` parameter specifies the unique ID of the group for which you want to retrieve group items. |
| onBehalfOfContentOwner | string | no | This parameter can only be used in a properly authorized request. **Note:** This parameter is intended exclusively for YouTube content… |

### Creates a group item.
`POST https://apizie.tech/v1/dev-tools:google-youtube-analytics/youtube-analytics-group-items-insert` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| onBehalfOfContentOwner | string | no | This parameter can only be used in a properly authorized request. **Note:** This parameter is intended exclusively for YouTube content… |
| body | object | yes | JSON request body |

### Removes an item from a group.
`POST https://apizie.tech/v1/dev-tools:google-youtube-analytics/youtube-analytics-group-items-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | no | The `id` parameter specifies the YouTube group item ID of the group item that is being deleted. |
| onBehalfOfContentOwner | string | no | This parameter can only be used in a properly authorized request. **Note:** This parameter is intended exclusively for YouTube content… |

### Returns a collection of groups that match the API request parameters. For example, you can retrieve all…
`GET https://apizie.tech/v1/dev-tools:google-youtube-analytics/youtube-analytics-groups-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | no | The `id` parameter specifies a comma-separated list of the YouTube group ID(s) for the resource(s) that are being retrieved. Each group… |
| mine | boolean | no | This parameter can only be used in a properly authorized request. Set this parameter's value to true to retrieve all groups owned by the… |
| onBehalfOfContentOwner | string | no | This parameter can only be used in a properly authorized request. **Note:** This parameter is intended exclusively for YouTube content… |
| pageToken | string | no | The `pageToken` parameter identifies a specific page in the result set that should be returned. In an API response, the `nextPageToken`… |

### Creates a group.
`POST https://apizie.tech/v1/dev-tools:google-youtube-analytics/youtube-analytics-groups-insert` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| onBehalfOfContentOwner | string | no | This parameter can only be used in a properly authorized request. **Note:** This parameter is intended exclusively for YouTube content… |
| body | object | yes | JSON request body |

### Modifies a group. For example, you could change a group's title.
`POST https://apizie.tech/v1/dev-tools:google-youtube-analytics/youtube-analytics-groups-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| onBehalfOfContentOwner | string | no | This parameter can only be used in a properly authorized request. **Note:** This parameter is intended exclusively for YouTube content… |
| body | object | yes | JSON request body |

### Deletes a group.
`POST https://apizie.tech/v1/dev-tools:google-youtube-analytics/youtube-analytics-groups-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | no | The `id` parameter specifies the YouTube group ID of the group that is being deleted. |
| onBehalfOfContentOwner | string | no | This parameter can only be used in a properly authorized request. **Note:** This parameter is intended exclusively for YouTube content… |

### Retrieve your YouTube Analytics reports.
`GET https://apizie.tech/v1/dev-tools:google-youtube-analytics/youtube-analytics-reports-query` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| currency | string | no | The currency to which financial metrics should be converted. The default is US Dollar (USD). If the result contains no financial metrics,… |
| dimensions | string | no | A comma-separated list of YouTube Analytics dimensions, such as `views` or `ageGroup,gender`. See the [Available… |
| endDate | string | no | The end date for fetching YouTube Analytics data. The value should be in `YYYY-MM-DD` format. required: true, pattern:… |
| filters | string | no | A list of filters that should be applied when retrieving YouTube Analytics data. The [Available… |
| ids | string | no | Identifies the YouTube channel or content owner for which you are retrieving YouTube Analytics data. - To request data for a YouTube user,… |
| includeHistoricalChannelData | boolean | no | If set to true historical data (i.e. channel data from before the linking of the channel to the content owner) will be retrieved.", |
| maxResults | integer | no | The maximum number of rows to include in the response.", minValue: 1 |
| metrics | string | no | A comma-separated list of YouTube Analytics metrics, such as `views` or `likes,dislikes`. See the [Available… |
| sort | string | no | A comma-separated list of dimensions or metrics that determine the sort order for YouTube Analytics data. By default the sort order is… |
| startDate | string | no | The start date for fetching YouTube Analytics data. The value should be in `YYYY-MM-DD` format. required: true, pattern:… |
| startIndex | integer | no | An index of the first entity to retrieve. Use this parameter as a pagination mechanism along with the max-results parameter (one-based,… |

## Example
```
curl "https://apizie.tech/v1/dev-tools:google-youtube-analytics/youtube-analytics-group-items-list" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the YouTube Analytics API API?
Create a free Apizie key, then send GET https://apizie.tech/v1/dev-tools:google-youtube-analytics/youtube-analytics-group-items-list with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

### Can AI agents use the YouTube Analytics API API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key dev-tools:google-youtube-analytics.

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