Goodreads
Read thousands of book reviews by your friends and other Goodreads members, keep a virtual bookshelf of what you've read, and build your to-read list as you discover great books on the website.Goodreads is a free service for everyone who reads. We have more than 35 million members who have added more than 1 billion books.
Goodreads endpoints
| Method | Endpoint | Description |
|---|---|---|
| POST |
addBookToShelf /addBookToShelf |
Add a book to a shelf. |
| POST |
GetlistopiasByBookId /GetlistopiasByBookId |
Get the listopia lists for a given book.Version of list/book. |
| POST |
addBooksToMultipleShelves /addBooksToMultipleShelves |
Add a list of books to many current user's shelves. |
| POST |
addFriend /addFriend |
Sends a friend request to a user. You'll need to register your app (required). |
| POST |
addOwnedBook /addOwnedBook |
Adds a book to user's list of owned books.You'll need to register your app (required). |
| POST |
addQuote /addQuote |
If you don't specify an author_id, it will try to look one up based on the author_name you provide. You'll need to register your app (required). |
| POST |
compareBooksWithMember /compareBooksWithMember |
Get a response with stats comparing your books to another member's. |
| POST |
confirmFriendRequest /confirmFriendRequest |
Confirm a friend request for the current user. You'll need to register your app (required). |
| POST |
createBookShelf /createBookShelf |
Add book shelves for members. |
| POST |
createComment /createComment |
Creates a new comment. You'll need to register your app (required). |
| POST |
createReview /createReview |
Add book reviews for members. You'll need to register your app (required). |
| POST |
createTopic /createTopic |
Create a new topic. |
| POST |
declineFriendRequest /declineFriendRequest |
Decline a friend request for the current user. You'll need to register your app (required). |
| POST |
deleteOwnedBook /deleteOwnedBook |
Deletes a book a user owns. You'll need to register your app (required). |
| POST |
deleteUserStatus /deleteUserStatus |
Delete status updates for members. |
| POST |
followAnAuthor /followAnAuthor |
Make the signed-in user follow an author. |
| POST |
followUser /followUser |
Start following a user. You'll need to register your app (required). |
| POST |
getAccessCredentials /getAccessCredentials |
Get Access Credentials (accessToken/accessTokenSecret), after getRequestToken use `/oauth/authorize` url. |
| POST |
getAllEditionsByWork /getAllEditionsByWork |
List of all the available editions of a particular work. This API requires extra permission. |
| POST |
getAllRecentReviews /getAllRecentReviews |
Get a response with the most recently added reviews from all members. |
| POST |
getAuthorBooks /getAuthorBooks |
Get a response with a paginated list of an authors books. |
| POST |
getAuthorByName /getAuthorByName |
Get an response with the Goodreads url for the given author name. |
| POST |
getAuthorFollowingInformation /getAuthorFollowingInformation |
Get a response describing the association between a user and an author. |
| POST |
getAuthorInfo /getAuthorInfo |
Get a response with info about an author. |
| POST |
getAuthorizedUser /getAuthorizedUser |
Get an response with the Goodreads user_id for the user who authorized access. |
| POST |
getBookIdByISBNs /getBookIdByISBNs |
Get Goodreads book IDs given one or more ISBNs. Response contains IDs without any markup. |
| POST |
getBookReview /getBookReview |
Get a response that contains embed code for the iframe reviews widget. The reviews widget shows an excerpt (first 300 characters) of the most popular reviews of a book for a… |
| POST |
getBookReviewsByISBN /getBookReviewsByISBN |
Get a response that contains embed code for the iframe reviews widget that shows excerpts (first 300 characters) of the most popular reviews of a book for a given ISBN. The… |
| POST |
getListOwnedBooksByUserId /getListOwnedBooksByUserId |
List books owned by a user. |
| POST |
getBookReviewsByTitle /getBookReviewsByTitle |
Get a response that contains embed code for the iframe reviews widget, which shows an excerpt (first 300 characters) of the most popular reviews of a book for a given… |
| POST |
getBooksByMultipleFields /getBooksByMultipleFields |
Get a response with the most popular books for the given query. This will search all books in the title/author/ISBN fields and show matches, sorted by popularity on Goodreads.… |
| POST |
getBooksOnMembersShelf /getBooksOnMembersShelf |
Get the books on a members shelf. Customize the feed with the below variables. Viewing members with profiles who have set them as visible to members only or just their friends. |
| POST |
getCommentsList /getCommentsList |
Creates a new comment. You'll need to register your app (required). |
| POST |
getCurrentUsersNotifications /getCurrentUsersNotifications |
Viewing any new notifications here will mark them as `viewed`. |
| POST |
getEventsInYourArea /getEventsInYourArea |
Shows events nearby the authenticating user or you can get a list of events near a location by passing lat/lng coordinates. |
| POST |
getFriendRequests /getFriendRequests |
Returns a response with the current user's friend requests. You'll need to register your app (required). |
| POST |
getFriendUpdates /getFriendUpdates |
Get your friend updates (the same data you see on your homepage). |
| POST |
getGroup /getGroup |
Get info about a group by id. |
| POST |
getGroupBySearchQuery /getGroupBySearchQuery |
Search group titles and descriptions for the given string. |
| POST |
getGroupMembers /getGroupMembers |
Returns a response list of members of the group. |
| POST |
getListTopicsByGroupFolder /getListTopicsByGroupFolder |
Returns a list of topics in a group's folder specified either by group id. |
| POST |
getMember /getMember |
Get a response with the public information about the given Goodreads user. |
| POST |
getOwnedBooks /getOwnedBooks |
List books owned by a user. |
| POST |
getPeopleUserIsFollowing /getPeopleUserIsFollowing |
Get a response with people the given user is following. |
| POST |
getRecommendation /getRecommendation |
Get information about a particular recommendation that one user made for another. Includes comments and likes. You'll need to register your app (required). |
| POST |
getRequestToken /getRequestToken |
Get Request Token. |
| POST |
getReview /getReview |
Get a response that contains the review and rating. |
| POST |
getReviewStatisticsByISBNs /getReviewStatisticsByISBNs |
Get review statistics for books given a list of ISBNs.You can mix ISBN10s and ISBN13s, but you'll receive a 422 error if you don't specify any, and you'll receive a 404 if none… |
| POST |
getSeries /getSeries |
Info on a series. |
| POST |
getSeriesByAuthorId /getSeriesByAuthorId |
List of all series by an author. |
Goodreads pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — | — |