API reference / YouTube / Audience demographics
Audience demographics
Estimated audience of a YouTube channel: countries, languages, categories, gender, age, and age by gender. Takes 20–60 seconds.
50 credits per successful call
Errors are never charged
Request
GET
https://socialgraph.dev/api/v1/youtube/audience
Send your API key as Authorization: Bearer YOUR_API_KEY.
Parameters go in the query string.
Parameters
| Name | Type | Description |
|---|---|---|
channelIdrequired |
string | Required. YouTube channel ID (24 characters, starts with UC). For example: UC_x5XG1OV2P6uZZ5FSM9Ttw |
Code examples
Example response
{
"kind": "youtube#channelAudienceResponse",
"items": {
"id": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
"kind": "youtube#channelAudience",
"audienceAge": {
"65+": 0.99,
"13-17": 0,
"18-24": 2.97,
"25-34": 38.61,
"35-44": 32.67,
"45-54": 18.81,
"55-64": 5.94
},
"audienceGender": {
"male": 86.14,
"female": 13.86
},
"audienceCountry": {
"AR": 5.17,
"AT": 1.72,
"AU": 3.45,
"BR": 5.17,
"DE": 1.72,
"DK": 1.72,
"EE": 1.72,
"ES": 1.72,
"GB": 5.17,
"GH": 1.72,
"ID": 1.72,
"IL": 1.72,
"IN": 10.34,
"IT": 1.72,
"JP": 1.72,
"MX": 1.72,
"NG": 3.45,
"PE": 1.72,
"PG": 1.72,
"PK": 1.72,
"PL": 1.72,
"RO": 1.72,
"RU": 1.72,
"TH": 1.72,
"TR": 3.45,
"TW": 3.45,
"US": 29.31
},
"audienceCategory": {
"1": 6.85,
"2": 0.21,
"10": 5.05,
"15": 0.16,
"17": 0.62,
"19": 3.16,
"20": 21.46,
"22": 26.63,
"23": 0.94,
"24": 7.8,
"25": 2.05,
"26": 4.1,
"27": 8.41,
"28": 12.35,
"29": 0.21
},
"audienceLanguage": {
"ar": 0.18,
"de": 0.09,
"en": 51.08,
"es": 0.72,
"fa": 0.09,
"fr": 6.45,
"hr": 0.72,
"id": 8.06,
"ja": 4.57,
"ko": 5.02,
"ml": 4.39,
"pt": 5.91,
"ro": 1.16,
"ru": 4.12,
"sv": 0.18,
"tr": 4.75,
"vi": 0.18,
"zh": 2.24,
"und": 0.09
},
"audienceAgeGender": [
{
"age": "13-17",
"count": 0,
"gender": "all"
},
{
"age": "13-17",
"count": 0,
"gender": "male"
},
{
"age": "13-17",
"count": 0,
"gender": "female"
},
{
"age": "18-24",
"count": 2.97,
"gender": "all"
},
{
"age": "18-24",
"count": 2.97,
"gender": "male"
},
{
"age": "18-24",
"count": 0,
"gender": "female"
},
{
"age": "25-34",
"count": 38.61,
"gender": "all"
},
{
"age": "25-34",
"count": 32.67,
"gender": "male"
},
{
"age": "25-34",
"count": 5.94,
"gender": "female"
},
{
"age": "35-44",
"count": 32.67,
"gender": "all"
},
{
"age": "35-44",
"count": 26.73,
"gender": "male"
},
{
"age": "35-44",
"count": 5.94,
"gender": "female"
},
{
"age": "45-54",
"count": 18.81,
"gender": "all"
},
{
"age": "45-54",
"count": 17.82,
"gender": "male"
},
{
"age": "45-54",
"count": 0.99,
"gender": "female"
},
{
"age": "55-64",
"count": 5.94,
"gender": "all"
},
{
"age": "55-64",
"count": 4.95,
"gender": "male"
},
{
"age": "55-64",
"count": 0.99,
"gender": "female"
},
{
"age": "65+",
"count": 0.99,
"gender": "all"
},
{
"age": "65+",
"count": 0.99,
"gender": "male"
},
{
"age": "65+",
"count": 0,
"gender": "female"
}
]
},
"pageInfo": {
"totalResults": 1
}
}Errors
| Status | Meaning | Charged? |
|---|---|---|
| 401 | Missing, invalid or revoked API key | No |
| 402 | Not enough credits (insufficient_credits) | No |
| 404 | The account or post doesn't exist | No |
| 422 | Missing or invalid parameters | No |
| 502 / 503 | The data source is temporarily unavailable | No |
Try it live: Audience demographics
GET
🔒 Preset demo input. Live demos use the Google for Developers channel, youtube.com/@GoogleDevelopers. Sign up free to use your own.
More YouTube endpoints
GET
Activities list
Read-only YouTube Data API v3 activities list endpoint.
/api/v1/youtube/activities
1 credit / call
GET
Channel sections list
Read-only YouTube Data API v3 channelSections list endpoint.
/api/v1/youtube/channelSections
1 credit / call
GET
Channels list
Read-only YouTube Data API v3 channels list endpoint.
/api/v1/youtube/channels
1 credit / call
GET
Comment threads list
Read-only YouTube Data API v3 commentThreads list endpoint.
/api/v1/youtube/commentThreads
1 credit / call
GET
Comments list
Read-only YouTube Data API v3 comments list endpoint.
/api/v1/youtube/comments
1 credit / call
GET
Internationalization languages list
Read-only YouTube Data API v3 i18nLanguages list endpoint.
/api/v1/youtube/i18nLanguages
1 credit / call