FAQs
API Help
Some of the data from Unglue.it is avaiable via a JSON API. You will need a key and username to be able to use the API.
Please sign in first.
Ebook Widgets
You don't need an API key to embed Ebook (HTML) widgets.
Basic API info
Available Resources (JSON)Resources on this list can be accessed via https://unglue.it/api/v1/{resource_on_list}/?format=json&api_key={your_api_key}&username={your_username} .
Works can be ordered by how often they've been favorited; append &order_by=num_wishes (ascending) or &order_by=-num_wishes (descending).
Free Ebooks by ISBN
With an API key, you can check if there's a free ebook for any ISBN. ISBNs can be 10 or 13 digits, and can include dashes. This service returns all free-licensed ebooks for a work associated with an ISBN, and for each ebook includes information about file type, rights, and the provider hosting the file.
For example, here's how to get a list of ebook files for "Homeland".
(Log in to see links)
Identifier Resolution
Here's how to get use the api to find related identifiers:
-
(Log in to see links)
In addition to 'isbn', you can use 'goog' if you have a google books id, 'doab' for DOAB handles (like '20.500.12854/97310'), 'doi' for Digital Object identifiers (like '10.3390/books978-3-0365-6176-9', and 'oclc' for oclc numbers.
Now you'll have URIs for an unglue.id work id and (possibly) one or more unglue.it edition ids.
-
Use the work id's (or the edition ids if you're feeling selective) to find all the associated identifiers.:
(Log in to see links)
Do a query on your identifier.
Here's how to get identifiers for an isbn:
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.