Skip to content
oanor
Sign up free
Marketplace Pricing Features Sign in
GET /v1/search

Search books

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/books-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/books-api/v1/search" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/books-api/v1/search", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/books-api/v1/search");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/books-api/v1/search",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "books": [
            {
                "isbn": "0007525524",
                "cover": "https://covers.openlibrary.org/b/id/255844-M.jpg",
                "title": "Novels (Hobbit / Lord of the Rings)",
                "authors": [
                    "J.R.R. Tolkien"
                ],
                "subjects": [
                    "Fiction, fantasy, epic",
                    "Middle earth (imaginary place), fiction",
                    "Baggins, frodo (fictitious character), fiction",
                    "Baggins, bilbo (fictitious character), fiction",
                    "Gandalf (fictitious character), fiction",
                    "Science fiction, fantasy, horror",
                    "British and irish fiction (fictional works by one author)",
                    "Fiction, fantasy, general"
                ],
                "work_key": "/works/OL14926019W",
                "languages": [
                    "rus",
                    "eng"
                ],
                "edition_count": 24,
                "first_publish_year": 1979
            },
            {
                "isbn": "9780395282656",
                "cover": "https://covers.openlibrary.org/b/id/14627509-M.jpg",
                "title": "The Hobbit",
                "authors": [
                    "J.R.R. Tolkien"
                ],
                "subjects": [
                    "Fantasy",
                    "Arkenstone",
                    "Battle of Five Armies",
                    "invisibility",
                    "thrushes",
                    "eagles",
                    "hobbits",
                    "wizards"
                ],
                "work_key": "/works/OL27482W",
                "languages": [
                    "cor",
                    "ger",
                    "nob",
                    "heb",
                    "pol",
                    "vie",
                    "spa",
                    "cat",
                    "ang",
                    "epo",
                    "jpn",
                    "rum",
                    "lez",
                    "dut",
                    "gle",
                    "eng",
                    "lat",
                    "tur",
                    "por",
                    "swe",
                    "rus",
                    "dan",
                    "chi",
                    "cze",
                    "bul",
                    "ita",
                    "yid",
                    "fin",
                    "fre",
                    "bre"
                ],
                "edition_count": 462,
                "first_publish_year": 1937
            },
            {
                "isbn": "5170097468",
                "cover": null,
                "title": "The Hobbit / Lord of the Rings / Silmarillion",
                "authors": [
                    "J.R.R. Tolkien"
                ],
                "subjects": [],
                "work_key": "/works/OL149
…