> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/goodreads/search>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/goodreads/search.mdx>

---

# Goodreads Book Search API

The best matching books for a title, author or ISBN.

`GET /v1/goodreads/search?query=` returns the books that best match a title, an author or an ISBN, best first: `id`, `workId`, `title`, `titleWithoutSeries`, `url`, `cover`, `authors`, `pages`, `averageRating`, `ratingsCount`, `rank` and the opening of the `description`. Use the `id` with the book, reviews and editions routes. An empty `books` array means nothing matched.

## Request

- **Endpoint:** `GET /v1/goodreads/search`
- **Credits:** 1 credit
Failed requests are free
A not-found answer is still charged
- **Input:** by query
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/goodreads/search/get)
- **Platform page:** [/platforms/goodreads](https://www.socialfetch.dev/platforms/goodreads)

## FAQ

### How many results does a search return?

The top matches only, typically 5 to 10. It is meant to find the right book id, not to page through a catalogue.

### Can I search by ISBN?

Yes. Send the ISBN-10 or ISBN-13 as query; the edition it names comes back first when the site knows it.

### How many credits does a call cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.

### Does search work in other scripts?

Yes. Titles in Japanese, Cyrillic or any other script are searched as sent.
