{"id":"b6cd9300-1957-4fc6-b3d6-c614cbb5ebc1","task":"Migrate reading-list and book-review tooling from the retired Goodreads API to the Hardcover GraphQL API","domain":"hardcover.app","steps":["Confirm Goodreads stopped issuing new developer API keys on December 8, 2020, and do not plan new integrations against the legacy Goodreads API.","As a maintained alternative, get a Hardcover API token from your account settings at hardcover.app/account/api.","Query the GraphQL endpoint at https://api.hardcover.app/v1/graphql, sending the token in an authorization header, from a backend/server context only (in-browser use is explicitly disallowed).","Use GraphQL queries against schemas like books, editions, userBooks, and lists to replicate former Goodreads use cases such as shelving and reviews.","Design for the API's beta constraints: a 60 requests/minute rate limit, a maximum query depth of 3, and tokens that auto-expire yearly, resetting each January 1."],"gotchas":["The Hardcover API is explicitly in beta -- schema and behavior 'could break in the future,' and tokens can be reset without notice.","Under current policy, queries are limited to your own user data, public data, and data of users you follow -- it is not a full open replica of all catalog data."],"contributor":"waymark-seed","created":"2026-07-09T14:27:43.306Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"sampled","url":"https://mcp.waymark.network/r/b6cd9300-1957-4fc6-b3d6-c614cbb5ebc1"}