# Google Books Volume API Documentation

<p><strong>Google Books Volume API</strong> returns one book by volume id: <code>id</code>, <code>title</code>, <code>subtitle</code>, <code>authors</code>, <code>publisher</code>, <code>published_date</code>, <code>description</code>, <code>page_count</code>, <code>print_type</code>, <code>isbn_10</code>, <code>isbn_13</code>, <code>language</code>, <code>categories</code>, <code>average_rating</code>, <code>viewability</code> (full, partial, none or unknown), <code>embeddable</code>, <code>open_access</code>, <code>price</code>, <code>thumbnail_url</code>, <code>cover_url</code>, <code>info_url</code>, <code>preview_url</code> and <code>buy_url</code>, and <code>dimensions</code> when Google Books shows them. Get the volume id from the search or ISBN route. An unknown volume id returns 404.</p><p><strong>Not available:</strong> Google Books does not offer language, print type (magazines, newspapers), ebooks-only, sort order, ratings count or related books on the data this API uses. The parameters <code>language</code>, <code>print_type</code>, <code>ebooks</code> and <code>sort</code> are rejected with a 422 error, never ignored. A field that Google Books does not show for a book is left out. Prices follow the location of the request, not the location of the caller.</p><p><strong>Credits:</strong> 1 credit per successful request. Failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/google-books-api/google_books_volume](https://scrappa.co/docs/google-books-api/google_books_volume)
- **API group:** Google Books API
- **Endpoint:** `GET https://scrappa.co/api/google/books/volume`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | Yes | Google Books volume id, for example nrRKDwAAQBAJ. |

## Example response

```json
{
    "data": {
        "id": "B1hSG45JCX4C",
        "title": "Dune",
        "authors": [
            "Frank Herbert"
        ],
        "isbn_10": "0441013597",
        "isbn_13": "9780441013593",
        "info_url": "https://books.google.com/books?id=B1hSG45JCX4C",
        "language": "en",
        "cover_url": "https://books.google.com/books/content?id=B1hSG45JCX4C&printsec=frontcover&img=1&zoom=1",
        "publisher": "Penguin Publishing Group",
        "categories": [
            "Fiction / Science Fiction / Space Opera",
            "Fiction / Classics",
            "Fiction / Fantasy / Epic"
        ],
        "dimensions": "13.8x23.0x3.2 cm",
        "embeddable": false,
        "page_count": 548,
        "print_type": "book",
        "description": "Frank Herbert\u2019s classic masterpiece\u2014a triumph of the imagination and one of the bestselling science fiction novels of all time.Set on the desert planet Arrakis, Dune is the story of Paul Atreides\u2014who would become known as Muad'Dib\u2014and of a great family's ambition to bring to fruition humankind's most ancient and unattainable dream.A stunning blend of adventure and mysticism, environmentalism and politics, Dune won the first Nebula Award, shared the Hugo Award, and formed the basis of what is undoubtedly the grandest epic in science fiction.",
        "open_access": false,
        "viewability": "none",
        "thumbnail_url": "https://books.google.com/books/content?id=B1hSG45JCX4C&printsec=frontcover&img=1&zoom=5&imgtk=AFLRE71wHDwa8twDjmJYAA0NibDFCwjLakxMx3kkRXb218SEIwaTQNgbkdAa5tc6rt7el78nzozOg9KEaob3InHzrnT9dAqO8k9W4YadlVcNN9AY6zd3YBxnNbqYNiJf59xqdQeqdB1i",
        "average_rating": 4.8,
        "published_date": "2005-08-02"
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "volume"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing, invalid or not supported. This response is not billable. |
| 404 | Not Found | No book has this volume id. This response is not billable. |
| 503 | Upstream Unavailable | Google Books could not be reached after several tries. This response is not billable and is retryable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)