Goodreads Search
GET
Search Goodreads books by keyword. pagination.next is a Goodreads search URL for the following page.
Credit cost: 2 credits per call
ApiKeyAuthheader
x-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringRequired. A book keyword, or a Goodreads search URL (the path contains /search or the query contains q=).
Example:
duneURL example:
https://www.goodreads.com/search?q=dune&page=2page?numberOptional. Page number, starting at 1. Omitted or blank uses page 1. A value below 1 returns 400. When query is already a Goodreads search URL, this number replaces the page parameter in that URL.
Example:
2Default
"1"Successful response
application/json- response
results?array<>pagination?curl -X GET 'https://api.piloterr.com/v2/goodreads/search?query=string'Example Response
{ "results": [ { "id": "44767458", "url": "https://www.goodreads.com/book/show/44767458", "image": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1555447414i/44767458.jpg", "title": "Dune", "rating": 4.29, "series": "Dune (Series #1)", "authors": [ "Frank Herbert" ], "ratings_count": 1700000, "reviews_count": 90400 } ], "pagination": { "next": "https://www.goodreads.com/search?q=dune&page=2", "page": 1, "per_page": 20, "total_pages": 100, "total_results": null }}