Click here to skip to this page's main content.

New to the Open Library? — Learn how it works
Is Open Library useful to you? Chip in to keep it growing. Your gift will be matched today!   Donate
Last edited by Charles Horn
April 1, 2016 | History

Open Library Search API

Open Library provides an experimental API to search.

WARNING: This is an experimental API and can change in future.

URL format

The URL format for API is simple. Take the search URL and replace /search with /search.json.

Response Format

The response with be of the following format.

{
    "start": 0,
    "num_found": 629,
    "docs": [
        {...},
        {...},
        {...},
        ...
        {...}]
}

Each document specified listed in "docs" will be of the following format:

{
    "cover_i": 258027,
    "has_fulltext": true,
    "edition_count": 120,
    "title": "The Lord of the Rings",
    "author_name": [
        "J. R. R. Tolkien"
    ],
    "first_publish_year": 1954,
    "key": "OL27448W",
    "ia": [
        "returnofking00tolk_1",
        "lordofrings00tolk_1",
        "lordofrings00tolk_0",
        "lordofrings00tolk_3",
        "lordofrings00tolk_2",
        "lordofrings00tolk",
        "twotowersbeingse1970tolk",
        "lordofring00tolk",
        "lordofrings56tolk",
        "lordofringstolk00tolk",
        "fellowshipofring00tolk_0"
    ],
    "author_key": [
        "OL26320A"
    ],
    "public_scan_b": true
}

History Created February 27, 2013 · 2 revisions

April 1, 2016 Edited by Charles Horn correct urls and update returned json examples
February 27, 2013 Created by Anand Chitipothu documented search API.