Search and browse Wattpad stories API

Endpoint facts

Method

GET

API path

/wattpad/search

Auth

apiKey

Credits

1 credit/request

Charged on

Successful 2xx responses only

Platform

Wattpad

Response schema

#/definitions/wattpad.searchResponseDoc

How this endpoint behaves

Give at least one of query, filter, category or language; they combine.

Parameters:

• query: text to search for, up to 200 characters. A text search pages as far as offset 9999.
• filter: hot (currently popular), new (recently published) or featured (Wattpad's featured stories).
• category: a category id from wattpad-categories (for example 4 is Romance). An unknown id returns 400.
• language: a story language id: 1 (English), 2 (Français), 3 (Italiano), 4 (Deutsch), 5 (Español), 6 (Português), 7 (Русский), 8 (繁體中文), 9 (日本語), 10 (한국어), 11 (Other), 12 (简体中文), 13 (Nederlands), 14 (Polski), 15 (Română), 16 (العربية), 17 (עברית), 18 (Filipino), 19 (Tiếng Việt), 20 (Bahasa Indonesia), 21 (हिन्दी), 22 (Bahasa Melayu), 23 (Türkçe), 24 (Česky), 25 (മലയാളം), 26 (Svenska), 27 (Norsk), 28 (Magyar), 29 (Dansk), 30 (ελληνικά), 32 (ภาษาไทย), 33 (Íslenska), 34 (Suomi), 35 (Eesti), 36 (Latviešu), 37 (Lietuvių), 38 (Català), 39 (Босански), 40 (Српски), 41 (Hrvatski), 42 (Slovenščina), 43 (Български), 44 (Slovenčina), 46 (Українська), 47 (বাংলা), 48 (اُردُو‎), 49 (தமிழ்), 50 (Kiswahili), 51 (Afrikaans), 53 (ગુજરાતી). Any other id returns 400.
• limit: 1 to 100; defaults to 20.
• offset: zero-based result offset, from 0 to 9999 when query is set and from 0 to 1499 when it is not.

Notable response behavior:

• total is the number of matches Wattpad reports. Browsing without a text query reports at most 1500.
• A browse page (no query) can hold fewer than limit stories, or none, because Wattpad filters after paging. Keep going with next_offset; it is absent on the last page.
• category_ids omits the "no category" placeholder; names come from wattpad-categories.
• Only public story metadata is read. Chapter text is never returned.

Example response (long values and lists shortened):

{
  "code": 200,
  "msg": "OK",
  "data": {
    "stories": [
      {
        "id": "295638501",
        "title": "Bromance turned Romance",
        "url": "https://www.wattpad.com/story/295638501-bromance-turned-romance",
        "description": "Bryce and Lance were best friends. But Bryce always had a crush on Lance. Bryce would always get jealous when…",
        "cover": "https://img.wattpad.com/cover/295638501-256-k193979.jpg",
        "author": {
          "username": "Ruth_Margret",
          "name": "Your_mom69",
          "avatar": "https://img.wattpad.com/useravatar/Ruth_Margret.128.946086.jpg",
          "verified": false
        },
        "votes": 1830,
        "reads": 151218,
        "comments": 448,
        "parts": 15,
        "completed": true,
        "mature": false,
        "language": {
          "id": 1,
          "name": "English"
        },
        "category_ids": [
          4
        ],
        "tags": [
          "boyxboy",
          "bromance"
        ],
        "created_at": "2021-12-22T23:24:43Z",
        "modified_at": "2026-10-07T23:19:53Z"
      },
      {
        "id": "372197791",
        "title": "ᴛʜᴇ ᴄᴏʟʟᴇɢᴇ ʀᴏᴍᴀɴᴄᴇ [ᴄᴏᴍᴘʟᴇᴛᴇᴅ]",
        "url": "https://www.wattpad.com/story/372197791-%E1%B4%9B%CA%9C%E1%B4%87-%E1%B4%84%E1%B4%8F%CA%9F%CA%9F%E1%B4%87%C9%A2…",
        "description": "Nikita Joshi:\nA 20 year old 3rd year CS student studying at University of Bournbrooke, India. She's transferre…",
        "cover": "https://img.wattpad.com/cover/372197791-256-k79464.jpg",
        "author": {
          "username": "thewanderingquill_",
          "name": "thewanderingquill_",
          "avatar": "https://img.wattpad.com/useravatar/thewanderingquill_.128.914396.jpg",
          "verified": false
        },
        "votes": 86803,
        "reads": 1957201,
        "comments": 2290,
        "parts": 70,
        "completed": true,
        "mature": false,
        "language": {
          "id": 1,
          "name": "English"
        },
        "category_ids": [
          4
        ],
        "tags": [
          "college",
          "collegeromance"
        ],
        "created_at": "2024-07-02T07:28:12Z",
        "modified_at": "2026-10-08T11:35:05Z"
      }
    ],
    "total": 2399524,
    "limit": 2,
    "offset": 0,
    "next_offset": 2
  }
}

Shared guides

Related