Skip to content

Works, editions, and authors

Open Library stores books as three linked record types. Most calls return one of them, and most confusion comes from mixing them up.

Record What it is Key format Example
Work A book in the abstract, across all its versions /works/OL...W /works/OL27448W (The Lord of the Rings)
Edition One published version of a work, with its own ISBN, publisher, and page count /books/OL...M /books/OL33912545M (HarperCollins paperback, 2004)
Author A person linked from works /authors/OL...A /authors/OL26320A (J.R.R. Tolkien)

To get any record as JSON, add .json to its key: https://openlibrary.org/works/OL27448W.json.

Author  <--  Work  <--  Edition
             authors[]   works[]
  • A work lists its authors in authors[].author.key.
  • An edition lists its work in works[].key.
  • Links are keys, not names. To get a name or title, request the linked record.

List the editions of a work

curl -s -A "openlibrary-unofficial-docs/0.1" \
  "https://openlibrary.org/works/OL27448W/editions.json?limit=2"

Output (trimmed):

{
  "links": {
    "self": "/works/OL27448W/editions.json?limit=2",
    "work": "/works/OL27448W",
    "next": "/works/OL27448W/editions.json?limit=2&offset=2"
  },
  "size": 253,
  "entries": [
    {
      "key": "/books/OL62536872M",
      "title": "El seƱos de los anillos 2, las dos torres",
      "publishers": ["Booket"],
      "isbn_13": ["9788445077504"],
      "languages": [{"key": "/languages/spa"}],
      "works": [{"key": "/works/OL27448W"}]
    },
    {
      "key": "/books/OL62445425M",
      "title": "Il Signore degli Anelli",
      "publishers": ["Bompiani"],
      "isbn_13": ["978-8830119000"],
      "isbn_10": ["8830119008"],
      "works": [{"key": "/works/OL27448W"}]
    }
  ]
}

size is the total number of editions. Use links.next to get the next batch. See Page through results.

Note

Edition data is entered by many contributors. Formats vary. In the output above, one ISBN has hyphens and one does not, and a Spanish edition is linked to the whole trilogy.

Look up an edition by ISBN

/isbn/{isbn}.json accepts an ISBN-10 or ISBN-13. It answers with a redirect to the edition's /books/ key, so tell your client to follow redirects (-L in curl).

curl -sL -A "openlibrary-unofficial-docs/0.1" \
  "https://openlibrary.org/isbn/9780261103252.json"

Output (trimmed):

{
  "key": "/books/OL33912545M",
  "title": "The Lord of the Rings",
  "publishers": ["HarperCollins"],
  "publish_date": "2004",
  "physical_format": "Paperback",
  "number_of_pages": 1031,
  "isbn_10": ["0261103253"],
  "covers": [12013118],
  "works": [{"key": "/works/OL27448W"}]
}

This edition has no authors field. Follow works[0].key to the work, then the work's authors to the author.

Next steps