API: Books

<book id="225">
  <dc:title>The Pickwick Papers</dc:title>
  <dc:author id="21">Dickens, Charles</dc:author>
  <dc:identifier>http://www.feedbooks.com/book/225</dc:identifier>
  <dc:language>en</dc:language>
  <dc:date>1832</dc:date>
  <dc:subject>Novels</dc:subject>
  <cover>http://www.feedbooks.com/book/225.png</cover>
  <files>
    <pdf>http://www.feedbooks.com/book/225.pdf</pdf>
    <epub>http://www.feedbooks.com/book/225.epub</epub>
    <mobipocket>http://www.feedbooks.com/book/225.mobi</mobipocket>
  </files>
</book>

You'll notice that to describe most of the things in this element, we're using DublinCore.

Endpoint: /books
Formats: XML
Description: List all books, using pagination
Parameters:

• page: for the page number, in the root <browse> node you will find the current page and total number of pages
• letter: display the books with ... as the first letter of their name
• year: book released in ...
• period: ancient, medieval, renaissance, early modern or modern
• lang: language of the book
• order: normally from A to Z, use desc to reverse order or year to sort them by release date

Endpoint: /books/top
Formats: XML, RSS
Description: List top books (100 items)
Parameters:

• letter: display the books with ... as the first letter of their name
• year: book released in ...
• period: ancient, medieval, renaissance, early modern or modern
• lang: language of the book
• order: normally overall, week will display the most popular for the previous week and month for the last 4 weeks

Endpoint: /books/recent
Formats: XML, RSS
Description: List recent books (100 items)
Parameters:

• letter: display the books with ... as the first letter of their name
• year: book released in ...
• period: ancient, medieval, renaissance, early modern or modern
• lang: language of the book

Endpoint: /books/search
Formats: XML
Description: Search for a book
Parameters:

• query: you can use advanced queries too (for example "type:Horror AND Lovecraft")
• sort: default is search relevance, use downloads to sort by popularity

Endpoint: /book/:id/similar
Formats: XML
Description: List similar books for a given book
Parameters: none

Endpoint: /author/:id/books
Formats: XML
Description: List all books for an author (id), using pagination
Parameters: Same as /books

Endpoint: /author/:id/books/top
Formats: XML, RSS
Description: List top books for an author (id), 100 items max
Parameters: Same as /books/top

Endpoint: /author/:id/books/recent
Formats: XML, RSS
Description: List recent books for an author (id), 100 items max
Parameters: Same as /books/recent

Endpoint: /type/:type/books
Formats: XML
Description: List all books for a type (name), using pagination
Parameters: Same as /books

Endpoint: /type/:type/books/top
Formats: XML, RSS
Description: List top books for a type (name), 100 items max
Parameters: Same as /books/top

Endpoint: /type/:type/books/recent
Formats: XML, RSS
Description: List recent books for a type (name), 100 items max
Parameters: Same as /books/recent

Endpoint: /list/:id
Formats: XML
Description: Show the books included in a list (can also display userbooks)
Parameters:

• sort: normally it will display the list in its order, downloads based on the most downloaded items, title will display the items alphabetically and year based on their release date

Endpoint: /recommendations
Formats: XML
Description: Display recommendations, if no recommendations are available it'll display featured books
Parameters: Authentication is required