QDB RSS API

Version 0.2, 2011-05-09

Introduction

QDB.us currently offers a read-only API in the form of a parametrized RSS feed. More options are coming soon, including voting, JSON, and XML. For now, here is how to use the RSS feed.

Feed URL

http://qdb.us/qdb.xml

Parameters

These are specified in the GET string.

action
String; latest, top, best, random, quote, bottom, leetness, picks

With the exception of quote, these correspond to respective pages and URLs at qdb.us.
The quote action returns a single quote, specified in the quote parameter.

quote
Integer

Used with the quote action, specifies the quote ID to return.

fixed
Integer; 0, 1

1, default, <tt> tags are included to format the quote in a fixed-width font.
0, <tt> tags are omitted from the <description> in the RSS feed.

client
String

Just for statistics for now; Please let us know if you're going to use this one.

Examples

http://qdb.us/qdb.xml?action=quote&quote=8&client=fooapp
Quote #8
http://qdb.us/qdb.xml?action=random&client=fooapp
Random quotes
http://qdb.us/qdb.xml?action=latest&fixed=0&client=fooapp
Latest quotes without <tt> tags

Notes

The random page is cached for 15 seconds.

Contact

Please write feedback@qdb.us with any questions or comments.