Goodreads · Authentication Profile

Goodreads Authentication

Authentication

Goodreads secures its APIs with openIdConnect and oauth1 across 3 declared security schemes, as derived from its OpenAPI definitions.

CompanyConsumerBooksReadingSocial NetworkRecommendationsReviewsAmazon
Methods: openIdConnect, oauth1 Schemes: 3 OAuth flows: API key in: query

Security Schemes

OpenIDConnect openIdConnect
LegacyDeveloperKey apiKey
· in: query (key)
LegacyOAuth1 oauth1

Source

Authentication Profile

goodreads-authentication.yml Raw ↑
generated: '2026-07-19'
method: searched
source: https://www.goodreads.com/.well-known/openid-configuration
docs: https://www.goodreads.com/api
summary:
  types: [openIdConnect, oauth1]
  api_key_in: [query]
  oauth2_flows: []
  notes: >-
    No OpenAPI is published for Goodreads, so this profile is searched from
    the live OpenID Connect discovery document and the (now-retired) public
    developer API documentation rather than derived from a spec.
schemes:
- name: OpenIDConnect
  type: openIdConnect
  openIdConnectUrl: https://www.goodreads.com/.well-known/openid-configuration
  issuer: https://www.goodreads.com
  authorization_endpoint: https://www.goodreads.com/open_id/auth_token
  jwks_uri: https://www.goodreads.com/open_id/keys
  response_types_supported: [code, token]
  id_token_signing_alg_values_supported: [RS256]
  sources: [well-known/goodreads-openid-configuration.json]
  description: >-
    OpenID Connect discovery for signing in with a Goodreads account.
- name: LegacyDeveloperKey
  type: apiKey
  in: query
  parameter: key
  status: retired
  sources: [https://www.goodreads.com/api]
  description: >-
    The legacy public Goodreads REST/XML API authenticated public reads with
    a developer `key` query parameter and used OAuth 1.0a for user-scoped
    calls. Goodreads stopped issuing new developer keys on 2020-12-08 (see
    lifecycle); kept here for historical accuracy, not as an available scheme.
- name: LegacyOAuth1
  type: oauth1
  status: retired
  sources: [https://www.goodreads.com/api]
  description: >-
    OAuth 1.0a user authorization used by the retired public developer API for
    member-scoped operations (shelves, reviews). No longer accepting new apps.