Docs menu

Wattpad API endpoint

List a Wattpad story's chapters API

Returns a Wattpad story's chapter list, in reading order: id, title, link, word count, reads, votes, comments, length, and created and modified dates for every chapter. The per-chapter reads show where readers drop off. Use it to see how a story is paced and which chapters readers react to. story_id is the numeric story id, or its wattpad.com link. Chapter text is never returned.

GETapiKey1 credit/requestWattpadwattpad.storyPartsResponseDoc/wattpad/story-parts

Endpoint facts

Method: GET
API path: /wattpad/story-parts
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: Wattpad
Response schema: #/definitions/wattpad.storyPartsResponseDoc

Wattpad Stories API Try List a Wattpad story's chapters API in Playground Wattpad API documentation

How this endpoint behaves

Notable response behavior:

Each part carries id, title, url, word_count, reads, votes, comments, length and its created and modified dates. reads per chapter gives a reader-retention curve across the story.
total is the story's chapter count as Wattpad reports it; draft chapters are never listed.
A story that does not exist returns 404; a malformed story_id returns 400.
Only chapter metadata is read. Chapter text is never returned.

Example response (long values and lists shortened):

{
  "code": 200,
  "msg": "OK",
  "data": {
    "story_id": "344352588",
    "title": "Lose You To Love Me (Mafia Romance-Complete)",
    "total": 82,
    "parts": [
      {
        "id": "1353317758",
        "title": "CHAPTER 0",
        "url": "https://www.wattpad.com/1353317758-lose-you-to-love-me-mafia-romance-complete-chapter",
        "word_count": 1923,
        "reads": 139834,
        "votes": 1558,
        "comments": 540,
        "length": 9613,
        "draft": false,
        "created_at": "2023-06-16T20:49:32Z",
        "modified_at": "2024-07-20T09:43:51Z"
      },
      {
        "id": "1353318446",
        "title": "CHAPTER 1",
        "url": "https://www.wattpad.com/1353318446-lose-you-to-love-me-mafia-romance-complete-chapter",
        "word_count": 1867,
        "reads": 68686,
        "votes": 1096,
        "comments": 148,
        "length": 9332,
        "draft": false,
        "created_at": "2023-06-16T20:50:37Z",
        "modified_at": "2023-06-18T12:40:20Z"
      },
      {
        "id": "1353318810",
        "title": "CHAPTER 2",
        "url": "https://www.wattpad.com/1353318810-lose-you-to-love-me-mafia-romance-complete-chapter",
        "word_count": 2671,
        "reads": 57036,
        "votes": 975,
        "comments": 162,
        "length": 13353,
        "draft": false,
        "created_at": "2023-06-16T20:53:47Z",
        "modified_at": "2023-06-16T20:53:47Z"
      }
    ]
  }
}

Request parameters

Parameter	Type	Required	Default	Description	Example
story_id	string	Yes		Numeric Wattpad story id, such as 344352588; a wattpad.com/story link is also accepted	344352588
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/wattpad/story-parts?story_id=344352588" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "story_id": "344352588",
    "title": "Lose You To Love Me (Mafia Romance-Complete)",
    "total": 82,
    "parts": [
      {
        "id": "1353317758",
        "title": "CHAPTER 0",
        "url": "https://www.wattpad.com/1353317758-lose-you-to-love-me-mafia-romance-complete-chapter",
        "word_count": 1923,
        "reads": 139834,
        "votes": 1558,
        "comments": 540,
        "length": 9613,
        "draft": false,
        "created_at": "2023-06-16T20:49:32Z",
        "modified_at": "2024-07-20T09:43:51Z"
      },
      {
        "id": "1353318446",
        "title": "CHAPTER 1",
        "url": "https://www.wattpad.com/1353318446-lose-you-to-love-me-mafia-romance-complete-chapter",
        "word_count": 1867,
        "reads": 68686,
        "votes": 1096,
        "comments": 148,
        "length": 9332,
        "draft": false,
        "created_at": "2023-06-16T20:50:37Z",
        "modified_at": "2023-06-18T12:40:20Z"
      },
      {
        "id": "1353318810",
        "title": "CHAPTER 2",
        "url": "https://www.wattpad.com/1353318810-lose-you-to-love-me-mafia-romance-complete-chapter",
        "word_count": 2671,
        "reads": 57036,
        "votes": 975,
        "comments": 162,
        "length": 13353,
        "draft": false,
        "created_at": "2023-06-16T20:53:47Z",
        "modified_at": "2023-06-16T20:53:47Z"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/wattpad.storyPartsResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	wattpad.StoryPartsResponse	No
data.parts	array	No
data.parts[].comments	integer	No
data.parts[].created_at	string	No
data.parts[].draft	boolean	No
data.parts[].id	string	No
data.parts[].length	integer	No
data.parts[].modified_at	string	No
data.parts[].reads	integer	No
data.parts[].title	string	No
data.parts[].url	string	No
data.parts[].votes	integer	No
data.parts[].word_count	integer	No
data.story_id	string	No
data.title	string	No
data.total	integer	No
msg	string	No	OK

Failure responses

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

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/wattpad/story-parts?story_id=344352588" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Wattpad endpoint docs Wattpad Stories API List Wattpad story categories API documentation List Wattpad story languages API documentation Wattpad Chapter Comments API documentation Get a Wattpad chapter API documentation Search Wattpad authors by name API documentation Search and browse Wattpad stories API documentation

Open in Playground Back to group

Docs menu

Wattpad API endpoint

List a Wattpad story's chapters API

GETapiKey1 credit/requestWattpadwattpad.storyPartsResponseDoc/wattpad/story-parts

Endpoint facts

Method: GET
API path: /wattpad/story-parts
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: Wattpad
Response schema: #/definitions/wattpad.storyPartsResponseDoc

Wattpad Stories API Try List a Wattpad story's chapters API in Playground Wattpad API documentation

How this endpoint behaves

Notable response behavior:

Each part carries id, title, url, word_count, reads, votes, comments, length and its created and modified dates. reads per chapter gives a reader-retention curve across the story.
total is the story's chapter count as Wattpad reports it; draft chapters are never listed.
A story that does not exist returns 404; a malformed story_id returns 400.
Only chapter metadata is read. Chapter text is never returned.

Example response (long values and lists shortened):

{
  "code": 200,
  "msg": "OK",
  "data": {
    "story_id": "344352588",
    "title": "Lose You To Love Me (Mafia Romance-Complete)",
    "total": 82,
    "parts": [
      {
        "id": "1353317758",
        "title": "CHAPTER 0",
        "url": "https://www.wattpad.com/1353317758-lose-you-to-love-me-mafia-romance-complete-chapter",
        "word_count": 1923,
        "reads": 139834,
        "votes": 1558,
        "comments": 540,
        "length": 9613,
        "draft": false,
        "created_at": "2023-06-16T20:49:32Z",
        "modified_at": "2024-07-20T09:43:51Z"
      },
      {
        "id": "1353318446",
        "title": "CHAPTER 1",
        "url": "https://www.wattpad.com/1353318446-lose-you-to-love-me-mafia-romance-complete-chapter",
        "word_count": 1867,
        "reads": 68686,
        "votes": 1096,
        "comments": 148,
        "length": 9332,
        "draft": false,
        "created_at": "2023-06-16T20:50:37Z",
        "modified_at": "2023-06-18T12:40:20Z"
      },
      {
        "id": "1353318810",
        "title": "CHAPTER 2",
        "url": "https://www.wattpad.com/1353318810-lose-you-to-love-me-mafia-romance-complete-chapter",
        "word_count": 2671,
        "reads": 57036,
        "votes": 975,
        "comments": 162,
        "length": 13353,
        "draft": false,
        "created_at": "2023-06-16T20:53:47Z",
        "modified_at": "2023-06-16T20:53:47Z"
      }
    ]
  }
}

Request parameters

Parameter	Type	Required	Default	Description	Example
story_id	string	Yes		Numeric Wattpad story id, such as 344352588; a wattpad.com/story link is also accepted	344352588
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/wattpad/story-parts?story_id=344352588" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "story_id": "344352588",
    "title": "Lose You To Love Me (Mafia Romance-Complete)",
    "total": 82,
    "parts": [
      {
        "id": "1353317758",
        "title": "CHAPTER 0",
        "url": "https://www.wattpad.com/1353317758-lose-you-to-love-me-mafia-romance-complete-chapter",
        "word_count": 1923,
        "reads": 139834,
        "votes": 1558,
        "comments": 540,
        "length": 9613,
        "draft": false,
        "created_at": "2023-06-16T20:49:32Z",
        "modified_at": "2024-07-20T09:43:51Z"
      },
      {
        "id": "1353318446",
        "title": "CHAPTER 1",
        "url": "https://www.wattpad.com/1353318446-lose-you-to-love-me-mafia-romance-complete-chapter",
        "word_count": 1867,
        "reads": 68686,
        "votes": 1096,
        "comments": 148,
        "length": 9332,
        "draft": false,
        "created_at": "2023-06-16T20:50:37Z",
        "modified_at": "2023-06-18T12:40:20Z"
      },
      {
        "id": "1353318810",
        "title": "CHAPTER 2",
        "url": "https://www.wattpad.com/1353318810-lose-you-to-love-me-mafia-romance-complete-chapter",
        "word_count": 2671,
        "reads": 57036,
        "votes": 975,
        "comments": 162,
        "length": 13353,
        "draft": false,
        "created_at": "2023-06-16T20:53:47Z",
        "modified_at": "2023-06-16T20:53:47Z"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/wattpad.storyPartsResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	wattpad.StoryPartsResponse	No
data.parts	array	No
data.parts[].comments	integer	No
data.parts[].created_at	string	No
data.parts[].draft	boolean	No
data.parts[].id	string	No
data.parts[].length	integer	No
data.parts[].modified_at	string	No
data.parts[].reads	integer	No
data.parts[].title	string	No
data.parts[].url	string	No
data.parts[].votes	integer	No
data.parts[].word_count	integer	No
data.story_id	string	No
data.title	string	No
data.total	integer	No
msg	string	No	OK

Failure responses

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

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/wattpad/story-parts?story_id=344352588" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

List a Wattpad story's chapters API

Endpoint facts

How this endpoint behaves

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

List a Wattpad story's chapters API

Endpoint facts

How this endpoint behaves

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related