similar-scraper

POST

https://biblioreads.eu.org/api/similar-scraper

POST

/api/similar-scraper

curl -X POST https://biblioreads.eu.org/api/similar-scraper \
     -H "Content-Type: application/json" \
     -d '{
  "bookID": "kca://book/amzn1.gr.book.v1.kUA9FFwWCuSBb-AdLEwsvQ"
}'

200Successful

{
  "status": "Received",
  "source": "https://github.com/nesaku/biblioreads",
  "scrapeURL": "https://www.goodreads.com/book/similar/",
  "books": [
    {
      "id": 1,
      "cover": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1388183826i/389627.jpg",
      "title": "Diary of a Wimpy Kid",
      "bookURL": "/book/show/389627.Diary_of_a_Wimpy_Kid",
      "rating": "3.98",
      "ratingsCount": 800815,
      "author": "Jeff Kinney"
    },
    {
      "id": 2,
      "cover": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1531595478i/6393631.jpg",
      "title": "Smile",
      "bookURL": "/book/show/6393631-smile",
      "rating": "4.22",
      "ratingsCount": 315373,
      "author": "Raina Telgemeier"
    },
    {
      "id": 3,
      "cover": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1618269830i/38709.jpg",
      "title": "Holes",
      "bookURL": "/book/show/38709.Holes",
      "rating": "4.02",
      "ratingsCount": 1384117,
      "author": "Louis Sachar"
    },
    {
      "id": 4,
      "cover": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1388793265i/39988.jpg",
      "title": "Matilda",
      "bookURL": "/book/show/39988.Matilda",
      "rating": "4.34",
      "ratingsCount": 1135008,
      "author": "Roald Dahl"
    },
    {
      "id": 5,
      "cover": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1628267712i/24178.jpg",
      "title": "Charlotte’s Web",
      "bookURL": "/book/show/24178.Charlotte_s_Web",
      "rating": "4.21",
      "ratingsCount": 2083240,
      "author": "E.B. White"
    },
    {
      "id": 6,
      "cover": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1689626520i/192566704.jpg",
      "title": "The Outsiders",
      "bookURL": "/book/show/192566704-the-outsiders",
      "rating": "4.15",
      "ratingsCount": 1657820,
      "author": "S.E. Hinton"
    },
    {
      "id": 7,
      "cover": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1424981397i/11594337.jpg",
      "title": "The One and Only Ivan",
      "bookURL": "/book/show/11594337-the-one-and-only-ivan",
      "rating": "4.27",
      "ratingsCount": 215205,
      "author": "Katherine Applegate"
    },
    {
      "id": 8,
      "cover": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1342493368i/3636.jpg",
      "title": "The Giver",
      "bookURL": "/book/show/3636.The_Giver",
      "rating": "4.12",
      "ratingsCount": 2865432,
      "author": "Lois Lowry"
    },
    {
      "id": 9,
      "cover": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1347602096i/6609765.jpg",
      "title": "Out of My Mind",
      "bookURL": "/book/show/6609765-out-of-my-mind",
      "rating": "4.34",
      "ratingsCount": 192441,
      "author": "Sharon M. Draper"
    },
    {
      "id": 10,
      "cover": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1436142804i/25856606.jpg",
      "title": "The Fault in Our Stars",
      "bookURL": "/book/show/25856606-the-fault-in-our-stars",
      "rating": "4.12",
      "ratingsCount": 5820291,
      "author": "John  Green"
    },
    {
      "id": 11,
      "cover": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1370064528i/6054449.jpg",
      "title": "Tales from a Not-So-Fabulous Life",
      "bookURL": "/book/show/6054449-tales-from-a-not-so-fabulous-life",
      "rating": "4.10",
      "ratingsCount": 120555,
      "author": "Rachel Renée Russell"
    },
    {
      "id": 12,
      "cover": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1630542426i/47281.jpg",
      "title": "Number the Stars",
      "bookURL": "/book/show/47281.Number_the_Stars",
      "rating": "4.20",
      "ratingsCount": 631185,
      "author": "Lois Lowry"
    },
    {
      "id": 13,
      "cover": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1636851138i/58651625.jpg",
      "title": "The Hate U Give",
      "bookURL": "/book/show/58651625-the-hate-u-give",
      "rating": "4.45",
      "ratingsCount": 1031644,
      "author": "Angie Thomas"
    },
    {
      "id": 14,
      "cover": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1330157763i/13436373.jpg",
      "title": "Drama",
      "bookURL": "/book/show/13436373-drama",
      "rating": "4.18",
      "ratingsCount": 164842,
      "author": "Raina Telgemeier"
    },
    {
      "id": 15,
      "cover": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1372086100i/15749186.jpg",
      "title": "To All the Boys I've Loved Before",
      "bookURL": "/book/show/15749186-to-all-the-boys-i-ve-loved-before",
      "rating": "4.04",
      "ratingsCount": 1085675,
      "author": "Jenny Han"
    },
    {
      "id": 16,
      "cover": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1459241080i/25903764.jpg",
      "title": "Ghosts",
      "bookURL": "/book/show/25903764-ghosts",
      "rating": "4.21",
      "ratingsCount": 159278,
      "author": "Raina Telgemeier"
    },
    {
      "id": 17,
      "cover": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1769901237i/370493.jpg",
      "title": "The Giving Tree",
      "bookURL": "/book/show/370493.The_Giving_Tree",
      "rating": "4.39",
      "ratingsCount": 1253486,
      "author": "Shel Silverstein"
    },
    {
      "id": 18,
      "cover": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1456871914i/357664.jpg",
      "title": "Because of Winn-Dixie",
      "bookURL": "/book/show/357664.Because_of_Winn_Dixie",
      "rating": "4.11",
      "ratingsCount": 283695,
      "author": "Kate DiCamillo"
    },
    {
      "id": 19,
      "cover": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1385297074i/50.jpg",
      "title": "Hatchet",
      "bookURL": "/book/show/50.Hatchet",
      "rating": "3.80",
      "ratingsCount": 460500,
      "author": "Gary Paulsen"
    },
    {
      "id": 20,
      "cover": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1402915678i/19547856.jpg",
      "title": "Simon vs. the Homo Sapiens Agenda",
      "bookURL": "/book/show/19547856-simon-vs-the-homo-sapiens-agenda",
      "rating": "4.13",
      "ratingsCount": 471229,
      "author": "Becky Albertalli"
    }
  ],
  "lastScraped": "2026-06-15T00:41:35Z"
}

Similar Scraper

Scrapes similar and related book recommendations from a Goodreads book page using a direct book URL. Returns structured information about books that Goodreads recommends as similar reads.

Request

Method: POST
URL: {{Instance Domain}}/api/similar-scraper

Headers

Key	Value	Description
Content-Type	application/json	Indicates the request body is JSON

Body

Field	Type	Required	Description
queryURL	string	Yes	The full Goodreads book page URL to scrape similar books from (e.g. `https://www.goodreads.com/book/show/5907`)

Example Body:

{
  "queryURL": "https://www.goodreads.com/book/show/5907"
}

Response

200 Success

Returns a JSON object containing a list of similar books scraped from the page.

{
  "status": "Received",
  "statusCode": 200,
  ...
}

Response Field Descriptions

Field	Type	Description
status	string	Human-readable status message
statusCode	number	HTTP status code of the response
similarBooks	array	List of similar/related books recommended on the page

Request

This endpoint expects an object.

bookIDstringRequired

legacyBookIDany or nullOptional

Response

statusstring

sourcestringformat: "uri"

scrapeURLstringformat: "uri"

bookslist of objects

lastScrapeddatetime