Developer API *BETA*


Welcome to the Wattpad Developer API - these APIs are made available to developers who want to build something with Wattpad. Note, the API is currently in limited beta, support is not provided. Please send us your suggestions at admin at wattpad dot com.

REST API


The API endpoint is http://wattpad.com/apiv2/{method} with arguments provided via GET or POST. As a rule of thumb, GET methods usually get information while POST methods make changes - although this is not always the case, see the specific method for details.

Output methods


The API provides several options for output, the default being JSON. Other formats can be selected by sending an output variable (e.g. output=xml), valid values for which are json, text, xml.

Usage Limitations


The Wattpad API is rate limited. If the rate limit is hit, a HTTP 400 header will be returned. Contact us if your usage exceeds this limit and you want to continue using it.

The APIs are provided on an as-is basis. Remember, you must follow the Terms of Service if you want to use it.

Visit engineering.wattpad.com for updates.

Methods


getcast


GETGet the cast for a story

userstatus


GETGet a user's status

storylist


GETRetrieve a list of stories based on category or keyword

comments


GETRetrieve comments for a story

getcategories


GETGet the names of story categories

getlang


GETGet available languages and ids