API Info

===============

The API is currently in: released

DEVELOPERS: have a look at the Dev Notes area at the bottom of the page for a more technical explanation of what's going on.

Url to access: https://librivox.org/api/feed/audiobooks

Parameters allowed (current):

• id - fetches a single record
• since - takes a UNIX timestamp; returns all projects cataloged since that time
• author - all records by that author last name
• title - all matching titles
• genre - all projects of the matching genre
• extended - =1 will return the full set of data about the project
• coverart - =1 will return links to cover art (if available) for each audiobook

Note that the title, author & genre may be searched on with ^ as before, to anchor the beginign of the search term.

Example: https://librivox.org/api/feed/audiobooks/title/^all

Records default to a limit of 50, offset 0. You may also send these:

• limit
• offset

Search may be conducted as:

https://librivox.org/api/feed/audiobooks/?id=52

or

https://librivox.org/api/feed/audiobooks/id/52

Formats:

Default format is xml, but also currently available are json, jsonp, serialized & php array. Csv, MARC records and OPML coming soon.

Example:

https://librivox.org/api/feed/audiobooks/?id=52&format=json

Simple Audiotracks API

Endpoint: https://librivox.org/api/feed/audiotracks

Parameters:

• id - of track itself
• project_id - all tracks for project

Simple Authors API

Endpoint: https://librivox.org/api/feed/authors

Parameters:

• id - of author
• last_name - exact match

Here is a TODO list of what is currently being worked on. I'll strike these they are added. This is intended to be an open, back and forth communication area, so please feel free to contact us if you have questions, doubts or observations.

• Dynamic responses - I'm going to create a paramter to get a standard simple, standard full set of data ADDED. Use "extended=1"; simple version is default
• Dynamic field selection - may get added at the end, but hope to all you to specify the exact set of fields or sub-objects (ie, authors, sections) to include in the response ADDED. See note below for list of fields & usage
• Separate endpoint for sections (tracks) ADDED
• Adding info about time & total time ADDED
• Separate endpoint for authors (just to allow for collecting author info - will be fairly simple, not tied to books I don't think) ADDED
• Response format in csv, OPML & MARC records

Fields list:

You can specify a list of fields to return in the following two ways:

&fields={id,title,authors,url_rss}

&fields[]=id&fields[]=title&fields[]=url

This supports sub-groups (authors, translators, sections, genres) but not fields within the subgroups (yet)

List of fields:

• id
• title
• description
• url_text_source
• language
• copyright_year
• num_sections
• url_rss
• url_zip_file
• url_project
• url_librivox
• url_iarchive
• url_other
• totaltime
• totaltimesecs
• authors
• coverart_jpg
• coverart_pdf
• coverart_thumbnail
• sections
• genres
• translators