api
The Goodreads API is a work in progress. If you have something you would like to build that isn't supported, please contact us — chances are good we will add your support.
get the books on a shelf
Each shelf has an xml/rss file associated with it that gives the list of books on that shelf.- currently-reading shelf: http://www.goodreads.com/review/list_rss?shelf=currently-reading
- read shelf: http://www.goodreads.com/review/list_rss?order=d&per_page=10&shelf=read&sort=date_added
- sort options: date_published, rating, shelves, date_created, comments, review, title, author, notes, random, num_ratings, date_read, date_added, avg_rating
- order options: a (ascending), d (descending)
- per_page options: 1-200
get your friend updates
You can get your friend updates (the same data you see on your homepage) using the friend update RSS feed.- friend updates: http://www.goodreads.com/home/index_rss/XXX?key=KEY
link to a book
- by isbn: http://www.goodreads.com/book/isbn/0590353403
- add a review: http://www.goodreads.com/review/isbn/0590353403
- by title: http://www.goodreads.com/book/title/Harry+Potter+and+the+Half-Blood+Prince
- by author: http://www.goodreads.com/book/author/Mark+Twain