OrbTop

Wattpad Story Metadata Scraper

SOCIAL MEDIAFOR CREATORS
Try on Apify

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.
Try on Apify