ReelShort API endpoint
Returns one ReelShort short drama: title, description, cover, link, language, episode count, plays, favorites, badge, dubbed and AI-generated flags, release times, tags with their kind (genre, style, mood, trope and more), cast with IMDb links, and the full episode list with each episode's id, number, link, likes, release time and whether it is free. Only public catalog metadata is read; no playable video is returned.
/reelshort/movieid is required: the 24-character title id from reelshort-home, reelshort-shelf or reelshort-search. A reelshort.com movie or episode URL is also accepted.
Notable response behavior:
episodes lists the trailer (kind trailer, number 0, when the title has one) and every numbered episode. episode_count counts the numbered episodes only, matching the episodes count in the list endpoints.free is true for the trailer and the episodes before first_paid_episode; later episodes are paid on ReelShort.tags[].kind is derived from ReelShort's numeric category and is one of audience, actor, actress, genre, theme, style, mood, story_region, story_time, rating, identity, trope, setting, story_beat or other; category_id is the raw id.update_status is ReelShort's raw flag and is not interpreted.404; a malformed id returns 400.Example response (long values and lists shortened):
{
"code": 200,
"msg": "OK",
"data": {
"id": "6a8752ac7c23cb02b40f062b",
"title": "Just One Kiss",
"description": "Just One Kiss is based on the first installment of Emily Jean’s Wattpad novel series. Farrah Blake is a senior…",
"cover_url": "https://v-img.crazymaplestudios.com/v-images/book_cover_batch/200000000000003580/7b267f8c-ec32-4554-8248-9a53a…",
"url": "https://www.reelshort.com/movie/just-one-kiss-6a8752ac7c23cb02b40f062b",
"language": "en",
"episode_count": 72,
"first_paid_episode": 12,
"plays": 36269640,
"favorites": 252382,
"badge": "Hot",
"dubbed": false,
"ai_generated": false,
"update_status": 1,
"imdb_url": "https://www.imdb.com/title/tt47608596/",
"published_at": "2026-09-16T17:18:03Z",
"online_at": "2026-09-27T07:19:19Z",
"tags": [
{
"id": "676d210b4582b53a140818c0",
"category_id": "1005",
"kind": "actress",
"name": "Cailin Peluso"
},
{
"id": "69f276a8193c3f9aca089884",
"category_id": "1001",
"kind": "actor",
"name": "Noah Andre"
},
{
"id": "692dea9de026402bb106606a",
"category_id": "1001",
"kind": "actor",
"name": "Andrew Tong"
}
],
"actors": [
{
"name": "Andrew Tong",
"photo_url": "https://v-mps.crazymaplestudios.com/images/374448b0-daf5-11f0-84ad-6b5693b490dc.jpg",
"imdb_url": "https://www.imdb.com/name/nm13632523/"
},
{
"name": "Noah Andre",
"photo_url": "https://v-mps.crazymaplestudios.com/images/bec00380-48a3-11f1-acb2-c14bef828c82.jpg",
"imdb_url": "https://www.imdb.com/name/nm15813938/?ref_=nv_sr_srsg_0_tt_0_nm_8_in_0_q_%20Noah%20Andre"
}
],
"episodes": [
{
"number": 0,
"id": "oxdgch24ec",
"kind": "trailer",
"url": "https://www.reelshort.com/episodes/episode-0-just-one-kiss-6a8752ac7c23cb02b40f062b-oxdgch24ec",
"likes": 6558,
"published_at": "2026-09-27T07:20:04Z",
"free": true,
"thumbnail_url": "https://v-mps.crazymaplestudios.com/Snapshots/9967e5b21f98485d.jpg"
},
{
"number": 1,
"id": "md4uq8gmvu",
"kind": "episode",
"url": "https://www.reelshort.com/episodes/episode-1-just-one-kiss-6a8752ac7c23cb02b40f062b-md4uq8gmvu",
"likes": 16931,
"published_at": "2026-09-27T07:20:06Z",
"free": true,
"thumbnail_url": "https://v-mps.crazymaplestudios.com/Snapshots/89d1efd77c24f84d.jpg"
},
{
"number": 2,
"id": "gs4kx8ruqo",
"kind": "episode",
"url": "https://www.reelshort.com/episodes/episode-2-just-one-kiss-6a8752ac7c23cb02b40f062b-gs4kx8ruqo",
"likes": 7859,
"published_at": "2026-09-27T07:20:06Z",
"free": true,
"thumbnail_url": "https://v-mps.crazymaplestudios.com/Snapshots/79ca0d5e26623969.jpg"
}
]
}
}
| Field | Filled in, of 73 checked | Values in the sample |
|---|---|---|
| number | 73 | 0 to 72, median 36 |
| id | 73 | |
| kind | 73 | episode (72), trailer (1) |
| url | 73 | reelshort.com |
| likes | 73 | 3,438 to 17,054, median 4,934 |
| published_at | 73 | 2026-09-27 |
| free | 73 | true in 12 of 73 |
| thumbnail_url | 73 | v-mps.crazymaplestudios.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id | string | Yes | Title id (24 hex characters) from reelshort-home, reelshort-shelf or reelshort-search, or a reelshort.com movie or episode URL | 6a8752ac7c23cb02b40f062b | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/reelshort/movie?id=6a8752ac7c23cb02b40f062b" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"id": "6a8752ac7c23cb02b40f062b",
"title": "Just One Kiss",
"description": "Just One Kiss is based on the first installment of Emily Jean’s Wattpad novel series. Farrah Blake is a senior…",
"cover_url": "https://v-img.crazymaplestudios.com/v-images/book_cover_batch/200000000000003580/7b267f8c-ec32-4554-8248-9a53a…",
"url": "https://www.reelshort.com/movie/just-one-kiss-6a8752ac7c23cb02b40f062b",
"language": "en",
"episode_count": 72,
"first_paid_episode": 12,
"plays": 36269640,
"favorites": 252382,
"badge": "Hot",
"dubbed": false,
"ai_generated": false,
"update_status": 1,
"imdb_url": "https://www.imdb.com/title/tt47608596/",
"published_at": "2026-09-16T17:18:03Z",
"online_at": "2026-09-27T07:19:19Z",
"tags": [
{
"id": "676d210b4582b53a140818c0",
"category_id": "1005",
"kind": "actress",
"name": "Cailin Peluso"
},
{
"id": "69f276a8193c3f9aca089884",
"category_id": "1001",
"kind": "actor",
"name": "Noah Andre"
},
{
"id": "692dea9de026402bb106606a",
"category_id": "1001",
"kind": "actor",
"name": "Andrew Tong"
}
],
"actors": [
{
"name": "Andrew Tong",
"photo_url": "https://v-mps.crazymaplestudios.com/images/374448b0-daf5-11f0-84ad-6b5693b490dc.jpg",
"imdb_url": "https://www.imdb.com/name/nm13632523/"
},
{
"name": "Noah Andre",
"photo_url": "https://v-mps.crazymaplestudios.com/images/bec00380-48a3-11f1-acb2-c14bef828c82.jpg",
"imdb_url": "https://www.imdb.com/name/nm15813938/?ref_=nv_sr_srsg_0_tt_0_nm_8_in_0_q_%20Noah%20Andre"
}
],
"episodes": [
{
"number": 0,
"id": "oxdgch24ec",
"kind": "trailer",
"url": "https://www.reelshort.com/episodes/episode-0-just-one-kiss-6a8752ac7c23cb02b40f062b-oxdgch24ec",
"likes": 6558,
"published_at": "2026-09-27T07:20:04Z",
"free": true,
"thumbnail_url": "https://v-mps.crazymaplestudios.com/Snapshots/9967e5b21f98485d.jpg"
},
{
"number": 1,
"id": "md4uq8gmvu",
"kind": "episode",
"url": "https://www.reelshort.com/episodes/episode-1-just-one-kiss-6a8752ac7c23cb02b40f062b-md4uq8gmvu",
"likes": 16931,
"published_at": "2026-09-27T07:20:06Z",
"free": true,
"thumbnail_url": "https://v-mps.crazymaplestudios.com/Snapshots/89d1efd77c24f84d.jpg"
},
{
"number": 2,
"id": "gs4kx8ruqo",
"kind": "episode",
"url": "https://www.reelshort.com/episodes/episode-2-just-one-kiss-6a8752ac7c23cb02b40f062b-gs4kx8ruqo",
"likes": 7859,
"published_at": "2026-09-27T07:20:06Z",
"free": true,
"thumbnail_url": "https://v-mps.crazymaplestudios.com/Snapshots/79ca0d5e26623969.jpg"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/reelshort.movieResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | reelshort.MovieResponse | No | ||||
| data.actors | array | No | ||||
| data.actors[].imdb_url | string | No | ||||
| data.actors[].name | string | No | ||||
| data.actors[].photo_url | string | No | ||||
| data.ai_generated | boolean | No | ||||
| data.badge | string | No | ||||
| data.cover_url | string | No | ||||
| data.description | string | No | ||||
| data.dubbed | boolean | No | ||||
| data.episode_count | integer | No | EpisodeCount counts the numbered episodes; the trailer is not included (ReelShort's own total on its movie page does include it). | |||
| data.episodes | array | No | ||||
| data.episodes[].free | boolean | No | ||||
| data.episodes[].id | string | No | ||||
| data.episodes[].kind | string | No | episode or trailer | |||
| data.episodes[].likes | integer | No | ||||
| data.episodes[].number | integer | No | Number is the episode number; 0 is the trailer. | |||
| data.episodes[].published_at | string | No | ||||
| data.episodes[].thumbnail_url | string | No | ||||
| data.episodes[].url | string | No | ||||
| data.favorites | integer | No | ||||
| data.first_paid_episode | integer | No | ||||
| data.id | string | No | ||||
| data.imdb_url | string | No | ||||
| data.language | string | No | ||||
| data.online_at | string | No | ||||
| data.original_language | string | No | ||||
| data.plays | integer | No | ||||
| data.published_at | string | No | ||||
| data.tags | array | No | ||||
| data.tags[].category_id | string | No | ||||
| data.tags[].id | string | No | ||||
| data.tags[].kind | string | No | ||||
| data.tags[].name | string | No | ||||
| data.title | string | No | ||||
| data.update_status | integer | No | UpdateStatus is ReelShort's raw update_status flag (1 on every title sampled on 2026-10-26); it is not interpreted. | |||
| data.url | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/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/movie?id=6a8752ac7c23cb02b40f062b" \
-H "x-api-key: $CRAWLORA_API_KEY"