Read one Goodreads book page. Pass the numeric id from search, or a /book/show/ URL. The response is a flat book record. 44767458 is Dune by Frank Herbert, the same id and title as the first dune search card.
The search card stores an abbreviated ratings floor. This endpoint stores the exact ratings_count and reviews_count printed on the book page.
GET https://api.piloterr.com/v2/goodreads/book?query=44767458
GET https://api.piloterr.com/v2/goodreads/book?query=https://www.goodreads.com/book/show/44767458
GET and POST take the same query. The Dune record includes ISBN 9780593099322, 658 pages, format Hardcover, and series Dune #1.
| Parameter |
Required |
Example |
query |
yes |
44767458 |
query is required. A bare integer is the book id. A URL must be on goodreads.com and contain /book/show/. A title, a search URL, or another host returns 400.
| Field |
Type |
Meaning |
id |
string |
Book id from the URL, such as 44767458 |
title |
string |
Title |
url |
string |
Canonical /book/show/{id} URL |
series |
string or null |
Series link text, such as Dune #1 |
authors |
array of strings |
Authors. Dune lists Frank Herbert |
rating |
number or null |
Average rating |
ratings_count |
number or null |
Exact rating count from the book page |
reviews_count |
number or null |
Exact review count |
image |
string or null |
Cover |
book_format |
string or null |
Format, such as Hardcover |
pages |
number or null |
Page count |
language |
string or null |
Language |
isbn |
string or null |
ISBN |
genres |
array of strings |
Genre buttons on the page |
published |
string or null |
First published date when the page prints First published ... |
awards |
array |
Award lines. Empty array when none are present |
description |
string or null |
Description text, with a trailing "more" control removed |
There is no results wrapper. The series string on this page can differ from the search card for the same id.
- Store ISBN
9780593099322, 658 pages, and Hardcover for a catalog row keyed by 44767458.
- Keep the exact rating count from the book page after a search card stored the abbreviated floor
1700000.
- Read genres and the Hugo and Nebula award lines printed for Dune.
| Code |
Meaning |
400 |
Empty query, a non-numeric token, or a domain outside goodreads.com |
401 |
Missing API key |
404 |
No book page for that id |
500 |
The fetch failed |
Goodreads Search
