Goodreads Scraper API

API Documentation

API Status: Operational

Changelog

All notable changes to the Goodreads Scraper API are documented here. We follow Semantic Versioning.

1.0.0

Latest
April 25, 2024
Added
  • Initial public release of the Goodreads Scraper API
  • Core endpoints:
    • /api/lists - Get book lists by category, genre, or popularity
    • /api/book/details/:slug - Get detailed information about a specific book
    • /api/authors/:id - Get detailed information about an author
    • /api/search - Search for books by title, author, or ISBN
    • /api/users/:username/shelves - Get a user's bookshelves and their books
    • /api/book/details/:slug/reviews - Get reviews for a specific book
    • /api/quotes - Get quotes from a book or by an author
  • API key authentication system
  • Rate limiting (1,000 requests per day for free tier)
  • Comprehensive documentation
  • Official JavaScript and Python client libraries

0.9.0

Beta
March 15, 2024
Added
  • Beta release for selected partners
  • Added /api/quotes endpoint for retrieving book and author quotes
  • Implemented pagination for all list-based endpoints
  • Added sorting options for reviews and search results
  • Expanded book details to include series information
  • Added similar books recommendations to book details
Changed
  • Improved error handling with detailed error messages
  • Enhanced rate limiting with better header information
  • Optimized response times for all endpoints
Fixed
  • Fixed UTF-8 encoding issues with non-English book titles and author names
  • Resolved inconsistencies in date formatting across endpoints
  • Fixed search functionality to properly handle special characters

0.8.0

Alpha
February 10, 2024
Added
  • Alpha release for internal testing
  • Implemented core endpoints:
    • /api/book/details/:slug
    • /api/authors/:id
    • /api/search
    • /api/lists
  • Basic authentication system
  • Simple rate limiting
  • Initial documentation
Known Issues
  • Inconsistent date formatting across endpoints
  • Limited error handling
  • Performance issues with large result sets
  • No pagination for list-based endpoints

Upcoming Changes

Planned for v1.1.0
Coming Soon
Expected release: May 2024
  • New endpoint: /api/genres - Get detailed information about book genres
  • New endpoint: /api/series/:id - Get detailed information about book series
  • Enhanced filtering options for search endpoint
  • Expanded author details with more biographical information
  • Support for bulk operations to reduce API calls
Planned for v1.2.0
Expected release: July 2024
  • GraphQL API support alongside REST
  • WebSocket support for real-time updates
  • OAuth2 authentication option
  • Enhanced analytics for API usage
  • Improved caching mechanisms
Breaking Changes in v2.0.0
Expected release: Q3 2024
  • The response format will be standardized across all endpoints
  • Some fields will be renamed for consistency
  • Authentication will require API keys to be passed in headers only (query parameters will be deprecated)
  • Rate limits will be adjusted based on usage patterns

Legacy Versions Support

VersionSupport StatusEnd-of-Life Date
1.0.xFull SupportTBD
0.9.xSecurity Updates OnlyOctober 25, 2024
0.8.xNo SupportApril 25, 2024

For migration guides and assistance, please contact support@goodreads-scraper.com.