# Open Library



The Internet Archive's open catalog of the world's books — search it by title, then read any work's full edition list: publishers, dates, formats, and ISBNs.



## Open Library Search

Search the world's open book catalog — title, authors, first publication year, and ISBNs on every card.

- Method: `GET`
- Path: `/v1/books/search`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `q` | string | required | What to search the catalog for — title, author, any words on the card. |
| `limit` | integer | optional | Cards per page. |
| `max_age` | integer (seconds) | optional | Ask for data no older than this. Clamped to the product's own floor, so it can narrow the window but never force a refresh on every call. |

**Example request**

```bash
curl https://api.diraz.ae/v1/books/search \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "query": "clean code",
    "total": 180,
    "items": [
      {
        "key": "OL7432654W",
        "title": "Clean Code",
        "authors": ["Robert C. Martin"],
        "first_publish_year": 2008,
        "isbn": ["9780132350884"],
        "cover": "https://covers.openlibrary.org/b/id/7498726-M.jpg"
      }
    ]
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ",
    "as_of": "2026-08-20T16:30:00.000Z",
    "age_seconds": 3600,
    "next_update_at": "2026-08-21T16:30:00.000Z"
  }
}
```

## Open Library Book

One work's edition list from the open book catalog — publishers, dates, formats, languages, and ISBNs for every edition.

- Method: `GET`
- Path: `/v1/books/{work}`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `work` | path segment | required | A work key from a search card, like `OL17618370W`. |
| `max_age` | integer (seconds) | optional | Ask for data no older than this. Clamped to the product's own floor, so it can narrow the window but never force a refresh on every call. |

**Example request**

```bash
curl https://api.diraz.ae/v1/books/%7Bwork%7D \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "key": "OL17618370W",
    "title": "Clean Code",
    "editions": [
      {
        "isbn_13": ["9780132350884"],
        "isbn_10": ["0132350882"],
        "publisher": ["Prentice Hall"],
        "publish_date": "2008",
        "format": "Hardcover",
        "language": ["eng"]
      }
    ],
    "edition_count": 13,
    "url": "https://openlibrary.org/works/OL17618370W"
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ",
    "as_of": "2026-08-20T16:30:00.000Z",
    "age_seconds": 3600,
    "next_update_at": "2026-08-21T16:30:00.000Z"
  }
}
```