Introduction

View as Markdown

This collection contains the API endpoints for BiblioReads (learn more about BiblioReads by visiting the repo on GitHub).

This API provides structured access to book search results, author profiles, series information, reviews, quotes and more via simple POST requests with a Goodreads URL or identifier in the body.

All endpoints accept Content-Type: application/json and are available at the /api/* path of a specified instance. For example, https://yourinstance.example.com/api/book-scraper.

Please note that this is NOT an official API, and could change without notice.

Endpoints

EndpointNameDescription
POST /api/search/bookssearch-booksSearch for books by keyword using a Goodreads search URL
POST /api/book-scraperbook-scraperGet book details for a specific book
POST /api/reviews-scraperreviews-scraperFetch paginated reviews for a specific book
POST /api/similar-scrapersimilar-scraperGet a list of books similar to a given title
POST /api/author/infoauthor-scraperRetrieve profile information for an author
POST /api/author/booksauthor-books-scraperList all books published by a specific author
POST /api/series-scraperseries-scraperGet details and book order for a book series
POST /api/awards/winners-listwinners-listRetrieve the list of award-winning books for a given year/category
POST /api/awards/winner-pagewinner-pageGet full details for a specific award category winner page
POST /api/quotes/homequotes-homeScrape featured quotes from the Goodreads quotes home page
POST /api/quotes/slugquotes-searchSearch for quotes by tag or topic slug
POST /api/list-scraperlist-scraperScrape books from a Goodreads community reading list
POST /api/works/questionsquestions-scraperScrape community Q&A questions for a specific book
POST /api/works/quotesquotes-scraperScrape quotes associated with a specific book work