Revenue Metrics

This query provides detailed revenue metrics for a YouTube channel over a specified time period, including estimated total revenue, ad revenue, and YouTube Premium revenue. Data can be aggregated by day or month.

Parameters

Dimension

Specifies how to aggregate the data:

• Day: Daily aggregation.
• Month: Monthly aggregation (requires start and end dates to be first day of a month).

Note: Note that rolling seven or thirty days are not supported by the Analytics API anymore.

Start Date

The beginning date for fetching analytics data in format YYYY-MM-DD (e.g., 2024-01-01).

• Cannot be in the future.
• Must align with month start if using monthly dimension.

End Date

The end date for fetching analytics data in format YYYY-MM-DD (e.g., 2024-09-30).

• Cannot be in the future.
• Must be after Start Date.
• Must align with month end if using monthly dimension.

Tip: For scheduled requests, you may need to update the date daily. Instead of specifying the date manually, you can use 'today' or 'yesterday' as the parameter. When the request runs, the date will automatically adjust to the desired day.

IDs

Specifies the channel for which to retrieve data.

• Options:
  • "channel==MINE": Fetches data for your own channel.
  • "channel==CHANNEL_ID": Retrieves data for a specific channel you own.

Sort (Optional)

Determines the order of results:

• Examples:

  • "-estimatedRevenue" for sorting by total revenue in descending order.
  • "-estimatedAdRevenue" for sorting by ad revenue in descending order.
  • "-estimatedRedPartnerRevenue" for sorting by YouTube Premium revenue in descending order.

  Tip: You can find the technical names of the metrics you can sort by when you click on the chart symbol at the bottom of the Parameters section.

Filters (Optional)

Defines specific data criteria:

• Examples:
  • "country==US" to filter by country.
  • 'video==VIDEO_ID' to filter by a specific video identified by its ID. Replace VIDEO_ID with the ID of a video from your channel. You can also enter a comma-separated list of video IDs to retrieve up to 200 results.

Columns

• Dimension: Day or month.

• Estimated Revenue: The total estimated revenue from all sources, including advertising and YouTube Premium.

• Estimated Ad Revenue: Estimated revenue from advertising sources only, including display ads, overlay ads, skippable and non-skippable video ads.

• Estimated YouTube Premium: Estimated revenue from YouTube Premium subscribers watching your content. This revenue is based on watch time and other factors.