API Sneak Peek

gistfile1.md

This is a preview of TubeLabs enterprise API filters. There are more available endpoints then displayed here.

This let's you access 400K+ channels. The data is updated in real-time, 24/7. Optimized for finding high-performing & recent channels.

/channels (GET / POST)

Fetches the channels index. Filterable by the following query parameters:

Query Parameters

Parameter	Type	Description	Optional
query	array of string	Search semantically or use handler or channel id queries	✓
seed	string/number/null	Randomizes results based on this seed	✓
from	integer	Pagination offset	✓
size	integer	Pagination limit	✓
filterBy	"short" or "video"	Will use the statistics filters related to this kind of content	✓
contentKind	"short" or "video"	Filter channels that produce more of this kind of content	✓
publishedAtFrom	string	Filter channels with oldest parsed upload after this date	✓
publishedAtTo	string	Filter channels with most recent upload before this date	✓
averageViewsFrom	integer	Minimum average views	✓
averageViewsTo	integer	Maximum average views	✓
language	string	ISO 6391 Language code language	✓
avgViewsToSubscribersRatioFrom	integer	Minimum average views to subscribers ratio	✓
avgViewsToSubscribersRatioTo	integer	Maximum average views to subscribers ratio	✓
subscribersFrom	integer	Minimum subscribers count	✓
subscribersTo	integer	Maximum subscribers count	✓
viewVariationCoefficientFrom	float	Minimum viewVariationCoefficient	✓
viewVariationCoefficientTo	float	Maximum viewVariationCoefficient	✓
videosCountFrom	integer	Minimum videos count	✓
videosCountTo	integer	Maximum videos count	✓
consistentViews	boolean	Filter channels with consistent views	✓
monetizationAdsense	boolean	Filter channels with adsense enabled	✓
monetizationSponsored	boolean	Filter channels with sponsored videos	✓
rpmEstimationFrom	number	Minimum RPM estimation	✓
rpmEstimationTo	number	Maximum RPM estimation (Max. 50)	✓
revenueMonthlyEstimationFrom	number	Minimum revenue monthly estimation	✓
revenueMonthlyEstimationTo	number	Maximum revenue monthly estimation	✓
avgDurationFrom	number	Minimum duration in seconds	✓
avgDurationTo	number	Maximum duration in seconds	✓
classificationIsFaceless	boolean	Filter by faceless classification	✓
classificationQuality	negative or neutral or positive	Filter by quality classification	✓
referenceId	string	Reference ID for filtering	✓
sortBy	string	Sort by one of subscribers, averageViews, avgViewsToSubscribersRatio, viewVariationCoefficient, revenueMonthly, rpm, foundAt, recency - when combined with query truncates results to only relevant ones	✓
sortOrder	string	Sort order, either asc or desc	✓

Example Request

GET /channels?size=12&query=minecraft&sortBy=averageViews

Body parameters (POST)

You can also pass in a body for filtering channelIds (used for collections)

Parameter	Type	Description	Optional	Notes
channelIds	array	List of channel IDs to filter	✓

Notes

• Parameters from and size are used for pagination. Default values are 0 and 20 respectively.
• Filters such as averageViewsFrom, averageViewsTo, subscribersFrom, and subscribersTo allow for range-based filtering.
• The consistentViews parameter filters channels with consistent views, accepting a boolean value.
• The referenceId parameter can be used to filter by a specific reference ID.
• The monetizationSponsored is unstable (work in progress)