Endpoint Playground
Searches Wattpad's story catalog by text or browses it by ranking, category and language, and returns one page of stories: id, title, description, cover, link, author, votes, reads, comments, chapter count, completed and mature flags, language, category ids, tags and dates. Give at least one of query, filter, category or language. filter is hot, new or featured; category is an id from wattpad-categories; language is an id from wattpad-languages. limit is 1 to 100 (default 20) and offset pages the results: a text search reaches offset 9999, while browsing without a query is capped at 1500 results. Browse pages can hold fewer stories than limit (or none) because Wattpad filters after paging, so advance with next_offset rather than the item count.
curl 'https://api.crawlora.net/api/v1/wattpad/search?filter=hot&language=1' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| query | string | No | Text to search for in story titles, descriptions and tags, up to 200 characters | |
| filter | string | No | hot | Ranking: hot is currently popular, new is recently published, featured is Wattpad's featured stories |
| category | integer | No | Category id from wattpad-categories, for example 4 for Romance | |
| language | integer | No | 1 | Story language id from wattpad-languages, for example 1 for English |
| limit | integer | No | Page size, 1 to 100; defaults to 20 | |
| offset | integer | No | Zero-based result offset; below 10000 with query, below 1500 without |
{
"code": 200,
"msg": "OK",
"data": {
"stories": [
{
"id": "295638501",
"title": "Bromance turned Romance",
"url": "https://www.wattpad.com/story/295638501-bromance-turned-romance",
"description": "Bryce and Lance were best friends. But Bryce always had a crush on Lance. Bryce would always get jealous when…",
"cover": "https://img.wattpad.com/cover/295638501-256-k193979.jpg",
"author": {
"username": "Ruth_Margret",
"name": "Your_mom69",
"avatar": "https://img.wattpad.com/useravatar/Ruth_Margret.128.946086.jpg",
"verified": false
},
"votes": 1830,
"reads": 151218,
"comments": 448,
"parts": 15,
"completed": true,
"mature": false,
"language": {
"id": 1,
"name": "English"
},
"category_ids": [
4
],
"tags": [
"boyxboy",
"bromance"
],
"created_at": "2021-12-22T23:24:43Z",
"modified_at": "2026-10-07T23:19:53Z"
},
{
"id": "372197791",
"title": "ᴛʜᴇ ᴄᴏʟʟᴇɢᴇ ʀᴏᴍᴀɴᴄᴇ [ᴄᴏᴍᴘʟᴇᴛᴇᴅ]",
"url": "https://www.wattpad.com/story/372197791-%E1%B4%9B%CA%9C%E1%B4%87-%E1%B4%84%E1%B4%8F%CA%9F%CA%9F%E1%B4%87%C9%A2…",
"description": "Nikita Joshi:\nA 20 year old 3rd year CS student studying at University of Bournbrooke, India. She's transferre…",
"cover": "https://img.wattpad.com/cover/372197791-256-k79464.jpg",
"author": {
"username": "thewanderingquill_",
"name": "thewanderingquill_",
"avatar": "https://img.wattpad.com/useravatar/thewanderingquill_.128.914396.jpg",
"verified": false
},
"votes": 86803,
"reads": 1957201,
"comments": 2290,
"parts": 70,
"completed": true,
"mature": false,
"language": {
"id": 1,
"name": "English"
},
"category_ids": [
4
],
"tags": [
"college",
"collegeromance"
],
"created_at": "2024-07-02T07:28:12Z",
"modified_at": "2026-10-08T11:35:05Z"
}
],
"total": 2399524,
"limit": 2,
"offset": 0,
"next_offset": 2
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.