# Google Books (/integrations/google_books)





{/* MANUAL-CONTENT-START:intro */}

Use [Google Books](https://books.google.com) in Sim to search by title, author, ISBN, or keyword and retrieve a volume’s metadata, including its description, authors, ratings, and publication details.

{/* MANUAL-CONTENT-END */}

## Use the block [#usage-instructions]

Search for books using the Google Books API. Find volumes by title, author, ISBN, or keywords, and retrieve detailed information about specific books including descriptions, ratings, and publication details.

## Actions [#actions]

### Google Books Volume Search [#google-books-volume-search]

Search for books using the Google Books API

<ReferenceDetails>
  #### Input [#input]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Google Books API key |
  | `query` | string | Yes | Search query. Supports special keywords: intitle:, inauthor:, inpublisher:, subject:, isbn: |
  | `filter` | string | No | Filter results by availability (partial, full, free-ebooks, paid-ebooks, ebooks) |
  | `printType` | string | No | Restrict to print type (all, books, magazines) |
  | `orderBy` | string | No | Sort order (relevance, newest) |
  | `startIndex` | number | No | Index of the first result to return (for pagination) |
  | `maxResults` | number | No | Maximum number of results to return (1-40) |
  | `langRestrict` | string | No | Restrict results to a specific language (ISO 639-1 code) |

  #### Output [#output]

  | Parameter | Type | Description |
  | - | - | - |
  | `totalItems` | number | Total number of matching results |
  | `volumes` | array | List of matching volumes |
  | ↳ `id` | string | Volume ID |
  | ↳ `title` | string | Book title |
  | ↳ `subtitle` | string | Book subtitle |
  | ↳ `authors` | array | List of authors |
  | ↳ `publisher` | string | Publisher name |
  | ↳ `publishedDate` | string | Publication date |
  | ↳ `description` | string | Book description |
  | ↳ `pageCount` | number | Number of pages |
  | ↳ `categories` | array | Book categories |
  | ↳ `averageRating` | number | Average rating (1-5) |
  | ↳ `ratingsCount` | number | Number of ratings |
  | ↳ `language` | string | Language code |
  | ↳ `previewLink` | string | Link to preview on Google Books |
  | ↳ `infoLink` | string | Link to info page |
  | ↳ `thumbnailUrl` | string | Book cover thumbnail URL |
  | ↳ `isbn10` | string | ISBN-10 identifier |
  | ↳ `isbn13` | string | ISBN-13 identifier |
</ReferenceDetails>

### Google Books Volume Details [#google-books-volume-details]

Get detailed information about a specific book volume

#### Input [#input-1]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `apiKey` | string | Yes | Google Books API key |
| `volumeId` | string | Yes | The ID of the volume to retrieve |
| `projection` | string | No | Projection level (full, lite) |

#### Output [#output-1]

| Parameter | Type | Description |
| - | - | - |
| `id` | string | Volume ID |
| `title` | string | Book title |
| `subtitle` | string | Book subtitle |
| `authors` | array | List of authors |
| `publisher` | string | Publisher name |
| `publishedDate` | string | Publication date |
| `description` | string | Book description |
| `pageCount` | number | Number of pages |
| `categories` | array | Book categories |
| `averageRating` | number | Average rating (1-5) |
| `ratingsCount` | number | Number of ratings |
| `language` | string | Language code |
| `previewLink` | string | Link to preview on Google Books |
| `infoLink` | string | Link to info page |
| `thumbnailUrl` | string | Book cover thumbnail URL |
| `isbn10` | string | ISBN-10 identifier |
| `isbn13` | string | ISBN-13 identifier |