{"openapi":"3.1.0","info":{"title":"Wattpad API","version":"1.0.0","description":"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.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/wattpad-api","description":"oanor gateway"}],"tags":[{"name":"Wattpad"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Wattpad"],"summary":"Search stories by keyword","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Search query","schema":{"type":"string"},"example":"dragon"},{"name":"limit","in":"query","required":false,"description":"Max stories (1-50)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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,"author":{"username":"The-Dragon-Hearted","followers":752},"mature":false,"comments":7747,"language":"English","completed":true,"created_at":"2018-12-02T23:29:30Z","description":"Dragon of the apocalypse, black dragon, master of death, dragon king; Acnologia has been called many things through his life but he's certain that now he can rest in death, however a certain blonde haired celestial wizard from the past has something else in mind. Instead of death, Acnologia is thrown into a crazed task of protecting the world he once swore to destroy and raise the very people he attempted to murder. Will he be able to stay sane, can he manage the many trials that lay ahead of him, and when he faces the most devastating enemy that earthland has ever seen, will he be able to pro","modified_at":"2026-05-14T22:27:46Z"},{"id":"68515672","url":"https://www.wattpad.com/story/68515672","tags":["dragon","griffen","texttospeech","unicorn"],"cover":"https://img.wattpad.com/cover/68515672-256-k795544.jpg","parts":15,"reads":108978,"title":"Dragon Born","votes":3511,"author":{"name":"Katt Marie","username":"Dragon_Katt","followers":305},"mature":false,"comments":798,"language":"English","completed":true,"created_at":"2016-04-09T19:56:22Z","description":"Emily always thought she was normal, just like everyone else. She finds out that she was kidnapped from the king and queen of dragons. What will happen when her dragon form revels it self? And who is that mysterious woman who keeps popping up? Hit the read button people, it's a good book. ( I'm editing currently.)","modified_at":"2017-04-23T23:51:01Z"},{"id":"163042991","url":"https://www.wattpad.com/story/163042991","tags":["action","android17","android18","anime","beerus","dbs","dbz","dragonball","dragonballsuper","dragonballz","fanfiction","gohan","goku","gokublack","jiren","ocstory","saiyan","shenron","texttospeech","vegeta","whis"],"cover":"https://img.wattpad.com/cover/163042991-256-k901046.jpg","parts":137,"reads":427991,"title":"Dragonball Mae","votes":9000,"author":{"name":"Dragonball Mae","username":"kadenzajinx","followers":1019},"mature":false,"comments":2673,"language":"English","completed":true,"created_at":"2018-09-29T02:47:20Z","description":"*Completed* Mae is the daughter of Goku and twin to Gohan. All her life she has worked hard to keep up with her father. Spending a large amount of time training with Vegeta she hopes to reach a skill where she can surpass Goku. Cover art by RangelArtistry (Begins after Frieza arc in dbs) *I do not own dragon ball, dragon ball z, or dragon ball super* (contains adult language)","modified_at":"2023-09-23T18:56:38Z"},{"id":"178312504","url":"https://www.wattpad.com/story/178312504","tags":["action","adventure","bookfunreaders","clean","complete","completed","dragonfantasy","dragonrider","dragons","elements","fantasy","femaleprotagonist","finished","magicacademy","magicschool","mindreader","quest","savetheworld","secretmission","secrets","shapeshifter","texttospeech","wizard","yafantasy","youngadult"],"cover":"https://img.wattpad.com/cover/178312504-256-k348254.jpg","parts":71,"reads":295340,"title":"Dragons Rising ✔️","votes":19689,"author":{"name":"Stained Glass Dragon","username":"Silverfstreak","followers":466},"mature":false,"comments":896,"language":"English","completed":true,"created_at":"2019-02-10T20:15:12Z","description":"To wizards and mind readers, shapeshifters are disposable. The only way to prove that a shapeshifter is worth more than the dirt on their shoes is to become a dragon rider. Ella plans to do just that. When a stubborn, bad-tempered dragon picks her out of all the young hopefuls at the Choosing Ceremony, her plans go south. She learns an earth-shattering secret about her heritage, and she's trapped at the Dragon Rider Academy, surrounded by potential enemies. She must learn to control illegal fire powers and get along with her dragon if she's going to survive the Academy. And if she manages that","modified_at":"2026-05-25T19:23:43Z"},{"id":"330818856","url":"https://www.wattpad.com/story/330818856","tags":["bait","callum","claudia","darkmagic","dragons","elf","ezran","fantasy","human","knight","light","magic","malereader","monsters","moonshadowelf","reyla","sunfireelf","texttospeech","thedragonprince","warrior","wizard"],"cover":"https://img.wattpad.com/cover/330818856-256-k585667.jpg","parts":59,"reads":132942,"title":"The Dragon Prince//Male reader","votes":2699,"author":{"name":" ","username":"IronDragon19","followers":2096},"mature":false,"comments":1060,"language":"English","completed":true,"created_at":"2023-01-01T23:07:45Z","description":"The world was once peace between two races but war destroyed it and to make worst, humans wielded dark magic destroyed the dragon egg without mercy. The only egg that was heir to the dragon prince. Everything was lost but though it may seem, even the lowest young people can restore peace with unexpected companions who believe. Let us join these fellow adventurers to their journey all you have to do, is take a step. I own nothing but my oc. All belong to the owners. Drop a vote, leave a comment, follow, and enjoy the story you guys. Started: 1/1/2023 1/02/2023 - #2 moonshadowelf 1/05/2023 - #1 ","modified_at":"2026-05-07T15:37:18Z"},{"id":"332188357","url":"https://www.wattpad.com/story/332188357","tags":["akeno","brokenissei","ddraig","dragon","draig","dxd","fallenangel","femalevali","highschooldxd","issei","opissei","originalcharacter","reddragonemperor","revenge","rias","riasxissei","sercets","soloissei","vali"],"cover":"https://img.wattpad.com/cover/332188357-256-k951631.jpg","parts":31,"reads":85968,"title":"Dragon Hiding It All","votes":806,"author":{"name":"KAMEN SENTAI FOREVER","username":"RUINEDDRAGONARMY","followers":498},"mature":false,"comments":172,"language":"English","completed":true,"created_at":"2023-01-17T18:33:49Z","description":"What if issei hyoudou wasn't rencarneted by rias gremory or killed at all. this story is about issei hyoudou who hid and awoke his boosted gears full power as a first year at kuoh yes a year earlier then before, he is already able to use balance break and he made the deal with draig to be half dragon by giving him his heart for that of a dragons and as he grew stronger he knew he changed so he hid himself and acted the same as before perverted as requested to his brother in arms he met a few months after awaken draig Sirzechs but what secrets does issei have with the devil king and why only ti","modified_at":"2025-06-30T03:34:16Z"},{"id":"11355303","url":"https://www.wattpad.com/story/11355303","tags":["captive","dragon","freedom","guns","machine","metal","modern","resistance","sci-fi"],"cover":"https://img.wattpad.com/cover/11355303-256-k870457.jpg","parts":18,"reads":80224,"title":"A Modern Day Dragon","votes":4622,"author":{"name":"Caleb McLean","username":"Pennator","followers":1454},"mature":false,"comments":1153,"language":"English","completed":true,"created_at":"2014-01-06T08:40:21Z","description":"In a remote army base, far away from any civilisation, a baby dragon is born. This dragon's name is Elron. He never new his parents, and his life is controlled by a strange devise, stuck to his head. He has no control over his actions, and has no choice to obey everything that he is told to do, but Elron has been trapped long enough. He wants out, and he is going to do everything in his power to rescue himself, even if it means death. (Disclaimer: I do not own the cover picture, all rights to original creator) (Thanks to @AdolphaSelrah for creating the cover)","modified_at":"2017-10-01T22:07:37Z"},{"id":"14460022","url":"https://www.wattpad.com/story/14460022","tags":["action","adventure","castle","dragon","fantasy","featured","femaleprotagonist","fighting","friendship","kingdom","love","magic","princess","queen","reign","romance","royal","strong-female-character","teenfiction","war","warriors","witch","wizard","youngadult"],"cover":"https://img.wattpad.com/cover/14460022-256-k590769.jpg","parts":125,"reads":753371,"title":"The Dream Keeper's Dragon","votes":40819,"author":{"name":"Alina","username":"Iwriteaboutdragons","followers":2969},"mature":false,"comments":3893,"language":"English","completed":true,"created_at":"2014-04-05T03:55:05Z","description":"In the kingdom of Highfire, you can pack an entire house into one suitcase, grow a vegetable in a second, and have an intriguing conversation with a tree that is four times your size. If you are Aurelie Dranoir, the chosen heir to the Highfire throne, you might not find all these things as appealing as they sound.","modified_at":"2026-05-15T20:17:46Z"},{"id":"328468544","url":"https://www.wattpad.com/story/328468544","tags":["assassin","badass","blood","business","devil","don","donna","family","guns","italianmafia","kidnaping","killing","leader","longlostdaughter","longlostsister","mafia","mafiaboss","mafiafamily","mafiaprincess","mafiaqueen","murder","olderbrothers","romance","streetracing","sword"],"cover":"https://img.wattpad.com/cover/328468544-256-k290804.jpg","parts":32,"reads":39752,"title":"The Dragon Blade","votes":650,"author":{"name":"Mila Wolf","username":"AuroraFrostDragon","followers":96},"mature":false,"comments":46,"language":"English","completed":true,"created_at":"2022-12-05T20:46:26Z","description":"Now wanting something that power and intimidation can't give, parental and brotherly love. Dodging the bullets, killing, and torture has been a part of Elma's life for the past twelve years. Being the youngest Monti, and the only daughter of Lorenzo Monti, The Don Of The Sicilian Mafia meant many things. Especially when being kidnapped, and witnessing the cruel death of her mom protecting her. *** Ever since being dropped into the underworld, Elma has vowed to protect her family from the shadows. Returning after twelve years, Elma atempts to built her roots of trust and emotions again. Every d","modified_at":"2023-09-19T18:12:49Z"}]},"meta":{"timestamp":"2026-06-09T11:38:13.047Z","request_id":"d6c20d4b-d995-4489-a8c0-7f9f0afc0539"},"status":"ok","message":"Search results retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/story":{"get":{"operationId":"get_v1_story","tags":["Wattpad"],"summary":"One story in full","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Story id","schema":{"type":"string"},"example":"26327373"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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 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"},"meta":{"timestamp":"2026-06-09T11:38:13.316Z","request_id":"4f2ff25b-9d5d-486e-8770-0425eff19ccf"},"status":"ok","message":"Story retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/user":{"get":{"operationId":"get_v1_user","tags":["Wattpad"],"summary":"A writer's profile","description":"","parameters":[{"name":"username","in":"query","required":true,"description":"Wattpad username","schema":{"type":"string"},"example":"Wattpad"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/user_stories":{"get":{"operationId":"get_v1_user_stories","tags":["Wattpad"],"summary":"A writer's published stories","description":"","parameters":[{"name":"username","in":"query","required":true,"description":"Wattpad username","schema":{"type":"string"},"example":"Wattpad"},{"name":"limit","in":"query","required":false,"description":"Max stories (1-50)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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.","modified_at":"2026-05-25T16:50:38Z"},{"id":"9341306","url":"https://www.wattpad.com/story/9341306","tags":["awards","category","celebrate","community","contests","holidays","news","newsandupdates","prizes","random","stories","storyrankings","updates","wattpad","wattpad101","wattpadders","wattpadhq","wattpadnews"],"cover":"https://img.wattpad.com/cover/9341306-256-k306542.jpg","parts":101,"reads":58220749,"title":"News & Updates","votes":423598,"author":{"name":"Wattpad","username":"Wattpad","followers":79464806},"mature":false,"comments":530428,"language":"English","completed":false,"created_at":"2013-10-24T21:22:14Z","description":"Stay connected to all things Wattpad by adding this story to your library. We will be posting announcements, updates, and much more!","modified_at":"2026-06-01T16:43:54Z"},{"id":"25279524","url":"https://www.wattpad.com/story/25279524","tags":["community","howto","justwriteit","nanowrimo","prompt","prompts","reader","readers","tips","wattpad","wattpadcommunity","wattpadnews","wattpadupdates","write","writer","writers","writing","writingonwattpad"],"cover":"https://img.wattpad.com/cover/25279524-256-k306579.jpg","parts":81,"reads":11724677,"title":"Community Happenings","votes":69400,"author":{"name":"Wattpad","username":"Wattpad","followers":79464806},"mature":false,"comments":139811,"language":"English","completed":false,"created_at":"2014-10-22T20:16:43Z","description":"Welcome to The Wattpad HQ Community Happenings story! We are so glad you're part of our global community. This is the place for readers and writers to come to discover all the things we're doing to keep our community connected and inspired. From writer prompts to keep you motivated to weekly reading challenges, you'll find it all here.","modified_at":"2026-06-08T15:00:02Z"},{"id":"285999408","url":"https://www.wattpad.com/story/285999408","tags":["bookclub","community","fandom","groupchat","obsession","texttospeech","wattpad","wattpadbookclub"],"cover":"https://img.wattpad.com/cover/285999408-256-k306621.jpg","parts":21,"reads":760089,"title":"Wattpad Group Chat","votes":8165,"author":{"name":"Wattpad","username":"Wattpad","followers":79464806},"mature":false,"comments":18704,"language":"English","completed":false,"created_at":"2021-09-22T16:35:35Z","description":"We know that you come to Wattpad to do a lot more than just read. Building community and connecting over your shared love for storytelling, specific worlds, fictional romances, and more are all part of your Wattpad experience. Meet Wattpad Group Chat - a place where fans, like you, can do just that. Together, we'll obsess over your beloved genres and tropes, share story theories, interact with writers, dive deep into tons of writing-related topics, and more. Add this story to your library to be part of the Group Chat!","modified_at":"2026-06-01T16:37:09Z"}],"username":"Wattpad"},"meta":{"timestamp":"2026-06-09T11:38:13.815Z","request_id":"7c838048-295f-49b7-b0b7-d5084757cc8f"},"status":"ok","message":"User stories retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":5000,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":800,"monthly_call_quota":70000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1900,"monthly_call_quota":350000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":4400,"monthly_call_quota":1700000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/wattpad-api"}