Similar Channels
Search for YouTube channels with related content to another channel.
/search/channels/relatedUse the format: Api-Key <token> as the value.
In: header
Query Parameters
Filter by statistics of each content kind
"video" | "short"Filter by type of content created by channel:
video- channel has videos;short- channel has shorts;long-form- channel has more long-form content;short-form- channel has more short-form content
"video" | "short" | "long-form" | "short-form"Filter by a channel's last parsed video upload date (from a sample of 100 videos) - Expects an ISO date time string.
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$date-time^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$date-time0 <= value <= 90071992547409910 < value <= 90071992547409910 <= value <= 90071992547409910 < value <= 9007199254740991ISO 639-1 language codes
Filter by the outlier score of a channel
0 <= value0 < value0 <= value <= 90071992547409910 < value <= 90071992547409910 <= value <= 90071992547409910 < value <= 90071992547409910 <= value0 < value0 <= value0 < value0 <= value0 < valueAverage duration of videos in seconds
0 <= value <= 90071992547409910 < value <= 9007199254740991Filter by whether the channel has AdSense enabled or not
Filter by whether the channel has sponsored content detected or not
Filter by whether the channel's AdSense monetization state has ever flipped (presence of monetizationChangedAt). Combine with monetizationAdsense set to false to find recently demonetized channels
Exclude niches from search results by keywords
AI classification of a channel quality. This is an estimation where negative is slop, and positive high quality content
"negative" | "neutral" | "positive"AI classification whether channel content has faceless potential or not
AI classification whether channel content features an on-camera presenter or not
Filter by the channel's dominant audience region, matching any of the given codes (OR). Codes are UN M49 subregion codes, e.g. 021 - Northern America, 154 - Northern Europe.
Audience data is an AI prediction, so it is estimation-grade and should be treated as a signal rather than a measurement.
Filter by audience age, matching channels whose significant audience age buckets intersect the audienceAgeFrom - audienceAgeTo range.
Audience data is an AI prediction, so it is estimation-grade and should be treated as a signal rather than a measurement.
0 <= value <= 90071992547409910 < value <= 9007199254740991Filter by the channel's dominant audience gender skew.
Audience data is an AI prediction, so it is estimation-grade and should be treated as a signal rather than a measurement.
"male" | "female" | "balanced"Filter by the channel's dominant audience household-income tier, matching any of the given tiers (OR).
Audience data is an AI prediction, so it is estimation-grade and should be treated as a signal rather than a measurement.
Filter channels that have any of the listed monetization methods detected (OR).
This filters the raw detection booleans from the channel's last parse, unlike monetizationAdsense and monetizationSponsored which filter the sticky derived monetization flags - the two can disagree after a monetization state flip.
Filter channels detected as made with AI. Tri-state: omit to ignore, true for detected, false for checked and not detected (e.g. human-made channels)
Filter channels detected as made for kids
Filter channels that joined YouTube after this date - Expects an ISO date time string.
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$date-timeAll-time view count of the channel
0 <= value <= 90071992547409910 < value <= 9007199254740991Estimated views per hour of the channel
0 <= value <= 90071992547409910 < value <= 9007199254740991Filter by terminated (inactive) channels
Read the seed channel(s) from the terminated index (defaults to terminated)
Page to fetch
00 <= value <= 9007199254740991Number of items per page
200 < value <= 40Response Body
{
"pagination": {
"total": 100,
"from": 0,
"size": 20
},
"hits": [
{
"id": "UChn5jutPQB_bRjnG80pzl5w",
"snippet": {
"handle": "@tubelabhq",
"title": "TubeLab",
"thumbnails": {
"default": {
"url": "string"
},
"medium": {
"url": "string"
},
"high": {
"url": "string"
}
},
"contentKind": [
"video",
"short",
"long-form"
]
},
"time": "2019-08-24T14:15:22Z",
"semantic": {
"niches": [
"string"
],
"description": "string"
},
"monetization": {
"adsense": true,
"revenueMonthlyEstimationFrom": 0,
"rpmEstimationFrom": 0,
"revenueMonthlyEstimationTo": 0,
"rpmEstimationTo": 0,
"monetizationChangedAt": "2019-08-24T14:15:22Z"
},
"language": "string",
"classification": {
"isFaceless": true,
"isOnCamera": true,
"quality": "positive"
},
"audience": {
"dominant": {
"region": "021",
"age": "25-34",
"gender": "male",
"income": "middle"
}
},
"detections": {
"adsense": {
"detected": true
},
"sponsored": {
"detected": true
},
"affiliate": {
"detected": true
},
"product": {
"detected": true
},
"donations": {
"detected": true
},
"course": {
"detected": true
},
"newsletter": {
"detected": true
},
"community": {
"detected": true
},
"services": {
"detected": true
},
"madeWithAI": {
"detected": true
},
"forKids": {
"detected": true
}
},
"videos": [
{
"id": "SVeXR66hcIg",
"title": "string",
"thumbnails": {
"default": {
"url": "string",
"width": 0,
"height": 0
},
"medium": {
"url": "string",
"width": 0,
"height": 0
},
"high": {
"url": "string",
"width": 0,
"height": 0
}
},
"publishedAtEstimate": "2019-08-24T14:15:22Z",
"viewCount": 9007199254740991,
"statistics": {
"isPositiveOutlier": true
}
}
],
"shorts": [
{
"id": "SVeXR66hcIg",
"title": "string",
"thumbnails": [
{
"url": "string",
"width": 0,
"height": 0
}
],
"viewCount": 9007199254740991
}
],
"statistics": {
"subscriberCount": 9007199254740991,
"subscriberCountRaw": "string",
"viewCountEstimate": 0,
"viewCountMonthlyEstimate": 0,
"videosCount": 9007199254740991,
"videosSampleCount": 9007199254740991,
"videosCountRaw": "string",
"averageViewsEstimate": 0,
"medianViewsEstimate": 0,
"averageVideoDurationEstimate": 0,
"standardDeviationViewsEstimate": 0,
"viewVariationCoefficient": 0,
"avgViewsToSubscribersRatio": 0,
"lastPublishedAtEstimate": "string",
"oldestParsedPublishedAtEstimate": "string",
"positiveOutliersCount": 9007199254740991,
"negativeOutliersCount": 9007199254740991
}
}
]
}{
"error": {
"errors": [
{
"code": "string",
"validation": "string",
"message": "string",
"path": [
"string"
]
}
]
},
"status": "string"
}{
"error": {
"message": "string"
},
"status": "string"
}{
"error": {
"message": "string"
},
"status": "string"
}{
"error": {
"message": "string",
"rateLimit": {
"limit": -9007199254740991,
"current": -9007199254740991,
"remaining": -9007199254740991,
"resetTime": "2019-08-24T14:15:22Z"
}
},
"status": "string"
}