# Books API
> Search millions of books, look up editions by ISBN-10/13 and find authors — with covers, publish years, publishers, page counts and subjects. Powered by Open Library (Internet Archive).

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/books-api/..."
```

## Pricing
- **Free** (Free) — 2,500 calls/Mo, 2 req/s
- **Basic** ($8/Mo) — 80,000 calls/Mo, 5 req/s
- **Pro** ($24/Mo) — 400,000 calls/Mo, 15 req/s
- **Mega** ($69/Mo) — 1,500,000 calls/Mo, 40 req/s

## Endpoints

### Books

#### `GET /v1/author` — Search authors

**Parameters:**
- `q` (query, required, string) — Author name Example: `tolkien`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/books-api/v1/author?q=tolkien"
```

**Response:**
```json
{
    "data": {
        "count": 20,
        "query": "tolkien",
        "authors": [
            {
                "key": "OL2623360A",
                "name": "Christopher Tolkien",
                "top_work": "The War of the Ring",
                "birth_date": "21 November 1924",
                "work_count": 43
            },
            {
                "key": "OL14431239A",
                "name": "F. Tolkien",
                "top_work": "Thug Life",
                "birth_date": null,
                "work_count": 23
            },
            {
                "key": "OL26320A",
                "name": "J.R.R. Tolkien",
                "top_work": "The Hobbit",
                "birth_date": "3 January 1892",
                "work_count": 403
            },
            {
                "key": "OL1477672A",
                "name": "Simon Tolkien",
                "top_work": "Final Witness",
                "birth_date": "1959",
                "work_count": 18
            },
            {
                "key": "OL2977155A",
                "name": "Michael Tolkien",
                "top_work": "Rainbow",
                "birth_date": null,
                "work_count": 8
            },
            {
                "key": "OL38677A",
                "name": "Tracy Tolkien",
                "top_work": "A collector's guide to costume jewelry",
                "birth_date": "1962",
                "work_count": 7
            },
            {
                "key": "
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/isbn` — Book details by ISBN

**Parameters:**
- `isbn` (query, required, string) — ISBN-10 or ISBN-13 Example: `9780261103344`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/books-api/v1/isbn?isbn=9780261103344"
```

**Response:**
```json
{
    "data": {
        "url": "http://openlibrary.org/books/OL10236414M/The_Hobbit",
        "isbn": "9780261103344",
        "cover": "https://covers.openlibrary.org/b/id/10522108-M.jpg",
        "title": "The Hobbit",
        "authors": [
            "J.R.R. Tolkien"
        ],
        "subjects": [
            "Fantasy",
            "Arkenstone",
            "Battle of Five Armies",
            "invisibility",
            "thrushes",
            "eagles",
            "hobbits",
            "wizards",
            "dragons",
            "dwarves"
        ],
        "subtitle": "or There and Back Again",
        "publishers": [
            "HarperCollins Publishers"
        ],
        "publish_date": "2011",
        "number_of_pages": null
    },
    "meta": {
        "timestamp": "2026-05-30T02:21:57.594Z",
        "request_id": "edc5221d-6900-4f97-9f18-6a5daf754cba"
    },
    "status": "ok",
    "message": "Book retrieved successfully",
    "success": true
}
```

#### `GET /v1/search` — Search books

**Parameters:**
- `q` (query, optional, string) — Free-text query Example: `lord of the rings`
- `title` (query, optional, string) — Title Example: `the hobbit`
- `author` (query, optional, string) — Author Example: `tolkien`
- `limit` (query, optional, string) — Max 1-50 Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/books-api/v1/search?q=lord+of+the+rings&title=the+hobbit&author=tolkien&limit=20"
```

**Response:**
```json
{
    "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 Armi
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/books-api
OpenAPI spec: https://www.oanor.com/api/books-api/openapi.json