Skip to content
oanor
Sign up free
Marketplace Pricing Features Sign in
GET /v1/search

Search stories by keyword

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/wattpad-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/wattpad-api/v1/search" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/wattpad-api/v1/search", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/wattpad-api/v1/search");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/wattpad-api/v1/search",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "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 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 sleeping peacefully in her bed with her window opened, a dragon named Lithon attacked the kingdom. In it's attack on the kingdom the dragon",
                "modified_at": "2020-07-10T15:17:49Z"
            },
            {
                "id": "169289668",
                "url": "https://www.wattpad.com/story/169289668",
                "tags": [
                    "acnologia",
                    "dragonslayers",
                    "erik",
                    "fairy-tail",
                    "fairytail",
                    "family",
                    "fanfiction",
                    "gajeel",
                    "laxus",
                    "natsu",
                    "papalogia",
                    "rogue",
                    "serena",
                    "sting",
                    "texttospeech",
                    "wendy"
                ],
                "cover": "https://img.wattpad.com/cover/169289668-256-k764881.jpg",
                "parts": 104,
                "reads": 388463,
                "title": "The Dragon Father",
                "votes": 10061,
          
…