# Goodreads API: Get book > Gets one Goodreads book's details, reader ratings and edition information. The book can be a title, an ISBN or a book link; a title uses the best search match. Unofficial. Not affiliated with or endorsed by Goodreads. - Page: https://fous.com/methods/goodreads.com/get-book - Method: `goodreads.com/get_book`, version 1 - Website: goodreads.com - Returns: title, authors, ratings, rating breakdown, description, genres, pages, format, first published date, series, ISBN-13, awards, cover, link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `book` | string | yes | `"9780735211292"` | Book title, ISBN, or Goodreads book link, for example Atomic Habits. | | `author` | string | no | `""` | Author to distinguish books with similar titles, for example James Clear. Default "". | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "book": "9780735211292", "author": "" } ``` Its output: ```json { "title": "Atomic Habits: An Easy & Proven Way to Build Good Habits & Break Bad Ones", "awards": [ "Goodreads Choice Award — Nonfiction (Nominee)" ], "format": "Kindle Edition", "genres": [ "Self Help", "Nonfiction", "Psychology" ], "authors": [ "James Clear" ], "isbn_13": "9780735211292", "description": "The instant New York Times bestseller. Over 1 million copies sold! Tiny Changes, Remarkable Results No matter your goals, Atomic Habits offers a proven framework for improving--every day. James Clear, one of the world's leading experts on habit formation, reveals practical strategies that will teach…", "series_name": null, "series_number": null, "average_rating": 4.3, "goodreads_link": "https://www.goodreads.com/book/show/59910150-atomic-habits", "number_of_pages": 306, "cover_image_link": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1736660900i/59910150.jpg", "rating_breakdown": { "1_stars": 15269, "2_stars": 37030, "3_stars": 177944, "4_stars": 476760, "5_stars": 734396 }, "goodreads_book_id": "59910150", "number_of_ratings": 1441399, "number_of_reviews": 84378, "first_published_date": "2018-10-18" } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"goodreads.com/get_book","input":{"book":"9780735211292","author":""}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Can you pull up the details for Atomic Habits by James Clear, including its rating breakdown and page count? - I need the ISBN-13, format, and first publication date for The Name of the Wind by Patrick Rothfuss. - What are the reader ratings and genres for the book with ISBN 9780143127741 on Goodreads? - Find me the series information and description for Dune by Frank Herbert. - Look up The Hobbit, the edition with the cover image and awards, and tell me how many pages it has. ## Input schema ```json { "type": "object", "required": [ "book" ], "properties": { "book": { "type": "string", "minLength": 1, "description": "Book title, ISBN, or Goodreads book link, for example Atomic Habits." }, "author": { "type": "string", "default": "", "description": "Author to distinguish books with similar titles, for example James Clear." } } } ``` ## Output schema ```json { "type": "object", "required": [ "title", "authors", "rating_breakdown", "genres", "awards", "goodreads_link", "goodreads_book_id" ], "properties": { "title": { "type": "string" }, "awards": { "type": "array", "items": { "type": "string" } }, "format": { "type": [ "string", "null" ] }, "genres": { "type": "array", "items": { "type": "string" } }, "authors": { "type": "array", "items": { "type": "string" } }, "isbn_13": { "type": [ "string", "null" ] }, "description": { "type": [ "string", "null" ] }, "series_name": { "type": [ "string", "null" ] }, "series_number": { "type": [ "string", "null" ] }, "average_rating": { "type": [ "number", "null" ] }, "goodreads_link": { "type": "string" }, "number_of_pages": { "type": [ "integer", "null" ] }, "cover_image_link": { "type": [ "string", "null" ] }, "rating_breakdown": { "type": "object", "properties": { "1_stars": { "type": [ "integer", "null" ] }, "2_stars": { "type": [ "integer", "null" ] }, "3_stars": { "type": [ "integer", "null" ] }, "4_stars": { "type": [ "integer", "null" ] }, "5_stars": { "type": [ "integer", "null" ] } } }, "goodreads_book_id": { "type": "string" }, "number_of_ratings": { "type": [ "integer", "null" ] }, "number_of_reviews": { "type": [ "integer", "null" ] }, "first_published_date": { "type": [ "string", "null" ] } } } ``` ## See more - [Google API: Get book](https://fous.com/methods/books.google.com/get-book.md): Looks up a Google Books book by title or ISBN. Returns its details, reader ratings and the Google Play ebook offer in a chosen country. - [Audible API: Get audiobook details](https://fous.com/methods/audible.com/get-audiobook.md): Looks up an audiobook in an Audible store by title (optionally narrowed by author) or by Audible book link, and returns its details, narrators, length, rating, visitor price, series, publisher summary and whether that store's Plus Catalog includes it. - [Open Library API: Get book details](https://fous.com/methods/openlibrary.org/get-book.md): Gets a book's catalog details from Open Library by its title, with an optional author or ISBN to identify the right book. Reading availability reflects listed editions; details may be missing when the catalog has none. - [Google API: Search Google Books](https://fous.com/methods/books.google.com/search-books.md): Searches Google Books by words, author, subject or ISBN, with language, free-ebook and newest-first options. Ratings counts are not shown by the public book feed; newest sorts the available matches by publication date. - [Discogs API: Get release](https://fous.com/methods/discogs.com/get-release.md): Finds a Discogs release by title, artist or release link and returns its edition details, tracks, community counts, current price and sold price statistics. - [IMDb API: Get movie or show](https://fous.com/methods/imdb.com/get-movie-or-show.md): Gets a movie or TV show's IMDb details from its name, IMDb title link or title ID; a year picks between titles with the same name. Unavailable details are null. - [Project Gutenberg API: Get book text](https://fous.com/methods/gutenberg.org/get-book-text.md): Gets the plain text of a public-domain Project Gutenberg book by title, optionally matching its author and language. Chooses the most downloaded matching edition with a plain-text file, removes the Gutenberg header and license, and can cut the text after a chosen number of words. - [Project Gutenberg API: Search free books](https://fous.com/methods/gutenberg.org/search-free-books.md): Finds free public-domain Project Gutenberg books by title, author or topic, with authors, languages, subjects, recent downloads, and reading and download links. Public-domain status is based on the United States.