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
Note that the title, author & genre may be searched on with ^ as before, to anchor the beginign of the search term.
Records default to a limit of 50, offset 0. You may also send these:
Search may be conducted as:
Default format is xml, but also currently available are json, jsonp, serialized & php array. Csv, MARC records and OPML coming soon.
Simple Audiotracks API
- id - of track itself
- project_id - all tracks for project
Simple Authors API
- 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 dataADDED. 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 responseADDED. 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
You can specify a list of fields to return in the following two ways:
This supports sub-groups (authors, translators, sections, genres) but not fields within the subgroups (yet)
List of fields: