Coub API - HelpSeeker/CoubDownloader Wiki

One of the biggest problems with Coub is the lack of an up-to-date API documentation. This page is supposed to summarize my experiences with Coub's API, which aren't documented elsewhere.



In the past Coub provided up to 3 audio versions:

I don't know when they changed it or why, but the standalone AAC streams are gone. Normally they were listed under the mobile file versions, but now only the [email protected] stream shows up. A weird move, since they still use AAC audio for their share version, but after all it's Coub we're talking about. I've given up on trying to understand their moves.

Anyway, that means that a lot of AAC related code can be removed going forward.


This list is supposed to give a quick overview over all the API calls you can encounter on Coub's own website.

# Channels<channel>         -> /api/v2/timeline/channel/<channel><channel>/coubs   -> /api/v2/timeline/channel/<channel>?type=simples<channel>/reposts -> /api/v2/timeline/channel/<channel>?type=recoubs<channel>/stories -> /api/v2/timeline/channel/<channel>?type=stories

# Channel sorting is done via a dropdown menu and applies to all of the previous URLs

"Most recent" -> /api/v2/timeline/channel/<channel>?order_by=newest (default)
"Most liked"  -> /api/v2/timeline/channel/<channel>?order_by=likes_count
"Most viewed" -> /api/v2/timeline/channel/<channel>?order_by=views_count
"Oldest"      -> /api/v2/timeline/channel/<channel>?order_by=oldest
"Random"      -> /api/v2/timeline/channel/<channel>?order_by=random

# Tags<tag>       -> /api/v2/timeline/tag/<tag>?order_by=newest_popular<tag>/likes -> /api/v2/timeline/tag/<tag>?order_by=likes_count<tag>/views -> /api/v2/timeline/tag/<tag>?order_by=views_count<tag>/fresh -> /api/v2/timeline/tag/<tag>?order_by=newest

# Searches<term>          -> /api/v2/search?q=<term><term>    -> /api/v2/search?q=<term>&order_by=likes_count<term>    -> /api/v2/search?q=<term>&order_by=views_count<term>    -> /api/v2/search?q=<term>&order_by=newest<term> -> /api/v2/search/channels?q=<term>&order_by=followers_count

# Start page    -> /api/v2/timeline/subscriptions/monthly -> /api/v2/timeline/subscriptions/rising  -> /api/v2/timeline/subscriptions/fresh

# The hot section also has a dropdown menu to change the timescale

"Daily"      -> /api/v2/timeline/subscriptions/daily
"Weekly"     -> /api/v2/timeline/subscriptions/weekly
"Monthly"    -> /api/v2/timeline/subscriptions/monthly (default)
"Quarterly"  -> /api/v2/timeline/subscriptions/quarter
"Six months" -> /api/v2/timeline/subscriptions/half

# Random     -> /api/v2/timeline/explore/random -> /api/v2/timeline/explore/random?order_by=top

# The random category also allows additional sorting via tabs

"Popular" -> /api/v2/timeline/explore/random (default; no order_by)
"Top"     -> /api/v2/timeline/explore/random?order_by=top

# Communities<community>        -> /api/v2/timeline/community/<community>/monthly<community>/rising -> /api/v2/timeline/community/<community>/rising<community>/fresh  -> /api/v2/timeline/community/<community>/fresh<community>/top    -> /api/v2/timeline/community/<community>/fresh?order_by=likes_count<community>/views  -> /api/v2/timeline/community/<community>/fresh?order_by=views_count<community>/random -> /api/v2/timeline/random/<community>

# A community's hot section also allows to select a timescale via dropdown menu

"Daily"      -> /api/v2/timeline/community/<community>/daily
"Weekly"     -> /api/v2/timeline/community/<community>/weekly
"Monthly"    -> /api/v2/timeline/community/<community>/monthly (default)
"Quarterly"  -> /api/v2/timeline/community/<community>/quarter
"Six months" -> /api/v2/timeline/community/<community>/half

# Featured     -> /api/v2/timeline/explore       -> /api/v2/stories/featured -> /api/v2/stories/featured?order_by=likes_count      -> /api/v2/channels/featured_channels

# The feature community also allows additional sorting via tabs

"Recent"           -> /api/v2/timeline/explore (default; no order_by)
"Top of the Month" -> /api/v2/timeline/explore?order_by=top_of_the_month
"Undervalued"      -> /api/v2/timeline/explore?order_by=undervalued

# Coub of the Day -> /api/v2/timeline/explore/coub_of_the_day

# The Coub of the Day community also allows additional sorting via tabs

"Recent"      -> /api/v2/timeline/explore/coub_of_the_day (default; no order_by)
"Top"         -> /api/v2/timeline/explore/coub_of_the_day?order_by=top
"Views Count" -> /api/v2/timeline/explore/coub_of_the_day?order_by=views_count

Question of the day

What is the difference between api/v2/timeline/explore/COMMUNITY and api/v2/timeline/community/COMMUNITY?


Stories (completely missing from the documentation)

/api/v2/stories/featured -> list of popular stories featured on Coub's start page
/api/v2/stories/<id>     -> response JSON for a single story (lists coubs under story_coubs)


/api/v2/channels/featured_channels -> list of popular channels featured on Coub's start page
# allows up to 30 items per page (the usual cap is 25)

Timeline exploring

Timeline exploring covers and (default sort is recent; also accepts top_of_the_month and undervalued) and (default sort is recent; also accepts top and views_count).

Coub Picks

Just an official channel that reposts popular coubs.


/api/v2/weekly_digests/*number*/coubs (number being the number of the week; seems like they started counting at some point and just increase the count)
/api/v2/best (show all available years and the endpoints for their tabs)
⚠️ ** Fallback** ⚠️