Reference
Outliers
Search for videos directly from the YouTube Outliers Finder library with AI enhanced data and 30+ filters. Updated in real-time, 24/7.
GET
/search/outliersAuthorization<token>
Use the format: Api-Key <token> as the value.
In: header
Query Parameters
query?array<string>
Search queries
seed?string & number | null
Randomize search results by passing a random seed
sortBy?string
Sort results by a specific metric:
Beaware when using semantic search (applying a query with the by parameter set to semantic) the sorting option is only applied within the nearest videos found and not the entire dataset.
views- sort by viewszScore- sort by zScoreaverageViewsRatio- sort by average views ratiopublishedAt- sort by published at (this is only within the k-sample )revenue- sort by revenue estimationrpm- sort by RPM estimation
Value in
"views" | "zScore" | "averageViewsRatio" | "publishedAt" | "revenue" | "rpm"sortOrder?string
Sorting order of results, where asc is ascending and desc is descending
type?string
Value in
"video" | "short"averageViewsRatioFrom?number
averageViewsRatioTo?number
zScoreFrom?number
zScoreTo?number
viewCountFrom?integer
Range
0 <= value <= 9007199254740991viewCountTo?integer
Range
0 < value <= 9007199254740991language?string
durationFrom?integer
Range
0 <= value <= 9007199254740991durationTo?integer
Range
0 < value <= 9007199254740991publishedAtFrom?string
publishedAtTo?string
Match
^(?:(?:\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))$Format
date-timesubscribersCountFrom?integer
Range
0 <= value <= 9007199254740991subscribersCountTo?integer
Range
0 < value <= 9007199254740991channelAvgViewsFrom?number
Range
0 <= valuechannelAvgViewsTo?number
Range
0 < valuechannelVideoCountFrom?integer
Range
0 <= value <= 9007199254740991channelVideoCountTo?integer
Range
0 < value <= 120channelId?string
channelAvgViewsToSubscribersRatioFrom?number
Range
0 <= valuechannelAvgViewsToSubscribersRatioTo?number
Range
0 < valuetitlePattern?string
Match
^(?=.*\*)(?=.*[a-zA-ZÀ-ÿ].*[a-zA-ZÀ-ÿ]).*$Length
2 <= length <= 200referenceId?string
Length
1 <= lengthrpmEstimationFrom?number
Range
0 <= valuerpmEstimationTo?number
Range
0 < valuerevenueEstimationFrom?number
Range
0 <= valuerevenueEstimationTo?number
Range
0 < valuechannelMonetizationAdsense?boolean
classificationQuality?string
Value in
"negative" | "neutral" | "positive"classificationIsFaceless?boolean
excludeKeyword?array<string>
from?integer
Page to fetch
Default
0Range
0 <= value <= 9007199254740991size?integer
Number of items per page
Default
20Range
0 < value <= 40by?string
Search by semantics (meaning of words) or lexical (exact words)
Default
"semantic"Value in
"semantic" | "lexical"Response Body
{
"pagination": {
"total": 0,
"from": 0,
"size": 0
},
"hits": [
{
"id": "SVeXR66hcIg",
"kind": "video",
"snippet": {
"channelId": "UChn5jutPQB_bRjnG80pzl5w",
"channelTitle": "string",
"channelHandle": "string",
"channelSubscribers": 0,
"title": "string",
"publishedAt": "2019-08-24T14:15:22Z",
"language": "en",
"thumbnails": {
"default": {
"url": "http://example.com",
"width": 0,
"height": 0
},
"medium": {
"url": "http://example.com",
"width": 0,
"height": 0
},
"high": {
"url": "http://example.com",
"width": 0,
"height": 0
}
},
"duration": 120,
"monetization": {
"rpmEstimationFrom": 0,
"revenueEstimationFrom": 0,
"revenueEstimationTo": 0,
"rpmEstimationTo": 0
},
"channelMonetization": {
"revenueMonthlyEstimationFrom": 0,
"rpmEstimationFrom": 0,
"revenueMonthlyEstimationTo": 0,
"rpmEstimationTo": 0,
"adsense": true
}
},
"statistics": {
"commentCount": 0,
"likeCount": 0,
"viewCount": 0,
"zScore": 0,
"averageViewsRatio": 0,
"isPositiveOutlier": true,
"isNegativeOutlier": true
},
"classification": {
"isFaceless": true,
"quality": "negative"
},
"time": "string"
}
]
}{
"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"
}