Pricing
Pay per event
Wattpad Story Metadata Scraper
Scrape Wattpad story metadata — title, author, tags, read/vote counts, cover, language, and completion status — from the public JSON API. Supports genre category and sort (hot, new, votes, reads) traversal for analytics, IP scouting, and trend research. Metadata only — never fetches chapter bodies.
Pricing
Pay per event
Rating
0.0
(0)
Developer
Actor stats
0
Bookmarked
3
Total users
2
Monthly active users
a month ago
Last modified
Categories
Share
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:
Most-read Romance stories (all-time):
Global trending stories across all genres:
Most-voted Fanfiction:
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
readsandvotessort modes surface all-time leaders.hotandnewtrack current activity. read_countis 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.
