Appearance
Viewer Demographics by Age Group
This query provides insights into the age distribution of your YouTube channel's audience, showing the percentage of viewers across different age ranges.
Example Output

Parameters
Dimension
The dimension is set to "ageGroup" which breaks down viewer demographics by age ranges.
Start Date
The beginning date for fetching analytics data in format YYYY-MM-DD (e.g., 2024-01-01).
- Cannot be in the future.
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.
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)
Default sort is by age groups.
- Example: "ageGroup" for chronological sorting of age ranges
Filters (Optional)
Optional filters can be applied to narrow down the data:
- Example: "video==VIDEO_ID" to analyze age demographics for a specific video
- Can be combined with country filters for regional age demographics
Columns
Dimension: Age group category representing different age ranges of viewers.
Viewer Percentage: Percentage of views from each age group.
Notes
- Data is automatically formatted in the sheet with timestamps and filters
- Age group data helps understand the generational appeal of content
- Can be used to tailor content to specific age demographics
- Age data may not be available for all viewers
