---
type: "firecrawl-provider"
description: "Goodreads (goodreads.com), the largest public book rating and review community, read signed out: book search by title, author or ISBN; one book's ratings with the star distribution, genres, series, edition identifiers (ISBN-10, ISBN-13, ASIN), awards, characters and reader activity counts; community reviews with full text, filters and pagination; author pages and complete bibliographies; series in reading order; quotes by book or author; Listopia lists; and the Goodreads Choice Awards by year and category."
use_when: "Goodreads (goodreads.com), the largest public book rating and review community, read signed out: book search by title, author or ISBN; one book's ratings with the star distribution, genres, series, edition identifiers (ISBN-10, ISBN-13, ASIN), awards, characters and reader activity counts; community reviews with full text, filters and pagination; author pages and complete bibliographies; series in reading order; quotes by book or author; Listopia lists; and the Goodreads Choice Awards by year and category."
categories: "Entertainment"
capabilities: 9
credits_per_call: 5
---
# Goodreads on Firecrawl Alexandria

Goodreads (goodreads.com), the largest public book rating and review community, read signed out: book search by title, author or ISBN; one book's ratings with the star distribution, genres, series, edition identifiers (ISBN-10, ISBN-13, ASIN), awards, characters and reader activity counts; community reviews with full text, filters and pagination; author pages and complete bibliographies; series in reading order; quotes by book or author; Listopia lists; and the Goodreads Choice Awards by year and category.

- Categories: Entertainment
- Category index: [Entertainment category](https://alexandria.firecrawl.dev/agents/categories/entertainment)
- Provider key: `goodreads-com`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://www.firecrawl.dev/app/alexandria/goodreads-com)
- [OpenAPI spec](https://alexandria.firecrawl.dev/agents/providers/goodreads-com/openapi.json)

## Capabilities

- [Author](https://alexandria.firecrawl.dev/agents/providers/goodreads-com/books/author): A Goodreads author page: name, photo, birth date and place, death date, website, genres, influences, the full biography, average rating across all works, ratings and reviews counts, number of distinct works, followers, and the author's ten most popular books with ratings.
- [Author books](https://alexandria.firecrawl.dev/agents/providers/goodreads-com/books/author_books): Every distinct work by a Goodreads author, 30 per page, sorted by popularity, original publication year, title, average rating or page count: book id, title, URL, cover, co-authors, average rating, ratings count, publication year, editions count and work id.
- [Book](https://alexandria.firecrawl.dev/agents/providers/goodreads-com/books/book): One Goodreads book by id, URL or ISBN: title, full description, cover, authors and contributors with roles, series and position, genres, format, pages, publisher, publication date, language, ISBN-10/ISBN-13/ASIN, the work (original title, first publication date, Goodreads work id), the community rating with its 5-to-1 star distribution and text review count, review counts per language, currently-reading and want-to-read counts, quote/question/discussion counts, literary awards, characters and settings.
- [Book reviews](https://alexandria.firecrawl.dev/agents/providers/goodreads-com/books/book_reviews): Community reviews of a Goodreads book (all editions of the work), with full text, star rating, created and updated time, like and comment counts, spoiler flag, the reviewer's shelf and tags, and the reviewer (id, name, profile URL, review and follower counts). Sort by Goodreads' default order, newest or oldest; filter by star rating, review language or words in the text; page with `cursor`. `total_count` is the number of reviews matching the filters.
- [Choice awards](https://alexandria.firecrawl.dev/agents/providers/goodreads-com/books/choice_awards): The Goodreads Choice Awards. With `year`: every category of that year with its winner (book id, title, cover). With `category`: that category's nominees with vote counts (once results are published), the winner with its votes and blurb, and the total votes.
- [List books](https://alexandria.firecrawl.dev/agents/providers/goodreads-com/books/list_books): A Goodreads Listopia list: name, description, books and voters counts, likes, creation date, creator and tags, plus up to 100 books per page in rank order with score, votes, average rating, ratings count, authors and cover.
- [Quotes](https://alexandria.firecrawl.dev/agents/providers/goodreads-com/books/quotes): Quotes from a Goodreads book (all editions) or by an author, 30 per page, most liked first: quote id and URL, full text, attributed author, source book with work id, tags and like count, plus the total number of quotes.
- [Search books](https://alexandria.firecrawl.dev/agents/providers/goodreads-com/books/search_books): Search Goodreads books by title, author or ISBN: 20 results per page with Goodreads book id, title, URL, cover, authors, average rating, ratings count, first publication year, editions count and work id. An exact ISBN returns that edition as the single result; an unknown query returns an empty list.
- [Series](https://alexandria.firecrawl.dev/agents/providers/goodreads-com/books/series): A Goodreads series: title, description, primary and total work counts, and the books in series order with their position label (1, 2, 0.5, 1-3), id, title, URL, cover, author, average rating, ratings and text review counts, pages, publication year, editions count, work id and description.

## 1. Choose this provider when

Goodreads (goodreads.com), the largest public book rating and review community, read signed out: book search by title, author or ISBN; one book's ratings with the star distribution, genres, series, edition identifiers (ISBN-10, ISBN-13, ASIN), awards, characters and reader activity counts; community reviews with full text, filters and pagination; author pages and complete bibliographies; series in reading order; quotes by book or author; Listopia lists; and the Goodreads Choice Awards by year and category.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "goodreads-com",
  "capability": "books/author",
  "options": {
    "author": "656983"
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `author` (string, required): A Goodreads author id (`656983`, `656983.J_R_R_Tolkien`) or author URL. Example: `656983`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "goodreads-com",
    capability: "books/author",
    options: {
      author: "656983",
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "goodreads-com",
  "capability": "books/author",
  "options": {
    "author": "656983"
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "goodreads-com",
    "capability": "books/author",
    "options": {
      "author": "656983"
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'goodreads-com/books/author' \
  --options '{"author":"656983"}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "goodreads-com",
  "capability": "books/author",
  "options": {
    "author": "656983"
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "goodreads-com",
  "capability": "books/author",
  "options": {
    "author": "656983"
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "author_id": 656983,
  "average_rating": 4.38,
  "birthplace": "Bloemfontein, Mangaung, Free State, South Africa",
  "born": "1892-01-03",
  "description": "John Ronald Reuel Tolkien: writer, artist, scholar, linguist. Known to millions around the world as the author of\nThe Lord of the Rings\n, Tolkien spent most of his life teaching at the University of Oxford where he was a distinguished academic in the fields of Old and Middle English and Old Norse. His creativity, confined to his spare time, found its outlet in fantasy works, stories for children, poetry, illustration and invented languages and alphabets.\n\nTolkien’s most popular works, The Hobbit and The Lord of the Rings are set in Middle-earth, an imagined world with strangely familiar settin",
  "died": "1973-09-02",
  "distinct_works": 807,
  "followers_count": 80476,
  "genres": [
    "Fantasy",
    "Fiction",
    "Children's"
  ],
  "image_url": "https://images.gr-assets.com/authors/1795089990p5/656983.jpg",
  "influences": [
    "Traditional Catholicism",
    "Scholasticism",
    "Thomas Aquinas",
    "Norse Mythology",
    "Anglo-Saxon poetry",
    "Finnish Mythology",
    "George MacDonald",
    "William Morris",
    "E.R. Eddison",
    "Francis Thompson"
  ],
  "member_since": null,
  "name": "J.R.R. Tolkien",
  "observed_at_ms": 1795288211104,
  "ratings_count": 12999441,
  "reviews_count": 294079,
  "top_books": [
    {
      "authors": [],
      "average_rating": 4.3,
      "book_id": 5907,
      "editions_count": 1450,
      "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1546071216i/5907._SY75_.jpg",
      "published_year": 1937,
      "ratings_count": 4673399,
      "title": "The Hobbit, or There and Back Again",
      "url": "https://www.goodreads.com/book/show/5907.The_Hobbit_or_There_and_Back_Again",
      "work_id": 1540236
    },
    {
      "authors": [],
      "average_rating": 4.41,
      "book_id": 61215351,
      "editions_count": 1082,
      "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1654215925i/61215351._SY75_.jpg",
      "published_year": 1954,
      "ratings_count": 3257674,
      "title": "The Fellowship of the Ring (The Lord of the Rings, #1)",
      "url": "https://www.goodreads.com/book/show/61215351-the-fellowship-of-the-ring",
      "work_id": 3204327
    },
    {
      "authors": [],
      "average_rating": 4.51,
      "book_id": 61215372,
      "editions_count": 890,
      "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1654216149i/61215372._SY75_.jpg",
      "published_year": 1954,
      "ratings_count": 1193819,
      "title": "The Two Towers (The Lord of the Rings, #2)",
      "url": "https://www.goodreads.com/book/show/61215372-the-two-towers",
      "work_id": 2963845
    }
  ],
  "url": "https://www.goodreads.com/author/show/656983.J_R_R_Tolkien",
  "website": "https://www.tolkienestate.com/"
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Author

- Capability: `books/author`
- Description: A Goodreads author page: name, photo, birth date and place, death date, website, genres, influences, the full biography, average rating across all works, ratings and reviews counts, number of distinct works, followers, and the author's ten most popular books with ratings.
- Instructions: Pass an author id or URL (book.authors[].author_id). For every book by the author use author_books; for their quotes use quotes with author.
- Cost: 5 credits per call
- Capability file: [Author](https://alexandria.firecrawl.dev/agents/providers/goodreads-com/books/author)

Accepted options:
- `author` (string, required): A Goodreads author id (`656983`, `656983.J_R_R_Tolkien`) or author URL. Example: `656983`

Response schema example:
```json
{
  "author_id": 656983,
  "average_rating": 4.38,
  "birthplace": "Bloemfontein, Mangaung, Free State, South Africa",
  "born": "1892-01-03",
  "description": "John Ronald Reuel Tolkien: writer, artist, scholar, linguist. Known to millions around the world as the author of\nThe Lord of the Rings\n, Tolkien spent most of his life teaching at the University of Oxford where he was a distinguished academic in the fields of Old and Middle English and Old Norse. His creativity, confined to his spare time, found its outlet in fantasy works, stories for children, poetry, illustration and invented languages and alphabets.\n\nTolkien’s most popular works, The Hobbit and The Lord of the Rings are set in Middle-earth, an imagined world with strangely familiar settin",
  "died": "1973-09-02",
  "distinct_works": 807,
  "followers_count": 80476,
  "genres": [
    "Fantasy",
    "Fiction",
    "Children's"
  ],
  "image_url": "https://images.gr-assets.com/authors/1795089990p5/656983.jpg",
  "influences": [
    "Traditional Catholicism",
    "Scholasticism",
    "Thomas Aquinas",
    "Norse Mythology",
    "Anglo-Saxon poetry",
    "Finnish Mythology",
    "George MacDonald",
    "William Morris",
    "E.R. Eddison",
    "Francis Thompson"
  ],
  "member_since": null,
  "name": "J.R.R. Tolkien",
  "observed_at_ms": 1795288211104,
  "ratings_count": 12999441,
  "reviews_count": 294079,
  "top_books": [
    {
      "authors": [],
      "average_rating": 4.3,
      "book_id": 5907,
      "editions_count": 1450,
      "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1546071216i/5907._SY75_.jpg",
      "published_year": 1937,
      "ratings_count": 4673399,
      "title": "The Hobbit, or There and Back Again",
      "url": "https://www.goodreads.com/book/show/5907.The_Hobbit_or_There_and_Back_Again",
      "work_id": 1540236
    },
    {
      "authors": [],
      "average_rating": 4.41,
      "book_id": 61215351,
      "editions_count": 1082,
      "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1654215925i/61215351._SY75_.jpg",
      "published_year": 1954,
      "ratings_count": 3257674,
      "title": "The Fellowship of the Ring (The Lord of the Rings, #1)",
      "url": "https://www.goodreads.com/book/show/61215351-the-fellowship-of-the-ring",
      "work_id": 3204327
    },
    {
      "authors": [],
      "average_rating": 4.51,
      "book_id": 61215372,
      "editions_count": 890,
      "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1654216149i/61215372._SY75_.jpg",
      "published_year": 1954,
      "ratings_count": 1193819,
      "title": "The Two Towers (The Lord of the Rings, #2)",
      "url": "https://www.goodreads.com/book/show/61215372-the-two-towers",
      "work_id": 2963845
    }
  ],
  "url": "https://www.goodreads.com/author/show/656983.J_R_R_Tolkien",
  "website": "https://www.tolkienestate.com/"
}
```

### Author books

- Capability: `books/author_books`
- Description: Every distinct work by a Goodreads author, 30 per page, sorted by popularity, original publication year, title, average rating or page count: book id, title, URL, cover, co-authors, average rating, ratings count, publication year, editions count and work id.
- Instructions: An author's full bibliography with ratings. Page with `page` (`next_page`); `last_page` is the final page number.
- Cost: 5 credits per call
- Capability file: [Author books](https://alexandria.firecrawl.dev/agents/providers/goodreads-com/books/author_books)

Accepted options:
- `author` (string, required): A Goodreads author id or author URL (/author/show/ or /author/list/). Example: `<author>`
- `page` (number): 1-based page; pass `next_page` from the previous call. Example: `10`
- `sort` (string): Default popularity. Example: `popularity`

Response schema example:
```json
{
  "author_id": 656983,
  "books": [
    {
      "authors": [
        {
          "author_id": 656983,
          "name": "J.R.R. Tolkien",
          "url": "https://www.goodreads.com/author/show/656983.J_R_R_Tolkien"
        }
      ],
      "average_rating": 4.3,
      "book_id": 5907,
      "editions_count": 1450,
      "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1546071216i/5907._SY75_.jpg",
      "published_year": 1937,
      "ratings_count": 4673550,
      "title": "The Hobbit, or There and Back Again",
      "url": "https://www.goodreads.com/book/show/5907.The_Hobbit_or_There_and_Back_Again",
      "work_id": 1540236
    },
    {
      "authors": [
        {
          "author_id": 656983,
          "name": "J.R.R. Tolkien",
          "url": "https://www.goodreads.com/author/show/656983.J_R_R_Tolkien"
        }
      ],
      "average_rating": 4.41,
      "book_id": 61215351,
      "editions_count": 1082,
      "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1654215925i/61215351._SY75_.jpg",
      "published_year": 1954,
      "ratings_count": 3257751,
      "title": "The Fellowship of the Ring (The Lord of the Rings, #1)",
      "url": "https://www.goodreads.com/book/show/61215351-the-fellowship-of-the-ring",
      "work_id": 3204327
    },
    {
      "authors": [
        {
          "author_id": 656983,
          "name": "J.R.R. Tolkien",
          "url": "https://www.goodreads.com/author/show/656983.J_R_R_Tolkien"
        }
      ],
      "average_rating": 4.51,
      "book_id": 61215372,
      "editions_count": 890,
      "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1654216149i/61215372._SY75_.jpg",
      "published_year": 1954,
      "ratings_count": 1193880,
      "title": "The Two Towers (The Lord of the Rings, #2)",
      "url": "https://www.goodreads.com/book/show/61215372-the-two-towers",
      "work_id": 2963845
    },
    {
      "authors": [
        {
          "author_id": 656983,
          "name": "J.R.R. Tolkien",
          "url": "https://www.goodreads.com/author/show/656983.J_R_R_Tolkien"
        }
      ],
      "average_rating": 4.59,
      "book_id": 61215384,
      "editions_count": 913,
      "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1654216226i/61215384._SY75_.jpg",
      "published_year": 1955,
      "ratings_count": 1100911,
      "title": "The Return of the King (The Lord of the Rings, #3)",
      "url": "https://www.goodreads.com/book/show/61215384-the-return-of-the-king",
      "work_id": 2964424
    },
    {
      "authors": [
        {
          "author_id": 656983,
          "name": "J.R.R. Tolkien",
          "url": "https://www.goodreads.com/author/show/656983.J_R_R_Tolkien"
        }
      ],
      "average_rating": 4.55,
      "book_id": 33,
      "editions_count": 930,
      "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1566425108i/33._SX50_.jpg",
      "published_year": 1955,
      "ratings_count": 754098,
      "title": "The Lord of the Rings (The Lord of the Rings, #1-3)",
      "url": "https://www.goodreads.com/book/show/33.The_Lord_of_the_Rings",
      "work_id": 3462456
    }
  ],
  "last_page": 27,
  "name": "J.R.R. Tolkien",
  "next_page": 2,
  "observed_at_ms": 1795288217553,
  "page": 1,
  "sort": "popularity",
  "url": "https://www.goodreads.com/author/list/656983"
}
```

### Book

- Capability: `books/book`
- Description: One Goodreads book by id, URL or ISBN: title, full description, cover, authors and contributors with roles, series and position, genres, format, pages, publisher, publication date, language, ISBN-10/ISBN-13/ASIN, the work (original title, first publication date, Goodreads work id), the community rating with its 5-to-1 star distribution and text review count, review counts per language, currently-reading and want-to-read counts, quote/question/discussion counts, literary awards, characters and settings.
- Instructions: Ratings, genres, series and identifiers for one book. For the review texts use book_reviews; for quotes use quotes; for other books in the series use series.
- Cost: 5 credits per call
- Capability file: [Book](https://alexandria.firecrawl.dev/agents/providers/goodreads-com/books/book)

Accepted options:
- `book` (string, required): A Goodreads book id (`5907`, `5907.The_Hobbit`), a book URL (`https://www.goodreads.com/book/show/5907.The_Hobbit`, `/book/isbn/<isbn>`) or an ISBN-10/ISBN-13 (Goodreads resolves an ISBN to that edition's page). Example: `5907`

Response schema example:
```json
{
  "asin": "B0DN8P5BQF",
  "authors": [
    {
      "author_id": 656983,
      "name": "J.R.R. Tolkien",
      "role": "Author",
      "url": "https://www.goodreads.com/author/show/656983.J_R_R_Tolkien"
    },
    {
      "author_id": 1582,
      "name": "Douglas A. Anderson",
      "role": "Editor",
      "url": "https://www.goodreads.com/author/show/1582.Douglas_A_Anderson"
    },
    {
      "author_id": 13290,
      "name": "Michael Hague",
      "role": "Illustrator",
      "url": "https://www.goodreads.com/author/show/13290.Michael_Hague"
    },
    {
      "author_id": 6971179,
      "name": "Jemima Catlin",
      "role": "Illustrator",
      "url": "https://www.goodreads.com/author/show/6971179.Jemima_Catlin"
    }
  ],
  "awards": [
    {
      "category": null,
      "designation": "WINNER",
      "name": "Keith Barker Millennium Book Award",
      "url": "https://www.goodreads.com/award/show/3054-keith-barker-millennium-book-award",
      "year": 2000
    },
    {
      "category": "Older Readers",
      "designation": "WINNER",
      "name": "Books I Loved Best Yearly (BILBY) Awards",
      "url": "https://www.goodreads.com/award/show/3803-books-i-loved-best-yearly-bilby-awards",
      "year": 1997
    },
    {
      "category": "Inklings Studies",
      "designation": "WINNER",
      "name": "Mythopoeic Scholarship Award",
      "url": "https://www.goodreads.com/award/show/10079-mythopoeic-scholarship-award",
      "year": 1990
    }
  ],
  "book_id": 5907,
  "characters": [
    {
      "name": "Gandalf",
      "url": "https://www.goodreads.com/characters/17-gandalf"
    },
    {
      "name": "Bilbo Baggins",
      "url": "https://www.goodreads.com/characters/459-bilbo-baggins"
    },
    {
      "name": "Thorin Oakenshield",
      "url": "https://www.goodreads.com/characters/460-thorin-oakenshield"
    },
    {
      "name": "Smaug",
      "url": "https://www.goodreads.com/characters/461-smaug"
    },
    {
      "name": "Elrond Half-elven",
      "url": "https://www.goodreads.com/characters/1023-elrond-half-elven"
    },
    {
      "name": "Gollum",
      "url": "https://www.goodreads.com/characters/22987-gollum"
    },
    {
      "name": "Dwalin",
      "url": "https://www.goodreads.com/characters/32561-dwalin"
    },
    {
      "name": "Balin",
      "url": "https://www.goodreads.com/characters/32562-balin"
    },
    {
      "name": "Kili",
      "url": "https://www.goodreads.com/characters/32563-kili"
    },
    {
      "name": "Fili",
      "url": "https://www.goodreads.com/characters/32564-fili"
    },
    {
      "name": "Dori",
      "url": "https://www.goodreads.com/characters/32565-dori"
    },
    {
      "name": "Ori",
      "url": "https://www.goodreads.com/characters/32566-ori"
    },
    {
      "name": "Nori",
      "url": "https://www.goodreads.com/characters/32567-nori"
    },
    {
      "name": "Oin",
      "url": "https://www.goodreads.com/characters/32568-oin"
    },
    {
      "name": "Gloin",
      "url": "https://www.goodreads.com/characters/32569-gloin"
    },
    {
      "name": "Bifur",
      "url": "https://www.goodreads.com/characters/32570-bifur"
    },
    {
      "name": "Bofur",
      "url": "https://www.goodreads.com/characters/32571-bofur"
    },
    {
      "name": "Bombur",
      "url": "https://www.goodreads.com/characters/32572-bombur"
    },
    {
      "name": "Beorn",
      "url": "https://www.goodreads.com/characters/32573-beorn"
    },
    {
      "name": "Bard the Bowman",
      "url": "https://www.goodreads.com/characters/32574-bard-the-bowman"
    }
  ],
  "currently_reading_count": 120051,
  "description": "In a hole in the ground there lived a hobbit. Not a nasty, dirty, wet hole, filled with the ends of worms and an oozy smell, nor yet a dry, bare, sandy hole with nothing in it to sit down on or to eat: it was a hobbit-hole, and that means comfort.\nWritten for J.R.R. Tolkien’s own children, The Hobbit met with instant critical acclaim when it was first published in 1937. Now recognized as a timeless classic, this introduction to the hobbit Bilbo Baggins, the wizard Gandalf, Gollum, and the spectacular world of Middle-earth recounts of the adventures of a reluctant hero, a powerful and dangerous",
  "discussions_count": 848,
  "discussions_url": "https://www.goodreads.com/topic/list_book/5907",
  "format": "Paperback",
  "genres": [
    "Fantasy",
    "Classics",
    "Fiction",
    "Adventure",
    "Young Adult",
    "Audiobook",
    "High Fantasy",
    "Science Fiction Fantasy",
    "Dragons",
    "Novels"
  ],
  "image_url": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1546071216i/5907.jpg",
  "isbn": null,
  "isbn13": null,
  "language": "English",
  "observed_at_ms": 1795288198216,
  "pages": 366,
  "places": [],
  "published_date": "2002-08-15",
  "publisher": "Houghton Mifflin",
  "questions_count": 116,
  "questions_url": "https://www.goodreads.com/book/5907/questions",
  "quotes_count": 935,
  "quotes_url": "https://www.goodreads.com/work/quotes/1540236",
  "rating": {
    "average": 4.3,
    "count": 4673561,
    "distribution": [
      {
        "count": 2534419,
        "percent": 54.2,
        "stars": 5
      },
      {
        "count": 1348366,
        "percent": 28.9,
        "stars": 4
      },
      {
        "count": 548802,
        "percent": 11.7,
        "stars": 3
      },
      {
        "count": 146813,
        "percent": 3.1,
        "stars": 2
      },
      {
        "count": 95161,
        "percent": 2,
        "stars": 1
      }
    ],
    "text_reviews_count": 96569
  },
  "review_languages": [
    {
      "count": 80986,
      "language": "en"
    },
    {
      "count": 3819,
      "language": "es"
    },
    {
      "count": 1041,
      "language": "pt"
    },
    {
      "count": 875,
      "language": "it"
    },
    {
      "count": 750,
      "language": "pl"
    },
    {
      "count": 488,
      "language": "de"
    },
    {
      "count": 480,
      "language": "fr"
    },
    {
      "count": 410,
      "language": "nl"
    },
    {
      "count": 248,
      "language": "tr"
    },
    {
      "count": 225,
      "language": "fa"
    }
  ],
  "series": [
    {
      "position": "1",
      "series_id": 66175,
      "title": "Middle Earth",
      "url": "https://www.goodreads.com/series/66175-middle-earth"
    }
  ],
  "title": "The Hobbit, or There and Back Again",
  "title_complete": "The Hobbit, or There and Back Again",
  "url": "https://www.goodreads.com/book/show/5907.The_Hobbit_or_There_and_Back_Again",
  "want_to_read_count": 1408710,
  "work": {
    "editions_url": "https://www.goodreads.com/work/editions/1540236",
    "first_published_date": "1937-09-21",
    "original_title": "The Hobbit",
    "url": "https://www.goodreads.com/work/1540236-the-hobbit",
    "work_id": 1540236
  }
}
```

### Book reviews

- Capability: `books/book_reviews`
- Description: Community reviews of a Goodreads book (all editions of the work), with full text, star rating, created and updated time, like and comment counts, spoiler flag, the reviewer's shelf and tags, and the reviewer (id, name, profile URL, review and follower counts). Sort by Goodreads' default order, newest or oldest; filter by star rating, review language or words in the text; page with `cursor`. `total_count` is the number of reviews matching the filters.
- Instructions: What readers say about a book beyond the average rating. Pass `next_cursor` back as `cursor` with the same book, sort and filters to continue.
- Cost: 5 credits per call
- Capability file: [Book reviews](https://alexandria.firecrawl.dev/agents/providers/goodreads-com/books/book_reviews)

Accepted options:
- `book` (string, required): A Goodreads book id (`5907`, `5907.The_Hobbit`), a book URL (`https://www.goodreads.com/book/show/5907.The_Hobbit`, `/book/isbn/<isbn>`) or an ISBN-10/ISBN-13 (Goodreads resolves an ISBN to that edition's page). Example: `5907`
- `cursor` (string): `next_cursor` from the previous page (only valid with the same book, sort and filters). Example: `next_cursor`
- `language` (string): Only reviews in this language (ISO 639-1 code such as en, es, de). Example: `<language>`
- `limit` (number): Reviews per page, default 30. Example: `10`
- `rating` (number): Only reviews with this many stars. Example: `5`
- `search` (string): Only reviews whose text contains these words. Example: `<search>`
- `sort` (string): default (Goodreads' community order, as on the book page), newest or oldest. Example: `default`

Response schema example:
```json
{
  "book_id": 5907,
  "language": null,
  "next_cursor": "5907.default.all.all.811c9dc5~MTU0MDEsMTY4Nzk4ODA3Mjc3Mw",
  "observed_at_ms": 1795288205083,
  "rating": null,
  "reviews": [
    {
      "comment_count": 155,
      "created_at": "2008-11-05T15:18:37Z",
      "like_count": 930,
      "rating": 5,
      "review_id": "36953286",
      "reviewer": {
        "followers_count": 121539,
        "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/users/1291462190i/1526851._UX200_CR0,50,200,200_.jpg",
        "is_author": false,
        "name": "Will Byrnes",
        "reviews_count": 1373,
        "url": "https://www.goodreads.com/user/show/1526851-will-byrnes",
        "user_id": 1526851
      },
      "shelf": "read",
      "spoiler": false,
      "tags": [
        "all-time-favorites-fiction",
        "young-adult",
        "fiction",
        "literary-fiction"
      ],
      "text": "In a hole in the ground there lived a hobbit.\nBooks exist in time and place and our experience of them is affected by the specific time and place in which we encounter them. Sometimes an uplifting or inspiring book can change the path of a life that has wandered onto a wrong course. Sometimes a book, discovered early on, can form part of the foundation of who we are. Or, discovered late, can offer insight into the journey we have taken to date. Sometimes a book is just a book. But not The Hobbit. Not for me. In January, 2013, I pulled out my forty-year old copy in anticipation of seeing the re",
      "updated_at": "2026-10-23T05:36:45Z",
      "url": "https://www.goodreads.com/review/show/36953286"
    },
    {
      "comment_count": 150,
      "created_at": "2008-06-02T13:08:23Z",
      "like_count": 2022,
      "rating": 5,
      "review_id": "23503181",
      "reviewer": {
        "followers_count": 829,
        "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/users/1216068593i/1205220.jpg",
        "is_author": false,
        "name": "Matt",
        "reviews_count": 227,
        "url": "https://www.goodreads.com/user/show/1205220-matt",
        "user_id": 1205220
      },
      "shelf": "read",
      "spoiler": false,
      "tags": [
        "childrens",
        "fantasy"
      ],
      "text": "Some books are almost impossible to review. If a book is bad, how easily can we dwell on its flaws! But if the book is good, how do you give any recommendation that is equal the book? Unless you are an author of equal worth to the one whose work you review, what powers of prose and observation are you likely to have to fitly adorn the work?\n\n'The Hobbit' is at one level simply a charming adventure story, perhaps one of the most charming and most adventurous ever told. There, see how simple that was? If you haven't read it, you should, because it is quite enjoyable. At some level, there is litt",
      "updated_at": "2022-08-29T14:15:55Z",
      "url": "https://www.goodreads.com/review/show/23503181"
    },
    {
      "comment_count": 61,
      "created_at": "2018-12-29T20:26:55Z",
      "like_count": 1085,
      "rating": 5,
      "review_id": "2179524029",
      "reviewer": {
        "followers_count": 165428,
        "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/users/1764349531i/71848701._UX200_CR0,4,200,200_.jpg",
        "is_author": false,
        "name": "Miranda Reads",
        "reviews_count": 2387,
        "url": "https://www.goodreads.com/user/show/71848701-miranda-reads",
        "user_id": 71848701
      },
      "shelf": "read",
      "spoiler": false,
      "tags": [
        "audiobook",
        "childrens-literature"
      ],
      "text": "\"In a hole in the ground there lived a hobbit.\"\n\nBilbo Baggins, living comfortably in his hobbit-hole in Bag End, finds himself on the wrong end of an adventure.\n\nGandalf the Grey has come recruiting for a burglar willing to raid the home of Smaug (a dragon) whose taken over the ancestral home of the dwarves.\n\nThese dwarves, who number thirteen, are deeply suspicious and are unwilling to proceed unless their number is rounded up. Evil is afoot and they refuse to ignore common sense (aka superstition).\n\nGandalf soon finds that persuading Bilbo ends up a quest in and of itself!\n\n'I am looking fo",
      "updated_at": "2025-12-26T05:17:09Z",
      "url": "https://www.goodreads.com/review/show/2179524029"
    }
  ],
  "search": null,
  "sort": "default",
  "title": "The Hobbit, or There and Back Again",
  "total_count": 96246,
  "url": "https://www.goodreads.com/book/show/5907.The_Hobbit_or_There_and_Back_Again",
  "work_id": 1540236
}
```

### Choice awards

- Capability: `books/choice_awards`
- Description: The Goodreads Choice Awards. With `year`: every category of that year with its winner (book id, title, cover). With `category`: that category's nominees with vote counts (once results are published), the winner with its votes and blurb, and the total votes.
- Instructions: Readers' book-of-the-year picks by genre. Call with `year` (default last year) to list categories, then with a returned `category` slug for the full nominee list.
- Cost: 5 credits per call
- Capability file: [Choice awards](https://alexandria.firecrawl.dev/agents/providers/goodreads-com/books/choice_awards)

Accepted options:
- `category` (string): A category slug from the year listing (`readers-favorite-fiction-books-2024`) or its URL. Example: `readers-favorite-fiction-books-2024`
- `year` (number): Award year; default last year. Ignored when `category` is given. Example: `2009`

Response schema example:
```json
{
  "categories": [
    {
      "category": "readers-favorite-fiction-books-2024",
      "name": "Fiction",
      "url": "https://www.goodreads.com/choiceawards/readers-favorite-fiction-books-2024",
      "winner": {
        "book_id": 198902277,
        "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1759683499l/198902277._SY475_.jpg",
        "title": "The Wedding People",
        "url": "https://www.goodreads.com/book/show/198902277"
      }
    },
    {
      "category": "readers-favorite-historical-fiction-books-2024",
      "name": "Historical Fiction",
      "url": "https://www.goodreads.com/choiceawards/readers-favorite-historical-fiction-books-2024",
      "winner": {
        "book_id": 127305853,
        "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1733493019l/127305853._SY475_.jpg",
        "title": "The Women",
        "url": "https://www.goodreads.com/book/show/127305853"
      }
    },
    {
      "category": "readers-favorite-mystery-thriller-books-2024",
      "name": "Mystery & Thriller",
      "url": "https://www.goodreads.com/choiceawards/readers-favorite-mystery-thriller-books-2024",
      "winner": {
        "book_id": 199700434,
        "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1717970585l/199700434._SY475_.jpg",
        "title": "The God of the Woods",
        "url": "https://www.goodreads.com/book/show/199700434"
      }
    },
    {
      "category": "readers-favorite-romance-books-2024",
      "name": "Romance",
      "url": "https://www.goodreads.com/choiceawards/readers-favorite-romance-books-2024",
      "winner": {
        "book_id": 194803835,
        "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1717213921l/194803835._SY475_.jpg",
        "title": "Funny Story",
        "url": "https://www.goodreads.com/book/show/194803835"
      }
    },
    {
      "category": "readers-favorite-romantasy-books-2024",
      "name": "Romantasy",
      "url": "https://www.goodreads.com/choiceawards/readers-favorite-romantasy-books-2024",
      "winner": {
        "book_id": 123211531,
        "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1689843639l/123211531._SY475_.jpg",
        "title": "House of Flame and Shadow (Crescent City, #3)",
        "url": "https://www.goodreads.com/book/show/123211531"
      }
    },
    {
      "category": "readers-favorite-fantasy-books-2024",
      "name": "Fantasy",
      "url": "https://www.goodreads.com/choiceawards/readers-favorite-fantasy-books-2024",
      "winner": {
        "book_id": 199347538,
        "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1752528282l/199347538._SY475_.jpg",
        "title": "Somewhere Beyond the Sea (Cerulean Chronicles, #2)",
        "url": "https://www.goodreads.com/book/show/199347538"
      }
    },
    {
      "category": "readers-favorite-science-fiction-books-2024",
      "name": "Science Fiction",
      "url": "https://www.goodreads.com/choiceawards/readers-favorite-science-fiction-books-2024",
      "winner": {
        "book_id": 199798179,
        "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1716480921l/199798179._SY475_.jpg",
        "title": "The Ministry of Time",
        "url": "https://www.goodreads.com/book/show/199798179"
      }
    },
    {
      "category": "readers-favorite-horror-books-2024",
      "name": "Horror",
      "url": "https://www.goodreads.com/choiceawards/readers-favorite-horror-books-2024",
      "winner": {
        "book_id": 201242757,
        "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1699311050l/201242757._SY475_.jpg",
        "title": "You Like It Darker",
        "url": "https://www.goodreads.com/book/show/201242757"
      }
    },
    {
      "category": "readers-favorite-debut-novel-2024",
      "name": "Debut Novel",
      "url": "https://www.goodreads.com/choiceawards/readers-favorite-debut-novel-2024",
      "winner": {
        "book_id": 212432167,
        "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1714579180l/212432167._SY475_.jpg",
        "title": "How to End a Love Story",
        "url": "https://www.goodreads.com/book/show/212432167"
      }
    },
    {
      "category": "readers-favorite-audio-books-2024",
      "name": "Audiobook",
      "url": "https://www.goodreads.com/choiceawards/readers-favorite-audio-books-2024",
      "winner": null
    },
    {
      "category": "readers-favorite-ya-fantasy-books-2024",
      "name": "Young Adult Fantasy",
      "url": "https://www.goodreads.com/choiceawards/readers-favorite-ya-fantasy-books-2024",
      "winner": {
        "book_id": 127280062,
        "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1684911482l/127280062.jpg",
        "title": "Ruthless Vows (Letters of Enchantment, #2)",
        "url": "https://www.goodreads.com/book/show/127280062"
      }
    },
    {
      "category": "readers-favorite-ya-fiction-books-2024",
      "name": "Young Adult Fiction",
      "url": "https://www.goodreads.com/choiceawards/readers-favorite-ya-fiction-books-2024",
      "winner": {
        "book_id": 125045190,
        "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1695915526l/125045190._SY475_.jpg",
        "title": "Heartstopper: Volume Five (Heartstopper, #5)",
        "url": "https://www.goodreads.com/book/show/125045190"
      }
    },
    {
      "category": "readers-favorite-nonfiction-books-2024",
      "name": "Nonfiction",
      "url": "https://www.goodreads.com/choiceawards/readers-favorite-nonfiction-books-2024",
      "winner": {
        "book_id": 171681821,
        "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1711573377l/171681821._SY475_.jpg",
        "title": "The Anxious Generation: How the Great Rewiring of Childhood Caused an Epidemic of Mental Illness",
        "url": "https://www.goodreads.com/book/show/171681821"
      }
    },
    {
      "category": "readers-favorite-memoir-books-2024",
      "name": "Memoir",
      "url": "https://www.goodreads.com/choiceawards/readers-favorite-memoir-books-2024",
      "winner": {
        "book_id": 207298106,
        "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1758744253l/207298106._SY475_.jpg",
        "title": "The Third Gilmore Girl: A Memoir",
        "url": "https://www.goodreads.com/book/show/207298106"
      }
    },
    {
      "category": "readers-favorite-history-bio-books-2024",
      "name": "History & Biography",
      "url": "https://www.goodreads.com/choiceawards/readers-favorite-history-bio-books-2024",
      "winner": {
        "book_id": 201751300,
        "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1705935887l/201751300._SY475_.jpg",
        "title": "The Bookshop: A History of the American Bookstore",
        "url": "https://www.goodreads.com/book/show/201751300"
      }
    }
  ],
  "observed_at_ms": 1795288244294,
  "url": "https://www.goodreads.com/choiceawards/best-books-2024",
  "year": 2024
}
```

### List books

- Capability: `books/list_books`
- Description: A Goodreads Listopia list: name, description, books and voters counts, likes, creation date, creator and tags, plus up to 100 books per page in rank order with score, votes, average rating, ratings count, authors and cover.
- Instructions: Community-voted book lists such as 'Best Books Ever' (list 1). Pass a list id or URL; page with `page` (`next_page`).
- Cost: 5 credits per call
- Capability file: [List books](https://alexandria.firecrawl.dev/agents/providers/goodreads-com/books/list_books)

Accepted options:
- `list` (string, required): A Listopia list id (`1`, `1.Best_Books_Ever`) or list URL. Example: `1`
- `page` (number): 1-based page; pass `next_page` from the previous call. Example: `10`

Response schema example:
```json
{
  "books": [
    {
      "authors": [
        {
          "author_id": 153394,
          "name": "Suzanne Collins",
          "url": "https://www.goodreads.com/author/show/153394.Suzanne_Collins"
        }
      ],
      "average_rating": 4.36,
      "book_id": 2767052,
      "editions_count": null,
      "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1586722975i/2767052._SX50_.jpg",
      "published_year": null,
      "rank": 1,
      "ratings_count": 10375140,
      "score": 4589580,
      "title": "The Hunger Games (The Hunger Games, #1)",
      "url": "https://www.goodreads.com/book/show/2767052-the-hunger-games",
      "votes": 46634,
      "work_id": null
    },
    {
      "authors": [
        {
          "author_id": 1265,
          "name": "Jane Austen",
          "url": "https://www.goodreads.com/author/show/1265.Jane_Austen"
        }
      ],
      "average_rating": 4.3,
      "book_id": 1885,
      "editions_count": null,
      "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1320399351i/1885._SY75_.jpg",
      "published_year": null,
      "rank": 2,
      "ratings_count": 5057767,
      "score": 3106416,
      "title": "Pride and Prejudice",
      "url": "https://www.goodreads.com/book/show/1885.Pride_and_Prejudice",
      "votes": 31815,
      "work_id": null
    },
    {
      "authors": [
        {
          "author_id": 1825,
          "name": "Harper Lee",
          "url": "https://www.goodreads.com/author/show/1825.Harper_Lee"
        }
      ],
      "average_rating": 4.26,
      "book_id": 2657,
      "editions_count": null,
      "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1553383690i/2657._SY75_.jpg",
      "published_year": null,
      "rank": 3,
      "ratings_count": 7174932,
      "score": 2688388,
      "title": "To Kill a Mockingbird",
      "url": "https://www.goodreads.com/book/show/2657.To_Kill_a_Mockingbird",
      "votes": 27447,
      "work_id": null
    },
    {
      "authors": [
        {
          "author_id": 1077326,
          "name": "J.K. Rowling",
          "url": "https://www.goodreads.com/author/show/1077326.J_K_Rowling"
        }
      ],
      "average_rating": 4.5,
      "book_id": 2,
      "editions_count": null,
      "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1794292347i/2._SX50_.jpg",
      "published_year": null,
      "rank": 4,
      "ratings_count": 3966530,
      "score": 2400577,
      "title": "Harry Potter and the Order of the Phoenix (Harry Potter, #5)",
      "url": "https://www.goodreads.com/book/show/2.Harry_Potter_and_the_Order_of_the_Phoenix",
      "votes": 26800,
      "work_id": null
    },
    {
      "authors": [
        {
          "author_id": 11466,
          "name": "Markus Zusak",
          "url": "https://www.goodreads.com/author/show/11466.Markus_Zusak"
        }
      ],
      "average_rating": 4.39,
      "book_id": 19063,
      "editions_count": null,
      "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1522157426i/19063._SY75_.jpg",
      "published_year": null,
      "rank": 5,
      "ratings_count": 3001915,
      "score": 2037309,
      "title": "The Book Thief",
      "url": "https://www.goodreads.com/book/show/19063.The_Book_Thief",
      "votes": 20918,
      "work_id": null
    }
  ],
  "books_count": 80322,
  "created": "May 13th, 2008",
  "creator": {
    "name": "Michael Economy",
    "url": "https://www.goodreads.com/user/show/73-michael-economy",
    "user_id": 73
  },
  "description": "The best books ever, as voted on by the general Goodreads community.\n\nNote to librarians: do not edit this list's description.",
  "likes_count": 10772,
  "list_id": 1,
  "name": "Best Books Ever",
  "next_page": 2,
  "observed_at_ms": 1795288238773,
  "page": 1,
  "tags": [
    "best",
    "earliest-list",
    "favorites",
    "favourites",
    "fiction",
    "writer"
  ],
  "url": "https://www.goodreads.com/list/show/1.Best_Books_Ever",
  "voters_count": 299341
}
```

### Quotes

- Capability: `books/quotes`
- Description: Quotes from a Goodreads book (all editions) or by an author, 30 per page, most liked first: quote id and URL, full text, attributed author, source book with work id, tags and like count, plus the total number of quotes.
- Instructions: Pass exactly one of `book` (id, URL or ISBN) or `author` (id or URL). Page with `page` (`next_page`).
- Cost: 5 credits per call
- Capability file: [Quotes](https://alexandria.firecrawl.dev/agents/providers/goodreads-com/books/quotes)

Accepted options:
- `author` (string): A Goodreads author id or author URL. Example: `<author>`
- `book` (string): A Goodreads book id (`5907`, `5907.The_Hobbit`), a book URL (`https://www.goodreads.com/book/show/5907.The_Hobbit`, `/book/isbn/<isbn>`) or an ISBN-10/ISBN-13 (Goodreads resolves an ISBN to that edition's page). Example: `5907`
- `page` (number): 1-based page; pass `next_page` from the previous call. Example: `10`

Response schema example:
```json
{
  "book_id": 5907,
  "next_page": 2,
  "observed_at_ms": 1795288229636,
  "page": 1,
  "quotes": [
    {
      "author": "J.R.R. Tolkien",
      "book": {
        "title": "The Hobbit, or There and Back Again",
        "url": "https://www.goodreads.com/work/quotes/1540236",
        "work_id": 1540236
      },
      "like_count": 4627,
      "quote_id": 180531,
      "tags": [
        "humor",
        "semantics",
        "suspicion"
      ],
      "text": "Do you wish me a good morning, or mean that it is a good morning whether I want it or not; or that you feel good this morning; or that it is a morning to be good on?",
      "url": "https://www.goodreads.com/quotes/180531-do-you-wish-me-a-good-morning-or-mean-that"
    },
    {
      "author": "J.R.R. Tolkien",
      "book": {
        "title": "The Hobbit, or There and Back Again",
        "url": "https://www.goodreads.com/work/quotes/1540236",
        "work_id": 1540236
      },
      "like_count": 2699,
      "quote_id": 207055,
      "tags": [],
      "text": "There is nothing like looking, if you want to find something. You certainly usually find something, if you look, but it is not always quite the something you were after.",
      "url": "https://www.goodreads.com/quotes/207055-there-is-nothing-like-looking-if-you-want-to-find"
    },
    {
      "author": "J.R.R. Tolkien",
      "book": {
        "title": "The Hobbit, or There and Back Again",
        "url": "https://www.goodreads.com/work/quotes/1540236",
        "work_id": 1540236
      },
      "like_count": 2259,
      "quote_id": 39915,
      "tags": [
        "first-sentence",
        "opening-lines"
      ],
      "text": "In a hole in the ground there lived a hobbit.",
      "url": "https://www.goodreads.com/quotes/39915-in-a-hole-in-the-ground-there-lived-a-hobbit"
    },
    {
      "author": "J.R.R. Tolkien",
      "book": {
        "title": "The Hobbit, or There and Back Again",
        "url": "https://www.goodreads.com/work/quotes/1540236",
        "work_id": 1540236
      },
      "like_count": 2001,
      "quote_id": 176747,
      "tags": [
        "dwarves",
        "poetry",
        "song"
      ],
      "text": "Far over the misty mountains cold\nTo dungeons deep and caverns old\nWe must away ere break of day\nTo seek the pale enchanted gold.\nThe dwarves of yore made mighty spells,\nWhile hammers fell like ringing bells\nIn places deep, where dark things sleep,\nIn hollow halls beneath the fells.\nFor ancient king and elvish lord\nThere many a gleaming golden hoard\nThey shaped and wrought, and light they caught\nTo hide in gems on hilt of sword.\nOn silver necklaces they strung\nThe flowering stars, on crowns they hung\nThe dragon-fire, in twisted wire\nThey meshed the light of moon and sun.\nFar over the misty mou",
      "url": "https://www.goodreads.com/quotes/176747-far-over-the-misty-mountains-cold-to-dungeons-deep-and"
    },
    {
      "author": "J.R.R. Tolkien",
      "book": {
        "title": "The Hobbit, or There and Back Again",
        "url": "https://www.goodreads.com/work/quotes/1540236",
        "work_id": 1540236
      },
      "like_count": 1886,
      "quote_id": 248896,
      "tags": [],
      "text": "So comes snow after fire, and even dragons have their endings.",
      "url": "https://www.goodreads.com/quotes/248896-so-comes-snow-after-fire-and-even-dragons-have-their"
    }
  ],
  "title": "The Hobbit, or There and Back Again",
  "total_count": 935,
  "type": "book",
  "url": "https://www.goodreads.com/work/quotes/1540236-the-hobbit"
}
```

### Search books

- Capability: `books/search_books`
- Description: Search Goodreads books by title, author or ISBN: 20 results per page with Goodreads book id, title, URL, cover, authors, average rating, ratings count, first publication year, editions count and work id. An exact ISBN returns that edition as the single result; an unknown query returns an empty list.
- Instructions: Find the Goodreads book id for a title or author before calling book, book_reviews or quotes. Page with `page` (`next_page`).
- Cost: 5 credits per call
- Capability file: [Search books](https://alexandria.firecrawl.dev/agents/providers/goodreads-com/books/search_books)

Accepted options:
- `page` (number): 1-based page; pass `next_page` from the previous call. Example: `10`
- `query` (string, required): Title, author name or ISBN. Example: `<query>`

Response schema example:
```json
{
  "next_page": 2,
  "observed_at_ms": 1795288174492,
  "page": 1,
  "query": "the hobbit",
  "results": [
    {
      "authors": [
        {
          "author_id": 656983,
          "name": "J.R.R. Tolkien",
          "url": "https://www.goodreads.com/author/show/656983.J_R_R_Tolkien"
        },
        {
          "author_id": 1582,
          "name": "Douglas A. Anderson",
          "url": "https://www.goodreads.com/author/show/1582.Douglas_A_Anderson"
        },
        {
          "author_id": 13290,
          "name": "Michael Hague",
          "url": "https://www.goodreads.com/author/show/13290.Michael_Hague"
        },
        {
          "author_id": 6971179,
          "name": "Jemima Catlin",
          "url": "https://www.goodreads.com/author/show/6971179.Jemima_Catlin"
        }
      ],
      "average_rating": 4.3,
      "book_id": 5907,
      "editions_count": 1450,
      "image_url": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1546071216i/5907.jpg",
      "published_year": 2002,
      "ratings_count": 4673530,
      "title": "The Hobbit, or There and Back Again",
      "url": "https://www.goodreads.com/book/show/5907.The_Hobbit_or_There_and_Back_Again",
      "work_id": 1540236
    },
    {
      "authors": [
        {
          "author_id": 656983,
          "name": "J.R.R. Tolkien",
          "url": "https://www.goodreads.com/author/show/656983.J_R_R_Tolkien"
        },
        {
          "author_id": 70032,
          "name": "David Wyatt",
          "url": "https://www.goodreads.com/author/show/70032.David_Wyatt"
        }
      ],
      "average_rating": 4.32,
      "book_id": 17157681,
      "editions_count": 6,
      "image_url": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1371834025i/17157681.jpg",
      "published_year": 2012,
      "ratings_count": 387029,
      "title": "The Hobbit, Part One",
      "url": "https://www.goodreads.com/book/show/17157681-the-hobbit-part-one",
      "work_id": 59418655
    },
    {
      "authors": [
        {
          "author_id": 28709,
          "name": "Chuck Dixon",
          "url": "https://www.goodreads.com/author/show/28709.Chuck_Dixon"
        },
        {
          "author_id": 42156,
          "name": "David Wenzel",
          "url": "https://www.goodreads.com/author/show/42156.David_Wenzel"
        },
        {
          "author_id": 150123,
          "name": "Sean Deming",
          "url": "https://www.goodreads.com/author/show/150123.Sean_Deming"
        },
        {
          "author_id": 656983,
          "name": "J.R.R. Tolkien",
          "url": "https://www.goodreads.com/author/show/656983.J_R_R_Tolkien"
        }
      ],
      "average_rating": 4.51,
      "book_id": 659469,
      "editions_count": 76,
      "image_url": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1374681632i/659469.jpg",
      "published_year": 1990,
      "ratings_count": 284185,
      "title": "The Hobbit",
      "url": "https://www.goodreads.com/book/show/659469.The_Hobbit",
      "work_id": 16998382
    },
    {
      "authors": [
        {
          "author_id": 42158,
          "name": "John D. Rateliff",
          "url": "https://www.goodreads.com/author/show/42158.John_D_Rateliff"
        }
      ],
      "average_rating": 3.81,
      "book_id": 1081560,
      "editions_count": 3,
      "image_url": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1388670262i/1081560.jpg",
      "published_year": 2007,
      "ratings_count": 104836,
      "title": "The History of the Hobbit, Part One: Mr. Baggins",
      "url": "https://www.goodreads.com/book/show/1081560.The_History_of_the_Hobbit_Part_One",
      "work_id": 1068303
    },
    {
      "authors": [
        {
          "author_id": 656983,
          "name": "J.R.R. Tolkien",
          "url": "https://www.goodreads.com/author/show/656983.J_R_R_Tolkien"
        }
      ],
      "average_rating": 4.62,
      "book_id": 30,
      "editions_count": 197,
      "image_url": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1656625315i/30.jpg",
      "published_year": 2012,
      "ratings_count": 148179,
      "title": "J.R.R. Tolkien 4-Book Boxed Set: The Hobbit and The Lord of the Rings",
      "url": "https://www.goodreads.com/book/show/30.J_R_R_Tolkien_4_Book_Boxed_Set",
      "work_id": 89369
    }
  ],
  "total_results": 1435
}
```

### Series

- Capability: `books/series`
- Description: A Goodreads series: title, description, primary and total work counts, and the books in series order with their position label (1, 2, 0.5, 1-3), id, title, URL, cover, author, average rating, ratings and text review counts, pages, publication year, editions count, work id and description.
- Instructions: Reading order and ratings across a series. Pass a series id or URL (book.series[].series_id).
- Cost: 5 credits per call
- Capability file: [Series](https://alexandria.firecrawl.dev/agents/providers/goodreads-com/books/series)

Accepted options:
- `series` (string, required): A Goodreads series id (`66175`, `66175-middle-earth`) or series URL. Example: `66175`

Response schema example:
```json
{
  "books": [
    {
      "author": {
        "author_id": 656983,
        "name": "J.R.R. Tolkien",
        "url": "https://www.goodreads.com/author/show/656983.J_R_R_Tolkien"
      },
      "average_rating": 4.05,
      "book_id": 7332,
      "description": "The Silmarillion is an account of the Elder Days, of the First Age of Tolkien’s world. It is the ancient drama to which the characters in The Lord of the Rings look back, and in whose events some of them such as Elrond and Galadriel took part. The tales of The Silmarillion are set in an age when Morgoth, the first Dark Lord, dwelt in Middle-Earth, and the High Elves made war upon him for the recovery of the Silmarils, the jewels containing the pure light of Valinor.",
      "editions_count": 650,
      "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1610045590i/7332._SX120_.jpg",
      "pages": 386,
      "position": "0.5",
      "published_year": 1977,
      "ratings_count": 353098,
      "text_reviews_count": 17721,
      "title": "The Silmarillion",
      "url": "https://www.goodreads.com/book/show/7332.The_Silmarillion",
      "work_id": 4733799
    },
    {
      "author": {
        "author_id": 656983,
        "name": "J.R.R. Tolkien",
        "url": "https://www.goodreads.com/author/show/656983.J_R_R_Tolkien"
      },
      "average_rating": 4.3,
      "book_id": 5907,
      "description": "In a hole in the ground there lived a hobbit. Not a nasty, dirty, wet hole, filled with the ends of worms and an oozy smell, nor yet a dry, bare, sandy hole with nothing in it to sit down on or to eat: it was a hobbit-hole, and that means comfort.\nWritten for J.R.R. Tolkien’s own children, The Hobbit met with instant critical acclaim when it was first published in 1937. Now recognized as a timeless classic, this introduction to the hobbit Bilbo Baggins, the wizard Gandalf, Gollum, and the spectacular world of Middle-earth recounts of the adventures of a reluctant hero, a powerful and dangerous",
      "editions_count": 1450,
      "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1546071216i/5907._SY180_.jpg",
      "pages": 366,
      "position": "1",
      "published_year": 1937,
      "ratings_count": 4673550,
      "text_reviews_count": 96569,
      "title": "The Hobbit, or There and Back Again",
      "url": "https://www.goodreads.com/book/show/5907.The_Hobbit_or_There_and_Back_Again",
      "work_id": 1540236
    },
    {
      "author": {
        "author_id": 656983,
        "name": "J.R.R. Tolkien",
        "url": "https://www.goodreads.com/author/show/656983.J_R_R_Tolkien"
      },
      "average_rating": 3.81,
      "book_id": 35736,
      "description": "This adventure book tells of Tom's encounters with the River-woman's beautiful daughter, Old Man Willow, the Badger-folk, the ghostly Barrowwight, a lovely princess, trolls, dwarves, and legendary beasts. A delightful volume of 16 songs, rhymes and poems from the acclaimed The Hobbit. Illustrated.",
      "editions_count": 96,
      "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1285548992i/35736._SX120_.jpg",
      "pages": 75,
      "position": "1.5",
      "published_year": 1962,
      "ratings_count": 12371,
      "text_reviews_count": 979,
      "title": "The Adventures of Tom Bombadil",
      "url": "https://www.goodreads.com/book/show/35736.The_Adventures_of_Tom_Bombadil",
      "work_id": 2963754
    },
    {
      "author": {
        "author_id": 656983,
        "name": "J.R.R. Tolkien",
        "url": "https://www.goodreads.com/author/show/656983.J_R_R_Tolkien"
      },
      "average_rating": 4.41,
      "book_id": 61215351,
      "description": "Sauron, the Dark Lord, has gathered to him all the Rings of Power – the means by which he intends to rule Middle-earth. All he lacks in his plans for dominion is the One Ring – the ring that rules them all – which has fallen into the hands of the hobbit, Bilbo Baggins.\n\nIn a sleepy village in the Shire, young Frodo Baggins finds himself faced with an immense task, as his elderly cousin Bilbo entrusts the Ring to his care. Frodo must leave his home and make a perilous journey across Middle-earth to the Cracks of Doom, there to destroy the Ring and foil the Dark Lord in his evil purpose.",
      "editions_count": 1082,
      "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1654215925i/61215351._SY180_.jpg",
      "pages": 432,
      "position": "2",
      "published_year": 1954,
      "ratings_count": 3257751,
      "text_reviews_count": 59762,
      "title": "The Fellowship of the Ring (The Lord of the Rings, #1)",
      "url": "https://www.goodreads.com/book/show/61215351-the-fellowship-of-the-ring",
      "work_id": 3204327
    },
    {
      "author": {
        "author_id": 656983,
        "name": "J.R.R. Tolkien",
        "url": "https://www.goodreads.com/author/show/656983.J_R_R_Tolkien"
      },
      "average_rating": 4.51,
      "book_id": 61215372,
      "description": "Begin your journey into Middle-earth.\n\nThe inspiration for the upcoming original series on Prime Video, The Lord of the Rings: The Rings of Power.\n\nThe Two Towers is the second part of J.R.R. Tolkien’s epic adventure The Lord of the Rings.\n\nOne Ring to rule them all, One Ring to find them, One Ring to bring them all and in the darkness bind them.\n\nFrodo and his Companions of the Ring have been beset by danger during their quest to prevent the Ruling Ring from falling into the hands of the Dark Lord by destroying it in the Cracks of Doom. They have lost the wizard, Gandalf, in a battle in the M",
      "editions_count": 890,
      "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1654216149i/61215372._SY180_.jpg",
      "pages": 448,
      "position": "3",
      "published_year": 1954,
      "ratings_count": 1193880,
      "text_reviews_count": 30158,
      "title": "The Two Towers (The Lord of the Rings, #2)",
      "url": "https://www.goodreads.com/book/show/61215372-the-two-towers",
      "work_id": 2963845
    },
    {
      "author": {
        "author_id": 656983,
        "name": "J.R.R. Tolkien",
        "url": "https://www.goodreads.com/author/show/656983.J_R_R_Tolkien"
      },
      "average_rating": 4.59,
      "book_id": 61215384,
      "description": "The Return of the King is the third part of J.R.R. Tolkien’s epic adventure The Lord of the Rings.\n\nOne Ring to rule them all, One Ring to find them, One Ring to bring them all and in the darkness bind them.\n\nThe Dark Lord has risen, and as he unleashes hordes of Orcs to conquer all Middle-earth, Frodo and Sam struggle deep into his realm in Mordor.\n\nTo defeat Sauron, the One Ring must be destroyed in the fires of Mount Doom. But the way is impossibly hard, and Frodo is weakening. The Ring corrupts all who bear it and Frodo’s time is running out.\n\nWill Sam and Frodo succeed, or will the Dark L",
      "editions_count": 913,
      "image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1654216226i/61215384._SY180_.jpg",
      "pages": 432,
      "position": "4",
      "published_year": 1955,
      "ratings_count": 1100911,
      "text_reviews_count": 28854,
      "title": "The Return of the King (The Lord of the Rings, #3)",
      "url": "https://www.goodreads.com/book/show/61215384-the-return-of-the-king",
      "work_id": 2964424
    }
  ],
  "description": "See also:\n* Unfinished Tales\n* The History of Middle-Earth\n\nThe Lord of the Rings is an epic high fantasy trilogy written by English philologist and University of Oxford professor J.R.R. Tolkien. The story began as a sequel to Tolkien's earlier, less complex children's fantasy novel The Hobbit (1937), but eventually developed into a much larger work which formed the basis for the extended Middle-Earth Universe. It was written in stages between 1937 and 1949, much of it during World War II. It is the third best-selling novel ever written, with over 150 million copies sold.\n\nAlso known as:\n* El ",
  "observed_at_ms": 1795288225044,
  "primary_works_count": 4,
  "series_id": 66175,
  "title": "Middle Earth Series",
  "total_works_count": 17,
  "url": "https://www.goodreads.com/series/66175"
}
```
