ReelShort API endpoint
Searches ReelShort (reelshort.com) short dramas by keyword and returns 12 titles per page: id, title, description, cover, link, episode count, tags, plays and favorites, with the page, page count and an approximate total. The search is fuzzy and the total varies between calls. Only public catalog metadata is read; no playable video is returned.
/reelshort/searchQuery parameters:
keywords (required): the title text to search for, at most 100 characters.page: optional page number, 1 to 200. Defaults to 1. Each page holds 12 titles.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. Results, titles and tags are translated.Notable response behavior:
total is approximate; ReelShort's count varies between calls for the same query. Use total_pages and an empty books list to detect the end.books list, not an error.id to reelshort-movie for its episode list.Example response (long values and lists shortened):
{
"code": 200,
"msg": "OK",
"data": {
"keywords": "billionaire",
"language": "en",
"page": 1,
"total_pages": 62,
"total": 740,
"books": [
{
"id": "6ab606a06909bea78b02a495",
"title": "Runaway Single Mom and Her Billionaire Hubby",
"description": "Single mom Grace escapes abuse and fights to protect her daughter, Lily. From factory struggles to elite schoo…",
"cover_url": "https://v-img.crazymaplestudios.com/v-images/book_cover_batch/204200150000008213/71bfae6c-814f-47e2-913c-e31ae…",
"url": "https://www.reelshort.com/movie/runaway-single-mom-and-her-billionaire-hubby-6ab606a06909bea78b02a495",
"episodes": 56,
"tags": [
"Divorce"
],
"plays": 26517777,
"favorites": 262587,
"first_paid_episode": 14,
"has_trailer": true,
"language": "en"
},
{
"id": "6a79753726d27eb2a90d4c34",
"title": "Billionaire's Contract Lover",
"description": "Charlotte, adopted daughter of the Harrington family, is drugged and framed by her stepsister Isabella at her…",
"cover_url": "https://v-img.crazymaplestudios.com/v-images/book_cover_batch/204200150000006086/e65c3831-7f55-4592-a94c-5094a…",
"url": "https://www.reelshort.com/movie/billionaire-s-contract-lover-6a79753726d27eb2a90d4c34",
"episodes": 64,
"tags": [
"Billionaire"
],
"plays": 5215720,
"favorites": 22617,
"first_paid_episode": 9,
"has_trailer": true,
"language": "en"
}
]
}
}
| Field | Filled in, of 12 checked | Values in the sample |
|---|---|---|
| id | 12 | |
| title | 12 | “Runaway Single Mom and Her Billionaire Hubby” and 11 other values |
| description | 12 | median 416 characters |
| cover_url | 12 | v-img.crazymaplestudios.com |
| url | 12 | reelshort.com |
| episodes | 12 | 43 to 80, median 61 |
| tags | 12 | median 1 entry |
| plays | 12 | 2,879,379 to 178,026,487, median 29,987,784 |
| favorites | 12 | 22,796 to 1,219,288, median 267,512 |
| first_paid_episode | 12 | 6 to 16, median 10 |
| has_trailer | 12 | true in 12 of 12 |
| language | 12 | en in all 12 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| keywords | string | Yes | Title text to search for, up to 100 characters | billionaire | |
| page | integer | No | 1 | Page number, 1 to 200; defaults to 1. Each page holds 12 titles | 2 |
| 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/search?keywords=billionaire&page=1&language=en" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"keywords": "billionaire",
"language": "en",
"page": 1,
"total_pages": 62,
"total": 740,
"books": [
{
"id": "6ab606a06909bea78b02a495",
"title": "Runaway Single Mom and Her Billionaire Hubby",
"description": "Single mom Grace escapes abuse and fights to protect her daughter, Lily. From factory struggles to elite schoo…",
"cover_url": "https://v-img.crazymaplestudios.com/v-images/book_cover_batch/204200150000008213/71bfae6c-814f-47e2-913c-e31ae…",
"url": "https://www.reelshort.com/movie/runaway-single-mom-and-her-billionaire-hubby-6ab606a06909bea78b02a495",
"episodes": 56,
"tags": [
"Divorce"
],
"plays": 26517777,
"favorites": 262587,
"first_paid_episode": 14,
"has_trailer": true,
"language": "en"
},
{
"id": "6a79753726d27eb2a90d4c34",
"title": "Billionaire's Contract Lover",
"description": "Charlotte, adopted daughter of the Harrington family, is drugged and framed by her stepsister Isabella at her…",
"cover_url": "https://v-img.crazymaplestudios.com/v-images/book_cover_batch/204200150000006086/e65c3831-7f55-4592-a94c-5094a…",
"url": "https://www.reelshort.com/movie/billionaire-s-contract-lover-6a79753726d27eb2a90d4c34",
"episodes": 64,
"tags": [
"Billionaire"
],
"plays": 5215720,
"favorites": 22617,
"first_paid_episode": 9,
"has_trailer": true,
"language": "en"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/reelshort.searchResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | reelshort.SearchResponse | No | ||||
| data.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.keywords | string | No | ||||
| data.language | string | No | ||||
| data.page | integer | No | ||||
| data.total | integer | No | Total is approximate: ReelShort's search backend reports a count that varies between calls for the same query. | |||
| data.total_pages | integer | 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/search?keywords=billionaire&page=1&language=en" \
-H "x-api-key: $CRAWLORA_API_KEY"