FAQs
API Help
Ebook Widgets
You don't need an API key to embed Ebook (HTML) widgets.
OPDS Catalog Feeds
We have a basic implementation of OPDS feeds. You don't need a key to use them. The starting point is https://unglue.it/api/opds/. Use the page parameter to page through the results.
Examples:
- filtered by format
https://unglue.it/api/opds/epub/- filtered by license
https://unglue.it/api/opds/by-sa/- filtered by title search
https://unglue.it/api/opds/s.open/- filtered by keyword
https://unglue.it/api/opds/kw.fiction/- filtered by ungluer
https://unglue.it/api/opds/@eric/- filtered by having a Project Gutenberg or DOAB identifier (doab, gtbg)
https://unglue.it/api/opds/doab/-gtbg/?page=1
There's also an OPDS record available for every work on unglue.it. For example, requesting, https://unglue.it/api/opds/all/?work=13950 get you to the web page or opds record for A Christmas Carol.
ONIX Catalog Feeds
There is an ONIX 3.0 feed corresponding to every facet of our free ebook lists. You don't need a key to use them. There is a maximum of 100 books per result you can change with the max parameter. For example, here are the first twenty CC BY-ND-ND licensed books available in EPUB. Pages of 30 records each are available via the page parameter. Here's the first page of books from the Directory of Open Access Books.
There's also an ONIX record available for every free ebook on unglue.it. For example, here is Issues in Open Research Data.
Identifiers with Content type negotiation
There's a URI to identify every work used in OPDS feeds. HTTP content negotiation is used for these ids, so requesting application/atom+xml;profile=opds-catalog;kind=acquisition for https://unglue.it/api/id/work/13950/ get you to the web page or opds record for A Christmas Carol. requesting text/xml gets you the onix record. Otherwise, you get the normal html page.
