Endpoint Playground
Returns one page of the stories a Wattpad author has published, with the same fields as wattpad-search: id, title, description, cover, link, votes, reads, comments, chapter count, completed and mature flags, language, category ids, tags and dates. username is the name from the author's wattpad.com/user/ link. limit is 1 to 100 (default 20) and offset pages the list; next_offset is absent on the last page. Authors with a private profile or who have opted out of crawling are not returned. This call reads the author's access settings first, so it costs two requests.
curl 'https://api.crawlora.net/api/v1/wattpad/user-stories?username=notjustarandomgirl' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| username | string | Yes | notjustarandomgirl | Wattpad username from wattpad.com/user/{username}; a profile link or @name is also accepted |
| limit | integer | No | Page size, 1 to 100; defaults to 20 | |
| offset | integer | No | Zero-based result offset; defaults to 0 |
{
"code": 200,
"msg": "OK",
"data": {
"username": "notjustarandomgirl",
"stories": [
{
"id": "411906274",
"title": "HOW TO: Get Out Of Friendzone",
"url": "https://www.wattpad.com/story/411906274-how-to-get-out-of-friendzone",
"description": "When Kate discovers her best friend, Justin, is falling for the this girl, Emily, panic sets in. Desperate to…",
"cover": "https://img.wattpad.com/cover/411906274-256-k108988.jpg",
"author": {
"username": "notjustarandomgirl",
"name": "Shorty ❤",
"avatar": "https://img.wattpad.com/useravatar/notjustarandomgirl.128.763251.jpg",
"verified": true
},
"votes": 96,
"reads": 2032,
"comments": 24,
"parts": 9,
"completed": false,
"mature": false,
"language": {
"id": 1,
"name": "English"
},
"category_ids": [
4
],
"tags": [
"basketballplayer",
"bestfriends"
],
"created_at": "2026-05-29T16:00:07Z",
"modified_at": "2026-10-23T21:36:29Z"
},
{
"id": "395667114",
"title": "Heartless",
"url": "https://www.wattpad.com/story/395667114-heartless",
"description": "Reading LOSE YOU TO LOVE ME is highly recommended, but can stand alone.\n\n\"I hope you will fall in love, so dam…",
"cover": "https://img.wattpad.com/cover/395667114-256-k212991.jpg",
"author": {
"username": "notjustarandomgirl",
"name": "Shorty ❤",
"avatar": "https://img.wattpad.com/useravatar/notjustarandomgirl.128.763251.jpg",
"verified": true
},
"votes": 113,
"reads": 6160,
"comments": 25,
"parts": 5,
"completed": false,
"mature": false,
"language": {
"id": 1,
"name": "English"
},
"category_ids": [
4
],
"tags": [
"adultromance",
"adultthemes"
],
"created_at": "2025-06-06T19:29:33Z",
"modified_at": "2025-06-28T15:59:35Z"
}
],
"total": 9,
"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.