# Wattpad API
> Live data from Wattpad, the world's largest storytelling social platform where writers publish serialized fiction and millions of readers follow, vote and comment, served straight from Wattpad's public API — no key, nothing cached. The search endpoint finds stories by keyword, each with its read, vote and comment counts, part count, completion and maturity flags, tags and author — a popular dragon-romance pulls hundreds of thousands of reads. The story endpoint returns one story in full: its description, cover, the engagement counts, the number of parts, language, tags and the author with their follower count. The user endpoint returns a writer's profile: their follower and following counts, the number of stories they have published, their bio and location — Wattpad's own account has tens of millions of followers. The user-stories endpoint returns a writer's published stories with each one's stats. Everything is live from Wattpad, nothing stored. This is the web-fiction social layer for any reading, discovery, writing-community or recommendation app. Distinct from mainstream social and the book-catalog APIs — this is Wattpad's stories, their engagement and their authors. 4 endpoints, no key on our side.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/wattpad-api/..."
```

## Pricing
- **Free** (Free) — 5,000 calls/Mo, 3 req/s
- **Starter** ($8/Mo) — 70,000 calls/Mo, 8 req/s
- **Pro** ($19/Mo) — 350,000 calls/Mo, 20 req/s
- **Mega** ($44/Mo) — 1,700,000 calls/Mo, 50 req/s

## Endpoints

### Wattpad

#### `GET /v1/search` — Search stories by keyword

**Parameters:**
- `q` (query, required, string) — Search query Example: `dragon`
- `limit` (query, optional, string) — Max stories (1-50) Example: `10`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/wattpad-api/v1/search?q=dragon&limit=10"
```

**Response:**
```json
{
    "data": {
        "count": 10,
        "query": "dragon",
        "total": 226753,
        "source": "Wattpad",
        "stories": [
            {
                "id": "26327373",
                "url": "https://www.wattpad.com/story/26327373",
                "tags": [
                    "betrayal",
                    "complete",
                    "danger",
                    "dragon",
                    "fantasy",
                    "fiancee",
                    "forbiddenlove",
                    "kidnap",
                    "kidnapped",
                    "kingdom",
                    "love",
                    "prince",
                    "princess",
                    "romance",
                    "shifter",
                    "texttospeech"
                ],
                "cover": "https://img.wattpad.com/cover/26327373-256-k228682.jpg",
                "parts": 34,
                "reads": 614366,
                "title": "The Dragon and the Princess",
                "votes": 18709,
                "author": {
                    "name": "Dragon",
                    "username": "Dragon__Wolf",
                    "followers": 679
                },
                "mature": false,
                "comments": 2381,
                "language": "English",
                "completed": true,
                "created_at": "2014-11-10T14:25:53Z",
                "description": "You all know the old fairy-tale's where an evil and cruel dragon kidn
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/story` — One story in full

**Parameters:**
- `id` (query, required, string) — Story id Example: `26327373`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/wattpad-api/v1/story?id=26327373"
```

**Response:**
```json
{
    "data": {
        "id": "26327373",
        "url": "https://www.wattpad.com/story/26327373",
        "tags": [
            "betrayal",
            "complete",
            "danger",
            "dragon",
            "fantasy",
            "fiancee",
            "forbiddenlove",
            "kidnap",
            "kidnapped",
            "kingdom",
            "love",
            "prince",
            "princess",
            "romance",
            "shifter",
            "texttospeech"
        ],
        "cover": "https://img.wattpad.com/cover/26327373-256-k228682.jpg",
        "parts": 34,
        "reads": 614366,
        "title": "The Dragon and the Princess",
        "votes": 18709,
        "author": {
            "name": "Dragon",
            "username": "Dragon__Wolf",
            "followers": 679
        },
        "mature": false,
        "source": "Wattpad",
        "comments": 2381,
        "language": "English",
        "completed": true,
        "created_at": "2014-11-10T14:25:53Z",
        "description": "You all know the old fairy-tale's where an evil and cruel dragon kidnaps the princess because of her beauty and then knights in shinning armour arrives to save her. After saving her they get the half of the kingdom and marry the princess and lives happily ever after.. But this story is very different... There was once were a beautiful, kind princess named Lydia who got engaged to a prince, but the princess wasn't in love with him at all. One day as she was slee
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/user` — A writer's profile

**Parameters:**
- `username` (query, required, string) — Wattpad username Example: `Wattpad`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/wattpad-api/v1/user?username=Wattpad"
```

**Response:**
```json
{
    "data": {
        "url": "https://www.wattpad.com/user/Wattpad",
        "name": "Wattpad",
        "avatar": "https://img.wattpad.com/useravatar/Wattpad.128.838617.jpg",
        "source": "Wattpad",
        "location": "Wattpad HQ",
        "username": "Wattpad",
        "followers": 79464806,
        "following": 82,
        "created_at": "2006-11-05T20:37:42Z",
        "description": "Welcome to the Wattpad profile 🧡 AKA your go-to spot for what's happening across a millions-strong global community of readers and writers. From totally free stories to compelling Wattpad Originals... basically, if it's trending on Wattpad, you'll find it here first. Follow us for News & Updates, Community Happenings, and Wattpad Group Chat. Here, we highlight the stories everyone's talking about, the creators behind them, and the fandoms that make it all feel bigger. Everything we share here l",
        "reading_lists": 99,
        "stories_published": 4
    },
    "meta": {
        "timestamp": "2026-06-09T11:38:13.564Z",
        "request_id": "7acd0084-6fdb-4e44-a6b4-7972e830e17c"
    },
    "status": "ok",
    "message": "User retrieved successfully",
    "success": true
}
```

#### `GET /v1/user_stories` — A writer's published stories

**Parameters:**
- `username` (query, required, string) — Wattpad username Example: `Wattpad`
- `limit` (query, optional, string) — Max stories (1-50) Example: `10`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/wattpad-api/v1/user_stories?username=Wattpad&limit=10"
```

**Response:**
```json
{
    "data": {
        "count": 4,
        "source": "Wattpad",
        "stories": [
            {
                "id": "408682906",
                "url": "https://www.wattpad.com/story/408682906",
                "tags": [
                    "contest",
                    "giveaway",
                    "prizes",
                    "sweepstake",
                    "thingsbook",
                    "wattpad"
                ],
                "cover": "https://img.wattpad.com/cover/408682906-256-k481818.jpg",
                "parts": 10,
                "reads": 218359,
                "title": "Official ThingsBook x Wattpad Sweepstake",
                "votes": 1782,
                "author": {
                    "name": "Wattpad",
                    "username": "Wattpad",
                    "followers": 79464806
                },
                "mature": false,
                "comments": 2661,
                "language": "English",
                "completed": false,
                "created_at": "2026-03-06T22:18:32Z",
                "description": "Calling all readers, writers and story lovers! Get ready for the largest Sweepstakes to ever take place on Wattpad. To celebrate the launch of our sister app, ThingsBook, we're inviting the Wattpad community to participate in the ultimate Dream Getaway Sweepstakes - with 30,000 Coins up for grabs every week, and over 900 winners across the community. Excited? Keep reading to learn more and find out how to enter.",

…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Spec

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/wattpad-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "source": "Wattpad public API v3 (live)",
        "service": "wattpad-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/user": "A writer's profile (username=Wattpad).",
            "GET /v1/story": "One story in full (id=26327373).",
            "GET /v1/search": "Search stories by keyword (q=dragon, limit).",
            "GET /v1/user_stories": "A writer's published stories (username=Wattpad, limit)."
        },
        "description": "Live data from Wattpad, the world's largest storytelling social platform: search stories by keyword with read, vote and comment counts, part count, completion/maturity flags, tags and author; one story in full (description, cover, engagement, parts, language, tags, author with followers); a writer's profile (followers, following, stories published, bio, location); and a writer's published stories with stats. Live, no key, nothing stored. Distinct from mainstream social and book-catalog APIs — this is Wattpad's stories, their engagement and their authors.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-09T11:38:14.255Z",
        "request_id": "00e2c98f-cb2e-45ff-84eb-49265d819a35"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/wattpad-api
OpenAPI spec: https://www.oanor.com/api/wattpad-api/openapi.json