Motivation: Trying to bring some semblance of order and usability to the Goodreads API by wrapping it with GraphQL and treating the original REST API as a datasource.
Feel free to use it, fork it, or play with it alongside your Goodreads REST queries. Do let me know any suggestions to improve or problems that creep up.
-
author queries
https://www.goodreads.com/api/author_url/{author_name}?key={api_key}
-
authorData queries
https://www.goodreads.com/author/show/{author_id}?format=xml&?key={api_key}
. USAGE: Get the Author ID from previous call -
bookData calls
https://www.goodreads.com/book/show/{book_id}?format=xml?key={api_key}
USAGE: Book ID can be found in previous call -
groupsByName calls
https://www.goodreads.com/group/search.xml?key={api_key}&q={search_query}
. Returns an array of groups based on the Query string.
USAGE: Group names have dashes as delimeter like goodreads-librarians-group. However, just type "goodreads librarians group" as the search query -
groupData NOTE: A lot of the nested
author
objects have values like this:user_id: { type: 'integer', nil: true }
. These, I just returnnull