{"name":"goodreads","domain":"goodreads.com","baseUrl":"https://www.goodreads.com","displayName":"Goodreads","description":"Goodreads books, logged out: search, book details, an author's books, and community reviews. Explored and built by an agent with the api-anything skill (bench/explore).","notes":"No account is needed.\n\n- Numbers keep the page's format. `avgRating` is a string (`\"4.22\"`). `ratingsCount` is\n  `\"1,481,183 ratings\"` in `getBook`, `\"1,481,180\"` in `authorBooks` and a number in `searchBooks`.\n- Page 1 only: 5 search results, 30 of an author's books, the first reviews.\n- On a new install, the first `getReviews` call opens the page in Chrome once (about 6 s) to pick up\n  a site-wide API key. Later calls are plain HTTP.","operations":[{"hash":"2c4cc00f2bb7ff29f633c95eb4479c52346b898a2e9d1541458b0fa3e92dabf6","status":"live","confirmations":0,"operation":{"name":"authorBooks","description":"An author's books (first page, up to 30): bookId, title, avgRating, ratingsCount.","request":{"method":"GET","url":"https://www.goodreads.com/author/list/%7BauthorId%7D","headers":{"accept":"text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7","accept-language":"en-US,en;q=0.9","priority":"u=0, i","sec-ch-ua":"\"Google Chrome\";v=\"153\", \"Not_A Brand\";v=\"8\", \"Chromium\";v=\"153\"","sec-ch-ua-mobile":"?0","sec-ch-ua-platform":"\"macOS\"","sec-fetch-dest":"document","sec-fetch-mode":"navigate","sec-fetch-site":"none","sec-fetch-user":"?1","upgrade-insecure-requests":"1","user-agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/153.0.0.0 Safari/537.36"}},"slots":[{"param":"authorId","at":["path:2"]}],"volatile":[],"trigger":{"url":"https://www.goodreads.com/author/list/{authorId}"},"match":{"method":"GET","host":"www.goodreads.com","path":"/author/list/*"},"response":{"format":"html","contentType":"text/html; charset=utf-8","pick":["bookId=url~/show/(\\d+)","title","avgRating=minirating~([\\d.]+) avg","ratingsCount=minirating~([\\d,]+) rating"],"html":{"items":"table.tableList tr","fields":{"url":"a.bookTitle@href","title":"a.bookTitle span","minirating":"span.minirating"}}},"params":[{"name":"authorId","type":"string","required":true,"description":"Goodreads author id, from searchBooks (authorId)","example":"2687","pattern":"\\d+","hint":"a numeric Goodreads author id, e.g. 2687"}],"readOnly":true,"minTier":1,"learnedLoggedIn":false,"learnedAt":"2026-09-28T06:44:43.588Z"}},{"hash":"4179809bb1b417fbf9369018eec9cdd7c4c77239e258ac3760eb9599b83962a0","status":"live","confirmations":1,"successRate":1,"lastOkAt":"2026-10-29T07:01:09.609Z","operation":{"name":"getBook","description":"One book's page: title, author, authorUrl, avgRating, ratingsCount (\"1,481,183 ratings\"), pages (\"393 pages, Hardcover\"), firstPublished, genres (list) and description.","request":{"method":"GET","url":"https://www.goodreads.com/book/show/%7BbookId%7D","headers":{"upgrade-insecure-requests":"1","user-agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/153.0.0.0 Safari/537.36","sec-ch-ua":"\"Google Chrome\";v=\"153\", \"Not_A Brand\";v=\"8\", \"Chromium\";v=\"153\"","sec-ch-ua-mobile":"?0","sec-ch-ua-platform":"\"macOS\""}},"slots":[{"param":"bookId","at":["path:2"]}],"volatile":[],"trigger":{"url":"https://www.goodreads.com/book/show/{bookId}"},"match":{"method":"GET","host":"www.goodreads.com","path":"/book/show/*"},"response":{"format":"html","contentType":"text/html; charset=utf-8","html":{"items":"body","fields":{"title":"[data-testid=\"bookTitle\"]","author":"[data-testid=\"name\"]","authorUrl":".ContributorLink@href","avgRating":".RatingStatistics__rating","ratingsCount":"[data-testid=\"ratingsCount\"]","pages":"[data-testid=\"pagesFormat\"]","firstPublished":"[data-testid=\"publicationInfo\"]","genres":"all:[data-testid=\"genresList\"] a span.Button__labelItem","description":"[data-testid=\"description\"] span.Formatted"}}},"params":[{"name":"bookId","type":"string","required":true,"description":"Goodreads book id, from searchBooks","example":"77566","pattern":"\\d+","hint":"a numeric Goodreads book id, e.g. 35959740"}],"readOnly":true,"minTier":1,"learnedLoggedIn":false,"learnedAt":"2026-09-28T06:42:12.101Z"}},{"hash":"a14a4a61d243ecc35a6f0cceed80129699738240cd5b9be3fc6e850d642260e7","status":"live","confirmations":0,"operation":{"name":"getReviews","description":"Top community reviews of a work: reviewer, rating (1-5) and text (HTML). Long reviews make the result truncated after a few.","request":{"method":"POST","url":"https://kxbwmqov6jgg3daaamb744ycu4.appsync-api.us-east-1.amazonaws.com/graphql","headers":{"accept":"application/graphql-response+json,application/json;q=0.9","accept-language":"en-US,en;q=0.9","content-type":"application/json","origin":"https://www.goodreads.com","priority":"u=1, i","referer":"https://www.goodreads.com/","sec-ch-ua":"\"Google Chrome\";v=\"153\", \"Not_A Brand\";v=\"8\", \"Chromium\";v=\"153\"","sec-ch-ua-mobile":"?0","sec-ch-ua-platform":"\"macOS\"","sec-fetch-dest":"empty","sec-fetch-mode":"cors","sec-fetch-site":"cross-site","user-agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/153.0.0.0 Safari/537.36","x-api-key":""},"body":"{\"operationName\":\"getReviews\",\"variables\":{\"filters\":{\"resourceType\":\"WORK\",\"resourceId\":\"{workId}\"},\"pagination\":{\"limit\":30}},\"extensions\":{\"clientLibrary\":{\"name\":\"@apollo/client\",\"version\":\"4.1.6\"}},\"query\":\"query getReviews($filters: BookReviewsFilterInput!, $pagination: PaginationInput) {\\n  getReviews(filters: $filters, pagination: $pagination) {\\n    ...BookReviewsFragment\\n    __typename\\n  }\\n}\\n\\nfragment BookReviewsFragment on BookReviewsConnection {\\n  totalCount\\n  edges {\\n    node {\\n      ...ReviewCardFragment\\n      __typename\\n    }\\n    __typename\\n  }\\n  pageInfo {\\n    prevPageToken\\n    nextPageToken\\n    __typename\\n  }\\n  __typename\\n}\\n\\nfragment ReviewCardFragment on Review {\\n  __typename\\n  id\\n  creator {\\n    ...ReviewerProfileFragment\\n    __typename\\n  }\\n  recommendFor\\n  updatedAt\\n  createdAt\\n  spoilerStatus\\n  lastRevisionAt\\n  text\\n  rating\\n  preciseRating\\n  preReleaseBookSource\\n  shelving {\\n    creator {\\n      id\\n      __typename\\n    }\\n    book {\\n      id\\n      __typename\\n    }\\n    shelf {\\n      name\\n      displayName\\n      editable\\n      default\\n      actionType\\n      sortOrder\\n      webUrl\\n      __typename\\n    }\\n    taggings {\\n      tag {\\n        name\\n        webUrl\\n        __typename\\n      }\\n      __typename\\n    }\\n    webUrl\\n    __typename\\n  }\\n  likeCount\\n  viewerHasLiked\\n  commentCount\\n}\\n\\nfragment ReviewerProfileFragment on User {\\n  id: legacyId\\n  imageUrlSquare\\n  isAuthor\\n  ...SocialUserFragment\\n  textReviewsCount\\n  viewerRelationshipStatus {\\n    isBlockedByViewer\\n    __typename\\n  }\\n  name\\n  webUrl\\n  contributor {\\n    id\\n    works {\\n      totalCount\\n      __typename\\n    }\\n    __typename\\n  }\\n  __typename\\n}\\n\\nfragment SocialUserFragment on User {\\n  viewerRelationshipStatus {\\n    isFollowing\\n    isFriend\\n    __typename\\n  }\\n  followersCount\\n  __typename\\n}\"}"},"slots":[{"param":"workId","at":["body","json:/variables/filters/resourceId"]},{"ref":"session:getReviews/x-api-key","at":["header:x-api-key"]}],"volatile":[],"trigger":{"url":"https://www.goodreads.com/book/show/77566"},"match":{"method":"POST","host":"kxbwmqov6jgg3daaamb744ycu4.appsync-api.us-east-1.amazonaws.com","path":"/graphql","operationName":"getReviews"},"response":{"format":"json","contentType":"application/json; charset=UTF-8","extract":"data.getReviews.edges","pick":["reviewer=node.creator.name","rating=node.rating","text=node.text"]},"params":[{"name":"workId","type":"string","required":true,"description":"work id from getWorkId, e.g. kca://work/amzn1.gr.work.v1....","example":"kca://work/amzn1.gr.work.v1.xIT2_7WWJ119Me44O0dVMg"}],"readOnly":true,"minTier":1,"learnedLoggedIn":false,"learnedAt":"2026-09-28T06:43:53.650Z"}},{"hash":"0629f8fac6bf14808026c3118441413f3f777c78157010e01bb6bd6220f435cd","status":"live","confirmations":0,"operation":{"name":"getWorkId","description":"The work id (kca://work/...) that getReviews needs, for a book id.","request":{"method":"GET","url":"https://www.goodreads.com/book/show/%7BbookId%7D","headers":{"accept":"text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7","accept-language":"en-US,en;q=0.9","priority":"u=0, i","sec-ch-ua":"\"Google Chrome\";v=\"153\", \"Not_A Brand\";v=\"8\", \"Chromium\";v=\"153\"","sec-ch-ua-mobile":"?0","sec-ch-ua-platform":"\"macOS\"","sec-fetch-dest":"document","sec-fetch-mode":"navigate","sec-fetch-site":"none","sec-fetch-user":"?1","upgrade-insecure-requests":"1","user-agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/153.0.0.0 Safari/537.36"}},"slots":[{"param":"bookId","at":["path:2"]}],"volatile":[],"trigger":{"url":"https://www.goodreads.com/book/show/{bookId}"},"match":{"method":"GET","host":"www.goodreads.com","path":"/book/show/*"},"response":{"format":"embedded","contentType":"text/html; charset=utf-8","pick":["workId=id","legacyWorkId=legacyId"],"embedded":{"regex":"\"Work:kca[^\"]*\":(\\{)"}},"params":[{"name":"bookId","type":"string","required":true,"description":"Goodreads book id, from searchBooks","example":"77566","pattern":"\\d+","hint":"a numeric Goodreads book id, e.g. 35959740"}],"readOnly":true,"minTier":1,"learnedLoggedIn":false,"learnedAt":"2026-09-28T06:44:01.823Z"}},{"hash":"c899cc961ee2fd49449fcbe8c542fcada61db9b2f01fe832c617816209dd3b95","status":"live","confirmations":1,"successRate":1,"lastOkAt":"2026-10-26T07:30:05.449Z","operation":{"name":"searchBooks","description":"Search books by title or author: the site's own search-box results (top 5), with bookId, title, author, authorId, avgRating and ratingsCount. A \"title author\" query often ranks study guides first; search by title and pick the result by the right author with the most ratings.","request":{"method":"GET","url":"https://www.goodreads.com/book/auto_complete?format=json&q=%7Bq%7D","headers":{"accept":"text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7","accept-language":"en-US,en;q=0.9","priority":"u=0, i","sec-ch-ua":"\"Google Chrome\";v=\"153\", \"Not_A Brand\";v=\"8\", \"Chromium\";v=\"153\"","sec-ch-ua-mobile":"?0","sec-ch-ua-platform":"\"macOS\"","sec-fetch-dest":"document","sec-fetch-mode":"navigate","sec-fetch-site":"none","sec-fetch-user":"?1","upgrade-insecure-requests":"1","user-agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/153.0.0.0 Safari/537.36"}},"slots":[{"param":"q","at":["query:q"]}],"volatile":[],"trigger":{"url":"https://www.goodreads.com/book/auto_complete?format=json&q={q}"},"match":{"method":"GET","host":"www.goodreads.com","path":"/book/auto_complete"},"response":{"format":"json","contentType":"application/json; charset=utf-8","pick":["bookId","title","author=author.name","authorId=author.id","avgRating","ratingsCount"]},"params":[{"name":"q","type":"string","required":true,"description":"title or author words, e.g. \"piranesi\"","example":"hyperion"}],"readOnly":true,"minTier":1,"learnedLoggedIn":false,"learnedAt":"2026-09-28T06:41:32.256Z"}}]}