ReelShort API endpoint
Returns ReelShort's (reelshort.com) home page as ranked shelves of short dramas (New Release, TOP, Reel Original, Hidden Identity, and so on): shelf id and name, and for each title its id, title, description, cover, ReelShort link, episode count, tags, plays, favorites and the episode from which viewing is paid. Pass a shelf id to reelshort-shelf for the whole list. Only public catalog metadata is read; no playable video is returned.
/reelshort/homeQuery parameters:
language: optional site locale: en, es, pt, fr, de, it, ja, ko, th, id, tr, ar, ru, pl, ro, cs, bg, vi or zh-TW. Defaults to en. Shelf names, titles, descriptions and tags are translated, and each locale has its own library.Notable response behavior:
id (pass it to reelshort-shelf for the whole shelf), a name and ten to eighteen books.plays and favorites are ReelShort's own counters. first_paid_episode is the episode number from which episodes are paid (0 when none is listed).Example response (long values and lists shortened):
{
"code": 200,
"msg": "OK",
"data": {
"language": "en",
"shelves": [
{
"id": 51003505,
"name": "New Release",
"books": [
{
"id": "6ab397e13282a14d03058cf7",
"title": "The Alpha's Forbidden Bunny",
"description": "In the beastkin world, Toby (a rabbit whose impending marriage was called off) is forced into an arranged marr…",
"cover_url": "https://v-img.crazymaplestudios.com/v-images/book_cover_batch/204200150000007655/56a1edb3-66b9-43f6-8ef4-8e005…",
"url": "https://www.reelshort.com/movie/the-alpha-s-forbidden-bunny-6ab397e13282a14d03058cf7",
"episodes": 38,
"tags": [
"Playing Dumb"
],
"plays": 1921782,
"favorites": 27334,
"first_paid_episode": 11,
"has_trailer": true,
"language": "en"
},
{
"id": "6a9a2a1759516005be053227",
"title": "Spoiled by Four Sea Monster Husbands",
"description": "Alice is swept into the undersea world of Atlantis and becomes the mute, wicked supporting character everyone…",
"cover_url": "https://v-img.crazymaplestudios.com/v-images/book_cover_batch/204200150000006008/bd72681c-aa81-497d-80d5-687cd…",
"url": "https://www.reelshort.com/movie/spoiled-by-four-sea-monster-husbands-6a9a2a1759516005be053227",
"episodes": 42,
"tags": [
"Playing Dumb"
],
"plays": 1425166,
"favorites": 22849,
"first_paid_episode": 13,
"has_trailer": true,
"language": "en"
}
]
},
{
"id": 51003506,
"name": "TOP",
"books": [
{
"id": "6a3d980baaf954b86307ecc4",
"title": "Rise of the Caged King",
"description": "Once a business elite, Silas is framed for murder by his rival Chase and his own wife Marina. Sentenced to 60…",
"cover_url": "https://v-img.crazymaplestudios.com/v-images/book_cover_batch/200000000000005418/5507e9c1-44cd-4b4f-984f-afa8a…",
"url": "https://www.reelshort.com/movie/rise-of-the-caged-king-6a3d980baaf954b86307ecc4",
"episodes": 64,
"tags": [
"Playing Dumb"
],
"plays": 41862670,
"favorites": 321965,
"first_paid_episode": 13,
"has_trailer": true,
"language": "en"
},
{
"id": "67f6d31af51c3a3b9e0549f2",
"title": "Undercover Prison King",
"description": "When ex-soldier Troy Poe inherits a corrupt private prison, he decides to go in undercover as an inmate to exp…",
"cover_url": "https://v-img.crazymaplestudios.com/v-images/book_cover_batch/200000000000000213/5abcdb27-ef1b-4f35-92e0-03b3c…",
"url": "https://www.reelshort.com/movie/undercover-prison-king-67f6d31af51c3a3b9e0549f2",
"episodes": 80,
"tags": [
"Hidden Identity"
],
"plays": 240006828,
"favorites": 1674993,
"first_paid_episode": 10,
"has_trailer": true,
"language": "en"
}
]
}
]
}
}
| Field | Filled in, of 11 checked | Values in the sample |
|---|---|---|
| id | 11 | |
| name | 11 | “New Release” and 10 other values |
| books | 11 | median 10 entries |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| language | string | No | en | Site locale, one of: en, es, pt, fr, de, it, ja, ko, th, id, tr, ar, ru, pl, ro, cs, bg, vi, zh-TW; defaults to en. Titles and tags are translated Allowed values: en, es, pt, fr, de, it, ja, ko, th, id, tr, ar, ru, pl, ro, cs, bg, vi, zh-TW. | es |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/reelshort/home?language=en" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"language": "en",
"shelves": [
{
"id": 51003505,
"name": "New Release",
"books": [
{
"id": "6ab397e13282a14d03058cf7",
"title": "The Alpha's Forbidden Bunny",
"description": "In the beastkin world, Toby (a rabbit whose impending marriage was called off) is forced into an arranged marr…",
"cover_url": "https://v-img.crazymaplestudios.com/v-images/book_cover_batch/204200150000007655/56a1edb3-66b9-43f6-8ef4-8e005…",
"url": "https://www.reelshort.com/movie/the-alpha-s-forbidden-bunny-6ab397e13282a14d03058cf7",
"episodes": 38,
"tags": [
"Playing Dumb"
],
"plays": 1921782,
"favorites": 27334,
"first_paid_episode": 11,
"has_trailer": true,
"language": "en"
},
{
"id": "6a9a2a1759516005be053227",
"title": "Spoiled by Four Sea Monster Husbands",
"description": "Alice is swept into the undersea world of Atlantis and becomes the mute, wicked supporting character everyone…",
"cover_url": "https://v-img.crazymaplestudios.com/v-images/book_cover_batch/204200150000006008/bd72681c-aa81-497d-80d5-687cd…",
"url": "https://www.reelshort.com/movie/spoiled-by-four-sea-monster-husbands-6a9a2a1759516005be053227",
"episodes": 42,
"tags": [
"Playing Dumb"
],
"plays": 1425166,
"favorites": 22849,
"first_paid_episode": 13,
"has_trailer": true,
"language": "en"
}
]
},
{
"id": 51003506,
"name": "TOP",
"books": [
{
"id": "6a3d980baaf954b86307ecc4",
"title": "Rise of the Caged King",
"description": "Once a business elite, Silas is framed for murder by his rival Chase and his own wife Marina. Sentenced to 60…",
"cover_url": "https://v-img.crazymaplestudios.com/v-images/book_cover_batch/200000000000005418/5507e9c1-44cd-4b4f-984f-afa8a…",
"url": "https://www.reelshort.com/movie/rise-of-the-caged-king-6a3d980baaf954b86307ecc4",
"episodes": 64,
"tags": [
"Playing Dumb"
],
"plays": 41862670,
"favorites": 321965,
"first_paid_episode": 13,
"has_trailer": true,
"language": "en"
},
{
"id": "67f6d31af51c3a3b9e0549f2",
"title": "Undercover Prison King",
"description": "When ex-soldier Troy Poe inherits a corrupt private prison, he decides to go in undercover as an inmate to exp…",
"cover_url": "https://v-img.crazymaplestudios.com/v-images/book_cover_batch/200000000000000213/5abcdb27-ef1b-4f35-92e0-03b3c…",
"url": "https://www.reelshort.com/movie/undercover-prison-king-67f6d31af51c3a3b9e0549f2",
"episodes": 80,
"tags": [
"Hidden Identity"
],
"plays": 240006828,
"favorites": 1674993,
"first_paid_episode": 10,
"has_trailer": true,
"language": "en"
}
]
}
]
}
}Request schema
No body schema
Response schema
#/definitions/reelshort.homeResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | reelshort.HomeResponse | No | ||||
| data.language | string | No | ||||
| data.shelves | array | No | ||||
| data.shelves[].books | array | No | Book record, 12 fields: cover_url, description, episodes, favorites, first_paid_episode, has_trailer, id, language, plays, tags, title, url. Described under Get a whole ReelShort shelf API. | |||
| data.shelves[].id | integer | No | ||||
| data.shelves[].name | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/reelshort/home?language=en" \
-H "x-api-key: $CRAWLORA_API_KEY"