Wattpad Story Metadata Scraper

Scrape story metadata from Wattpad using the public /api/v3/stories JSON API — no authentication required. Returns title, author, tags, read/vote/part counts, cover image, language, completion status, and more. Supports genre category filtering and multiple sort modes for trend research, IP scouting, and web-fiction analytics.

Metadata only — chapter bodies are never fetched. This actor strictly collects listing-level story metadata, keeping it well within the bounds of public data and Wattpad's publicly accessible information.

What it scrapes

• Story title, author username, and description/blurb
• Tags (comma-separated string)
• Read count, vote count, and part/chapter count
• Cover image URL
• Language name (e.g. English, Spanish)
• Mature content flag and completion status
• ISO 8601 datetime of the last published part
• Canonical story URL

Output fields

Field	Type	Description
story_id	string	Unique Wattpad story identifier
title	string	Story title
author_username	string	Wattpad username of the author
description	string	Story blurb/description
tags	string	Tags as a comma-separated string
read_count	number	Total read count
vote_count	number	Total vote count
part_count	number	Number of chapters/parts
cover_url	string	URL of the story cover image
language	string	Story language name
mature	boolean	Whether the story is marked mature
completed	boolean	Whether the story is completed
last_published	string	ISO 8601 datetime of the last published part
story_url	string	Full canonical Wattpad story URL

Input

Parameter	Type	Default	Description
mainCategory	string	—	Genre filter. One of: Romance, Fantasy, Science Fiction, Horror, Mystery / Thriller, Teen Fiction, Short Story, Humor, Non-Fiction, Fanfiction, Adventure, Spiritual, Poetry, Random. Leave empty to browse all categories.
sortBy	string	hot	Sort order: hot (trending), new (recently updated), votes (most voted), reads (most read)
maxItems	integer	50	Maximum number of stories to return. The API returns up to 1500 results per category/sort combination.

Usage examples

Top 100 trending Fantasy stories:

{
  "mainCategory": "Fantasy",
  "sortBy": "hot",
  "maxItems": 100
}

Most-read Romance stories (all-time):

{
  "mainCategory": "Romance",
  "sortBy": "reads",
  "maxItems": 500
}

Global trending stories across all genres:

{
  "sortBy": "hot",
  "maxItems": 200
}

Most-voted Fanfiction:

{
  "mainCategory": "Fanfiction",
  "sortBy": "votes",
  "maxItems": 300
}

Notes

• Each category/sort combination returns at most 1500 results from the Wattpad API. To cover broader datasets, run multiple queries with different category and sort combinations.
• The reads and votes sort modes surface all-time leaders. hot and new track current activity.
• read_count is the total lifetime read count, not a recent-period metric.
• Tags are returned as a single comma-separated string for compatibility with spreadsheet and CSV workflows.