About
I've written this basic API so that people can access the data on this site for their own needs.
I complain a lot about sites not having a proper API, so I figured it was about time this site had one too.
If you have any suggestions, problems, questions, or comments, please about them.
Retrive Story List
Retrive a list of stories. Includes an array of story blocks (see bellow).
- Optional
- page - The page to retrive.
- limit - How many stories to retrive per page.
- chapters - Set if you want chapter information included. Warning, this returns a lot of data and can slow your script. It is turned off by default. The latest chapter information is always included.
- callback - Enclose the JSON output in this function name.
Retrive Story Information
Retrive the information about a story.
- Required
- id - The id of the story requested.
- Optional
- chapters - Set if you want chapter information included. Warning, this returns a lot of data and can slow your script. It is turned off by default. The latest chapter information is always included.
- callback - Enclose the JSON output in this function name.
Retrive Media List
Retrive a list of media items. Includes an array of media blocks (see bellow).
- Optional
- page - The page to retrive.
- limit - How many items to retrive per page.
- callback - Enclose the JSON output in this function name.
- The following can not be used together.
- artist - Retrive media created by this artist.
- tag - Retrive media containing this tag.
Retrive Media Information
Retrive information about a non-story media item.
- Required
- id - The id of the item requested.
- Optional
- callback - Enclose the JSON output in this function name.
Retrive Random Story
Retrive one to ten random stories. Results refreash every five minutes.
- Optional
- limit - How many images.
- callback - Enclose the JSON output in this function name.
Retrive Random Media
Retrive one to ten random media items. Results refreash every five minutes.
- Optional
- limit - How many items.
- callback - Enclose the JSON output in this function name.
Retrive Artists
Retrive an array of artists.
- Optional
- sort - How to sort the artists, by 'name' or by 'total' items.
- callback - Enclose the JSON output in this function name.
Retrive Tags
Retrive an array of tags/keywords.
- Optional
- group - If set, tags will be grouped by type.
- sort - How to sort the tags, by 'name' or by 'total' items.
- callback - Enclose the JSON output in this function name.
Retrive Ratings
Retrive a listing of ratings and their ID numbers.
- Optional
- callback - Enclose the JSON output in this function name.
Retrive Sites
Retrive a listing of websites and their ID numbers.
- Optional
- callback - Enclose the JSON output in this function name.
Retrive Media Types
Retrive a listing of media types on the site and their ID numbers.
- Optional
- callback - Enclose the JSON output in this function name.
Retrive Tag Types
Retrive a listing of tag/keyword types on the site and their ID numbers.
- Optional
- callback - Enclose the JSON output in this function name.
Retrive Site Info
Retrive information on how much media is indexed on the site.
Update: Added new fields for translations, audio books, and comics.
- Optional
- callback - Enclose the JSON output in this function name.