README
For custom plans, please contact us.
For quick chat: https://t.me/api_chat_support
Support me: https://www.buymeacoffee.com/thegen
Sample requests
Download/Streaming Info
/dl?id=VIDEO_ID&cgeo=GEO_CODE
The quota cost is 6 units.
Video Info
/video?id=VIDEO_ID
Related Videos
/related?id=VIDEO_ID
With pagination:
/related?id=VIDEO_ID&token=PAGINATION_TOKEN
Note: Results count is 20.
Trending Videos
/trending?geo=GEO_CODE
Trending Type:
Applicable options are:
now
music
games
movies
Default option is now
Examples:
Trending in Music
/trending?geo=GEO_CODE&type=music
Trending in Games
/trending?geo=GEO_CODE&type=games
Note: Provides videos trending in any specific location. Result count may vary according to location trending data.
Channel
/channel?id=CHANNEL_ID
Sort channel video as newest:
/channel?id=CHANNEL_ID&sort_by=newest
Sort video as oldest:
/channel?id=CHANNEL_ID&sort_by=oldest
Sort video as popular:
/channel?id=CHANNEL_ID&sort_by=popular
With pagination:
/channel?id=CHANNEL_ID&sort_by=oldest&token=PAGINATION_TOKEN
Note: Provides channel info and video list details. Video list count is 30.
Search
Search videos, channels or playlists; filter or sort.
Default sort is relevance.
Search all i.e videos, channel and playlist:
/search?query=QUERY
Search type filter:
Videos:
/search?query=QUERY&type=video
Channesl:
/search?query=QUERY&type=channel
Playlists:
/search?query=QUERY&type=playlist
Movies:
/search?query=QUERY&type=movie
Shows:
/search?query=QUERY&type=show
Sort Search Results:
Relevance is default sort filter:
/search?query=QUERY&type=video&sort=relevance
Upload Date:
/search?query=QUERY&type=video&sort=date
Rating:
/search?query=QUERY&type=video&sort=rating
View Count:
/search?query=QUERY&type=video&sort=views
Duration Filter:
This filter is applicable with type video, movie and show only.
Applicable options for duration are
short - less than 4 min
medium - 4 to 20 min
long - more than 20 min
Example:
/search?query=QUERY&type=video&duration=medium
With other options:
/search?query=QUERY&type=video&sort=views&duration=medium
Upload Date Filter:
This filter is applicable with type video, movie and show only.
Applicable options for upload_date are:
hour
today
week
month
year
Example:
/search?query=QUERY&type=video&upload_date=today
With other options:
/search?query=QUERY&type=video&sort=views&duration=medium&upload_date=today
Features filter:
This filter is applicable with type video, movie and show only.
Applicable options for features are:
HD
subtitles
CCommons
3D
Live
Purchased
4K
360
Location
HDR
VR180
Multiple features could be joined by ','
Example: HD,subtitles
Query Example:
/search?query=QUERY&type=video&features=HD
/search?query=QUERY&type=video&features=HD,subtitles
With other options:
/search?query=QUERY&type=video&sort=views&duration=medium&upload_date=today&features=HD,subtitles
Pagination:
Example:
/search?query=QUERY&token=PAGINATION_TOKEN
/search?query=QUERY&type=video&sort=views&duration=medium&upload_date=today&features=HD,subtitles&token=PAGINATION_TOKEN
Playlist
/playlist?id=PLAYLIST_ID
With pagination:
/playlist?id=PLAYLIST_ID&token=PAGINATION_TOKEN
Comments
Get Comments of the particular video
/comments?id=VIDEO_ID
With pagination:
/comments?id=VIDEO_ID&token=PAGINATION_TOKEN
Optional Global Parameters:
pretty
Provides the pretty JSON. Application value is 1.
Example: /video?id=VIDEO_ID&pretty=1
geo
Sets the API region code. Applicable values are ISO 3166-2 country code of the region. Like US (default), UK, CA, IN, etc.
Example: /search?query=QUERY&geo=US
lang
Sets the locale/language for request. Like en, gb, hi, etc
Example: /search? Query=QUERY&lang=it
X-CACHEBYPASS
Bypasses cache. The quota cost is +1.
Must be passed in the header only with value 1.
