{"openapi":"3.1.0","info":{"title":"GoodNovels.org Public Knowledge API","version":"2026-09-07.1","description":"Public, read only catalog and press facts for verified Amazon editions and released direct ebooks. Unsupported records return NOT_AVAILABLE without a United States fallback."},"servers":[{"url":"https://goodnovels.org"}],"paths":{"/api/catalog/":{"get":{"operationId":"browseCatalog","summary":"Read the complete public catalog, grouped by work and language edition","description":"Read only and stateless. This canonical resource does not accept query parameters.","responses":{"200":{"description":"A public verified record matched the request.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/BaseEnvelope"},{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","description":"Published public work and edition metadata. Amazon records retain their existing shape. Direct works include id, slug, author, purchase_channel and editions. No drafts, orders, reader data or protected text."}}},"required":["data"]}]}}}},"400":{"description":"The query is malformed or uses an unsupported field or value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"No public verified record matched. No United States fallback is returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/api/fact-graph/":{"get":{"operationId":"getCanonicalFactGraph","summary":"Get the canonical GoodNovels.org fact graph","description":"Read only and stateless. This canonical resource does not accept query parameters.","responses":{"200":{"description":"A public verified record matched the request.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/BaseEnvelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/FactGraph"}},"required":["data"]}]}}}},"400":{"description":"The query is malformed or uses an unsupported field or value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"No public verified record matched. No United States fallback is returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/api/books/":{"get":{"operationId":"listBooks","summary":"List public books","description":"Read only and stateless. Repeated query keys, unknown query keys, and request URLs over 2048 characters are rejected.","parameters":[{"name":"work_id","in":"query","required":false,"description":"Canonical work identifier. THE PROVIDENCE uses the-providence.","schema":{"type":"string","minLength":1,"maxLength":80,"pattern":"\\S"}},{"name":"title","in":"query","required":false,"description":"Exact public title, matched without case sensitivity.","schema":{"type":"string","minLength":1,"maxLength":80,"pattern":"\\S"}},{"name":"market","in":"query","required":false,"description":"Two letter marketplace code for a currently verified public record.","schema":{"type":"string","pattern":"^(?:[Uu][Ss]|[Cc][Aa]|[Gg][Bb]|[Aa][Uu]|[Ii][Nn]|[Dd][Ee]|[Ff][Rr]|[Ee][Ss]|[Mm][Xx]|[Bb][Rr]|[Jj][Pp]|[Nn][Ll])$","examples":["US","GB","JP"]}},{"name":"locale","in":"query","required":false,"description":"Published BCP 47 marketplace locale.","schema":{"type":"string","enum":["en-US","en-CA","en-GB","en-AU","en-IN","de-DE","fr-FR","es-ES","es-MX","pt-BR","ja-JP","nl-NL"]}},{"name":"language","in":"query","required":false,"description":"ISO 639 language code. English, German, French, Spanish, Portuguese, Japanese, and Dutch names are also accepted.","schema":{"type":"string","pattern":"^(?:[Ee][Nn](?:[Gg][Ll][Ii][Ss][Hh])?|[Dd][Ee]|[Gg][Ee][Rr][Mm][Aa][Nn]|[Ff][Rr](?:[Ee][Nn][Cc][Hh])?|[Ee][Ss]|[Ss][Pp][Aa][Nn][Ii][Ss][Hh]|[Pp][Tt]|[Pp][Oo][Rr][Tt][Uu][Gg][Uu][Ee][Ss][Ee]|[Jj][Aa]|[Jj][Aa][Pp][Aa][Nn][Ee][Ss][Ee]|[Nn][Ll]|[Dd][Uu][Tt][Cc][Hh])$","examples":["en","English","ja"]}},{"name":"format","in":"query","required":false,"description":"Requested retail format. EPUB selects released direct editions only.","schema":{"type":"string","pattern":"^(?:[Ee][Pp][Uu][Bb]|[Kk][Ii][Nn][Dd][Ll][Ee](?: [Ee][Bb][Oo][Oo][Kk])?|[Pp][Aa][Pp][Ee][Rr][Bb][Aa][Cc][Kk]|[Hh][Aa][Rr][Dd][Cc][Oo][Vv][Ee][Rr])$","examples":["kindle","Paperback","hardcover","epub"]}}],"responses":{"200":{"description":"A public verified record matched the request.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/BaseEnvelope"},{"type":"object","properties":{"data":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/PublicBook"},{"$ref":"#/components/schemas/DirectBook"}]}}},"required":["data"]}]}}}},"400":{"description":"The query is malformed or uses an unsupported field or value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"No public verified record matched. No United States fallback is returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/api/books/the-providence/":{"get":{"operationId":"getTheProvidence","summary":"Get THE PROVIDENCE","description":"Read only and stateless. Repeated query keys, unknown query keys, and request URLs over 2048 characters are rejected.","parameters":[{"name":"work_id","in":"query","required":false,"description":"Canonical work identifier. THE PROVIDENCE uses the-providence.","schema":{"type":"string","minLength":1,"maxLength":80,"pattern":"\\S"}},{"name":"title","in":"query","required":false,"description":"Exact public title, matched without case sensitivity.","schema":{"type":"string","minLength":1,"maxLength":80,"pattern":"\\S"}},{"name":"market","in":"query","required":false,"description":"Two letter marketplace code for a currently verified public record.","schema":{"type":"string","pattern":"^(?:[Uu][Ss]|[Cc][Aa]|[Gg][Bb]|[Aa][Uu]|[Ii][Nn]|[Dd][Ee]|[Ff][Rr]|[Ee][Ss]|[Mm][Xx]|[Bb][Rr]|[Jj][Pp]|[Nn][Ll])$","examples":["US","GB","JP"]}},{"name":"locale","in":"query","required":false,"description":"Published BCP 47 marketplace locale.","schema":{"type":"string","enum":["en-US","en-CA","en-GB","en-AU","en-IN","de-DE","fr-FR","es-ES","es-MX","pt-BR","ja-JP","nl-NL"]}},{"name":"language","in":"query","required":false,"description":"ISO 639 language code. English, German, French, Spanish, Portuguese, Japanese, and Dutch names are also accepted.","schema":{"type":"string","pattern":"^(?:[Ee][Nn](?:[Gg][Ll][Ii][Ss][Hh])?|[Dd][Ee]|[Gg][Ee][Rr][Mm][Aa][Nn]|[Ff][Rr](?:[Ee][Nn][Cc][Hh])?|[Ee][Ss]|[Ss][Pp][Aa][Nn][Ii][Ss][Hh]|[Pp][Tt]|[Pp][Oo][Rr][Tt][Uu][Gg][Uu][Ee][Ss][Ee]|[Jj][Aa]|[Jj][Aa][Pp][Aa][Nn][Ee][Ss][Ee]|[Nn][Ll]|[Dd][Uu][Tt][Cc][Hh])$","examples":["en","English","ja"]}},{"name":"format","in":"query","required":false,"description":"Requested retail format. EPUB selects released direct editions only.","schema":{"type":"string","pattern":"^(?:[Ee][Pp][Uu][Bb]|[Kk][Ii][Nn][Dd][Ll][Ee](?: [Ee][Bb][Oo][Oo][Kk])?|[Pp][Aa][Pp][Ee][Rr][Bb][Aa][Cc][Kk]|[Hh][Aa][Rr][Dd][Cc][Oo][Vv][Ee][Rr])$","examples":["kindle","Paperback","hardcover","epub"]}}],"responses":{"200":{"description":"A public verified record matched the request.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/BaseEnvelope"},{"type":"object","properties":{"data":{"allOf":[{"$ref":"#/components/schemas/PublicBook"},{"type":"object","properties":{"editions":{"type":"array","items":{"$ref":"#/components/schemas/PublicEdition"}}},"required":["editions"]}]}},"required":["data"]}]}}}},"400":{"description":"The query is malformed or uses an unsupported field or value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"No public verified record matched. No United States fallback is returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/api/editions/":{"get":{"operationId":"listEditions","summary":"List verified editions","description":"Read only and stateless. Repeated query keys, unknown query keys, and request URLs over 2048 characters are rejected.","parameters":[{"name":"work_id","in":"query","required":false,"description":"Canonical work identifier. THE PROVIDENCE uses the-providence.","schema":{"type":"string","minLength":1,"maxLength":80,"pattern":"\\S"}},{"name":"title","in":"query","required":false,"description":"Exact public title, matched without case sensitivity.","schema":{"type":"string","minLength":1,"maxLength":80,"pattern":"\\S"}},{"name":"market","in":"query","required":false,"description":"Two letter marketplace code for a currently verified public record.","schema":{"type":"string","pattern":"^(?:[Uu][Ss]|[Cc][Aa]|[Gg][Bb]|[Aa][Uu]|[Ii][Nn]|[Dd][Ee]|[Ff][Rr]|[Ee][Ss]|[Mm][Xx]|[Bb][Rr]|[Jj][Pp]|[Nn][Ll])$","examples":["US","GB","JP"]}},{"name":"locale","in":"query","required":false,"description":"Published BCP 47 marketplace locale.","schema":{"type":"string","enum":["en-US","en-CA","en-GB","en-AU","en-IN","de-DE","fr-FR","es-ES","es-MX","pt-BR","ja-JP","nl-NL"]}},{"name":"language","in":"query","required":false,"description":"ISO 639 language code. English, German, French, Spanish, Portuguese, Japanese, and Dutch names are also accepted.","schema":{"type":"string","pattern":"^(?:[Ee][Nn](?:[Gg][Ll][Ii][Ss][Hh])?|[Dd][Ee]|[Gg][Ee][Rr][Mm][Aa][Nn]|[Ff][Rr](?:[Ee][Nn][Cc][Hh])?|[Ee][Ss]|[Ss][Pp][Aa][Nn][Ii][Ss][Hh]|[Pp][Tt]|[Pp][Oo][Rr][Tt][Uu][Gg][Uu][Ee][Ss][Ee]|[Jj][Aa]|[Jj][Aa][Pp][Aa][Nn][Ee][Ss][Ee]|[Nn][Ll]|[Dd][Uu][Tt][Cc][Hh])$","examples":["en","English","ja"]}},{"name":"format","in":"query","required":false,"description":"Requested retail format. EPUB selects released direct editions only.","schema":{"type":"string","pattern":"^(?:[Ee][Pp][Uu][Bb]|[Kk][Ii][Nn][Dd][Ll][Ee](?: [Ee][Bb][Oo][Oo][Kk])?|[Pp][Aa][Pp][Ee][Rr][Bb][Aa][Cc][Kk]|[Hh][Aa][Rr][Dd][Cc][Oo][Vv][Ee][Rr])$","examples":["kindle","Paperback","hardcover","epub"]}}],"responses":{"200":{"description":"A public verified record matched the request.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/BaseEnvelope"},{"type":"object","properties":{"data":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/PublicEdition"},{"$ref":"#/components/schemas/DirectEdition"}]}}},"required":["data"]}]}}}},"400":{"description":"The query is malformed or uses an unsupported field or value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"No public verified record matched. No United States fallback is returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/api/purchase-links/":{"get":{"operationId":"listPurchaseLinks","summary":"List verified ordinary retail links","description":"Read only and stateless. Repeated query keys, unknown query keys, and request URLs over 2048 characters are rejected.","parameters":[{"name":"work_id","in":"query","required":false,"description":"Canonical work identifier. THE PROVIDENCE uses the-providence.","schema":{"type":"string","minLength":1,"maxLength":80,"pattern":"\\S"}},{"name":"title","in":"query","required":false,"description":"Exact public title, matched without case sensitivity.","schema":{"type":"string","minLength":1,"maxLength":80,"pattern":"\\S"}},{"name":"market","in":"query","required":false,"description":"Two letter marketplace code for a currently verified public record.","schema":{"type":"string","pattern":"^(?:[Uu][Ss]|[Cc][Aa]|[Gg][Bb]|[Aa][Uu]|[Ii][Nn]|[Dd][Ee]|[Ff][Rr]|[Ee][Ss]|[Mm][Xx]|[Bb][Rr]|[Jj][Pp]|[Nn][Ll])$","examples":["US","GB","JP"]}},{"name":"locale","in":"query","required":false,"description":"Published BCP 47 marketplace locale.","schema":{"type":"string","enum":["en-US","en-CA","en-GB","en-AU","en-IN","de-DE","fr-FR","es-ES","es-MX","pt-BR","ja-JP","nl-NL"]}},{"name":"language","in":"query","required":false,"description":"ISO 639 language code. English, German, French, Spanish, Portuguese, Japanese, and Dutch names are also accepted.","schema":{"type":"string","pattern":"^(?:[Ee][Nn](?:[Gg][Ll][Ii][Ss][Hh])?|[Dd][Ee]|[Gg][Ee][Rr][Mm][Aa][Nn]|[Ff][Rr](?:[Ee][Nn][Cc][Hh])?|[Ee][Ss]|[Ss][Pp][Aa][Nn][Ii][Ss][Hh]|[Pp][Tt]|[Pp][Oo][Rr][Tt][Uu][Gg][Uu][Ee][Ss][Ee]|[Jj][Aa]|[Jj][Aa][Pp][Aa][Nn][Ee][Ss][Ee]|[Nn][Ll]|[Dd][Uu][Tt][Cc][Hh])$","examples":["en","English","ja"]}},{"name":"format","in":"query","required":false,"description":"Requested retail format. EPUB selects released direct editions only.","schema":{"type":"string","pattern":"^(?:[Ee][Pp][Uu][Bb]|[Kk][Ii][Nn][Dd][Ll][Ee](?: [Ee][Bb][Oo][Oo][Kk])?|[Pp][Aa][Pp][Ee][Rr][Bb][Aa][Cc][Kk]|[Hh][Aa][Rr][Dd][Cc][Oo][Vv][Ee][Rr])$","examples":["kindle","Paperback","hardcover","epub"]}}],"responses":{"200":{"description":"A public verified record matched the request.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/BaseEnvelope"},{"type":"object","properties":{"data":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/PurchaseLink"},{"$ref":"#/components/schemas/DirectPurchaseLink"}]}}},"required":["data"]}]}}}},"400":{"description":"The query is malformed or uses an unsupported field or value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"No public verified record matched. No United States fallback is returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/api/press/":{"get":{"operationId":"getPressFacts","summary":"Get official press facts","description":"Read only and stateless. Repeated query keys, unknown query keys, and request URLs over 2048 characters are rejected.","parameters":[{"name":"work_id","in":"query","required":false,"description":"Canonical work identifier. THE PROVIDENCE uses the-providence.","schema":{"type":"string","minLength":1,"maxLength":80,"pattern":"\\S"}},{"name":"title","in":"query","required":false,"description":"Exact public title, matched without case sensitivity.","schema":{"type":"string","minLength":1,"maxLength":80,"pattern":"\\S"}},{"name":"market","in":"query","required":false,"description":"Two letter marketplace code for a currently verified public record.","schema":{"type":"string","pattern":"^(?:[Uu][Ss]|[Cc][Aa]|[Gg][Bb]|[Aa][Uu]|[Ii][Nn]|[Dd][Ee]|[Ff][Rr]|[Ee][Ss]|[Mm][Xx]|[Bb][Rr]|[Jj][Pp]|[Nn][Ll])$","examples":["US","GB","JP"]}},{"name":"locale","in":"query","required":false,"description":"Published BCP 47 marketplace locale.","schema":{"type":"string","enum":["en-US","en-CA","en-GB","en-AU","en-IN","de-DE","fr-FR","es-ES","es-MX","pt-BR","ja-JP","nl-NL"]}},{"name":"language","in":"query","required":false,"description":"ISO 639 language code. English, German, French, Spanish, Portuguese, Japanese, and Dutch names are also accepted.","schema":{"type":"string","pattern":"^(?:[Ee][Nn](?:[Gg][Ll][Ii][Ss][Hh])?|[Dd][Ee]|[Gg][Ee][Rr][Mm][Aa][Nn]|[Ff][Rr](?:[Ee][Nn][Cc][Hh])?|[Ee][Ss]|[Ss][Pp][Aa][Nn][Ii][Ss][Hh]|[Pp][Tt]|[Pp][Oo][Rr][Tt][Uu][Gg][Uu][Ee][Ss][Ee]|[Jj][Aa]|[Jj][Aa][Pp][Aa][Nn][Ee][Ss][Ee]|[Nn][Ll]|[Dd][Uu][Tt][Cc][Hh])$","examples":["en","English","ja"]}},{"name":"format","in":"query","required":false,"description":"Requested retail format. EPUB selects released direct editions only.","schema":{"type":"string","pattern":"^(?:[Ee][Pp][Uu][Bb]|[Kk][Ii][Nn][Dd][Ll][Ee](?: [Ee][Bb][Oo][Oo][Kk])?|[Pp][Aa][Pp][Ee][Rr][Bb][Aa][Cc][Kk]|[Hh][Aa][Rr][Dd][Cc][Oo][Vv][Ee][Rr])$","examples":["kindle","Paperback","hardcover","epub"]}}],"responses":{"200":{"description":"A public verified record matched the request.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/BaseEnvelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/PressFacts"}},"required":["data"]}]}}}},"400":{"description":"The query is malformed or uses an unsupported field or value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"No public verified record matched. No United States fallback is returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/api/site/":{"get":{"operationId":"getSiteIdentity","summary":"Get GoodNovels.org identity and role boundaries","description":"Read only and stateless. Repeated query keys, unknown query keys, and request URLs over 2048 characters are rejected.","parameters":[{"name":"work_id","in":"query","required":false,"description":"Canonical work identifier. THE PROVIDENCE uses the-providence.","schema":{"type":"string","minLength":1,"maxLength":80,"pattern":"\\S"}},{"name":"title","in":"query","required":false,"description":"Exact public title, matched without case sensitivity.","schema":{"type":"string","minLength":1,"maxLength":80,"pattern":"\\S"}},{"name":"market","in":"query","required":false,"description":"Two letter marketplace code for a currently verified public record.","schema":{"type":"string","pattern":"^(?:[Uu][Ss]|[Cc][Aa]|[Gg][Bb]|[Aa][Uu]|[Ii][Nn]|[Dd][Ee]|[Ff][Rr]|[Ee][Ss]|[Mm][Xx]|[Bb][Rr]|[Jj][Pp]|[Nn][Ll])$","examples":["US","GB","JP"]}},{"name":"locale","in":"query","required":false,"description":"Published BCP 47 marketplace locale.","schema":{"type":"string","enum":["en-US","en-CA","en-GB","en-AU","en-IN","de-DE","fr-FR","es-ES","es-MX","pt-BR","ja-JP","nl-NL"]}},{"name":"language","in":"query","required":false,"description":"ISO 639 language code. English, German, French, Spanish, Portuguese, Japanese, and Dutch names are also accepted.","schema":{"type":"string","pattern":"^(?:[Ee][Nn](?:[Gg][Ll][Ii][Ss][Hh])?|[Dd][Ee]|[Gg][Ee][Rr][Mm][Aa][Nn]|[Ff][Rr](?:[Ee][Nn][Cc][Hh])?|[Ee][Ss]|[Ss][Pp][Aa][Nn][Ii][Ss][Hh]|[Pp][Tt]|[Pp][Oo][Rr][Tt][Uu][Gg][Uu][Ee][Ss][Ee]|[Jj][Aa]|[Jj][Aa][Pp][Aa][Nn][Ee][Ss][Ee]|[Nn][Ll]|[Dd][Uu][Tt][Cc][Hh])$","examples":["en","English","ja"]}},{"name":"format","in":"query","required":false,"description":"Requested retail format. EPUB selects released direct editions only.","schema":{"type":"string","pattern":"^(?:[Ee][Pp][Uu][Bb]|[Kk][Ii][Nn][Dd][Ll][Ee](?: [Ee][Bb][Oo][Oo][Kk])?|[Pp][Aa][Pp][Ee][Rr][Bb][Aa][Cc][Kk]|[Hh][Aa][Rr][Dd][Cc][Oo][Vv][Ee][Rr])$","examples":["kindle","Paperback","hardcover","epub"]}}],"responses":{"200":{"description":"A public verified record matched the request.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/BaseEnvelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/SiteIdentity"}},"required":["data"]}]}}}},"400":{"description":"The query is malformed or uses an unsupported field or value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"No public verified record matched. No United States fallback is returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/api/book-sample/":{"get":{"operationId":"getBookSample","summary":"Get the authorized Book Sample","description":"Read only and stateless. Repeated query keys, unknown query keys, and request URLs over 2048 characters are rejected.","parameters":[{"name":"work_id","in":"query","required":false,"description":"Canonical work identifier. THE PROVIDENCE uses the-providence.","schema":{"type":"string","minLength":1,"maxLength":80,"pattern":"\\S"}},{"name":"title","in":"query","required":false,"description":"Exact public title, matched without case sensitivity.","schema":{"type":"string","minLength":1,"maxLength":80,"pattern":"\\S"}},{"name":"market","in":"query","required":false,"description":"Two letter marketplace code for a currently verified public record.","schema":{"type":"string","pattern":"^(?:[Uu][Ss]|[Cc][Aa]|[Gg][Bb]|[Aa][Uu]|[Ii][Nn]|[Dd][Ee]|[Ff][Rr]|[Ee][Ss]|[Mm][Xx]|[Bb][Rr]|[Jj][Pp]|[Nn][Ll])$","examples":["US","GB","JP"]}},{"name":"locale","in":"query","required":false,"description":"Published BCP 47 marketplace locale.","schema":{"type":"string","enum":["en-US","en-CA","en-GB","en-AU","en-IN","de-DE","fr-FR","es-ES","es-MX","pt-BR","ja-JP","nl-NL"]}},{"name":"language","in":"query","required":false,"description":"ISO 639 language code. English, German, French, Spanish, Portuguese, Japanese, and Dutch names are also accepted.","schema":{"type":"string","pattern":"^(?:[Ee][Nn](?:[Gg][Ll][Ii][Ss][Hh])?|[Dd][Ee]|[Gg][Ee][Rr][Mm][Aa][Nn]|[Ff][Rr](?:[Ee][Nn][Cc][Hh])?|[Ee][Ss]|[Ss][Pp][Aa][Nn][Ii][Ss][Hh]|[Pp][Tt]|[Pp][Oo][Rr][Tt][Uu][Gg][Uu][Ee][Ss][Ee]|[Jj][Aa]|[Jj][Aa][Pp][Aa][Nn][Ee][Ss][Ee]|[Nn][Ll]|[Dd][Uu][Tt][Cc][Hh])$","examples":["en","English","ja"]}},{"name":"format","in":"query","required":false,"description":"Requested retail format. EPUB selects released direct editions only.","schema":{"type":"string","pattern":"^(?:[Ee][Pp][Uu][Bb]|[Kk][Ii][Nn][Dd][Ll][Ee](?: [Ee][Bb][Oo][Oo][Kk])?|[Pp][Aa][Pp][Ee][Rr][Bb][Aa][Cc][Kk]|[Hh][Aa][Rr][Dd][Cc][Oo][Vv][Ee][Rr])$","examples":["kindle","Paperback","hardcover","epub"]}}],"responses":{"200":{"description":"A public verified record matched the request.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/BaseEnvelope"},{"type":"object","properties":{"data":{"type":"object"}},"required":["data"]}]}}}},"400":{"description":"The query is malformed or uses an unsupported field or value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"No public verified record matched. No United States fallback is returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/api/book-clubs/":{"get":{"operationId":"getBookClubResources","summary":"Get public Book Club resources","description":"Read only and stateless. Repeated query keys, unknown query keys, and request URLs over 2048 characters are rejected.","parameters":[{"name":"work_id","in":"query","required":false,"description":"Canonical work identifier. THE PROVIDENCE uses the-providence.","schema":{"type":"string","minLength":1,"maxLength":80,"pattern":"\\S"}},{"name":"title","in":"query","required":false,"description":"Exact public title, matched without case sensitivity.","schema":{"type":"string","minLength":1,"maxLength":80,"pattern":"\\S"}},{"name":"market","in":"query","required":false,"description":"Two letter marketplace code for a currently verified public record.","schema":{"type":"string","pattern":"^(?:[Uu][Ss]|[Cc][Aa]|[Gg][Bb]|[Aa][Uu]|[Ii][Nn]|[Dd][Ee]|[Ff][Rr]|[Ee][Ss]|[Mm][Xx]|[Bb][Rr]|[Jj][Pp]|[Nn][Ll])$","examples":["US","GB","JP"]}},{"name":"locale","in":"query","required":false,"description":"Published BCP 47 marketplace locale.","schema":{"type":"string","enum":["en-US","en-CA","en-GB","en-AU","en-IN","de-DE","fr-FR","es-ES","es-MX","pt-BR","ja-JP","nl-NL"]}},{"name":"language","in":"query","required":false,"description":"ISO 639 language code. English, German, French, Spanish, Portuguese, Japanese, and Dutch names are also accepted.","schema":{"type":"string","pattern":"^(?:[Ee][Nn](?:[Gg][Ll][Ii][Ss][Hh])?|[Dd][Ee]|[Gg][Ee][Rr][Mm][Aa][Nn]|[Ff][Rr](?:[Ee][Nn][Cc][Hh])?|[Ee][Ss]|[Ss][Pp][Aa][Nn][Ii][Ss][Hh]|[Pp][Tt]|[Pp][Oo][Rr][Tt][Uu][Gg][Uu][Ee][Ss][Ee]|[Jj][Aa]|[Jj][Aa][Pp][Aa][Nn][Ee][Ss][Ee]|[Nn][Ll]|[Dd][Uu][Tt][Cc][Hh])$","examples":["en","English","ja"]}},{"name":"format","in":"query","required":false,"description":"Requested retail format. EPUB selects released direct editions only.","schema":{"type":"string","pattern":"^(?:[Ee][Pp][Uu][Bb]|[Kk][Ii][Nn][Dd][Ll][Ee](?: [Ee][Bb][Oo][Oo][Kk])?|[Pp][Aa][Pp][Ee][Rr][Bb][Aa][Cc][Kk]|[Hh][Aa][Rr][Dd][Cc][Oo][Vv][Ee][Rr])$","examples":["kindle","Paperback","hardcover","epub"]}}],"responses":{"200":{"description":"A public verified record matched the request.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/BaseEnvelope"},{"type":"object","properties":{"data":{"type":"object"}},"required":["data"]}]}}}},"400":{"description":"The query is malformed or uses an unsupported field or value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"No public verified record matched. No United States fallback is returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/api/rights/":{"get":{"operationId":"getRightsContact","summary":"Get the neutral rights inquiry path","description":"Read only and stateless. Repeated query keys, unknown query keys, and request URLs over 2048 characters are rejected.","parameters":[{"name":"work_id","in":"query","required":false,"description":"Canonical work identifier. THE PROVIDENCE uses the-providence.","schema":{"type":"string","minLength":1,"maxLength":80,"pattern":"\\S"}},{"name":"title","in":"query","required":false,"description":"Exact public title, matched without case sensitivity.","schema":{"type":"string","minLength":1,"maxLength":80,"pattern":"\\S"}},{"name":"market","in":"query","required":false,"description":"Two letter marketplace code for a currently verified public record.","schema":{"type":"string","pattern":"^(?:[Uu][Ss]|[Cc][Aa]|[Gg][Bb]|[Aa][Uu]|[Ii][Nn]|[Dd][Ee]|[Ff][Rr]|[Ee][Ss]|[Mm][Xx]|[Bb][Rr]|[Jj][Pp]|[Nn][Ll])$","examples":["US","GB","JP"]}},{"name":"locale","in":"query","required":false,"description":"Published BCP 47 marketplace locale.","schema":{"type":"string","enum":["en-US","en-CA","en-GB","en-AU","en-IN","de-DE","fr-FR","es-ES","es-MX","pt-BR","ja-JP","nl-NL"]}},{"name":"language","in":"query","required":false,"description":"ISO 639 language code. English, German, French, Spanish, Portuguese, Japanese, and Dutch names are also accepted.","schema":{"type":"string","pattern":"^(?:[Ee][Nn](?:[Gg][Ll][Ii][Ss][Hh])?|[Dd][Ee]|[Gg][Ee][Rr][Mm][Aa][Nn]|[Ff][Rr](?:[Ee][Nn][Cc][Hh])?|[Ee][Ss]|[Ss][Pp][Aa][Nn][Ii][Ss][Hh]|[Pp][Tt]|[Pp][Oo][Rr][Tt][Uu][Gg][Uu][Ee][Ss][Ee]|[Jj][Aa]|[Jj][Aa][Pp][Aa][Nn][Ee][Ss][Ee]|[Nn][Ll]|[Dd][Uu][Tt][Cc][Hh])$","examples":["en","English","ja"]}},{"name":"format","in":"query","required":false,"description":"Requested retail format. EPUB selects released direct editions only.","schema":{"type":"string","pattern":"^(?:[Ee][Pp][Uu][Bb]|[Kk][Ii][Nn][Dd][Ll][Ee](?: [Ee][Bb][Oo][Oo][Kk])?|[Pp][Aa][Pp][Ee][Rr][Bb][Aa][Cc][Kk]|[Hh][Aa][Rr][Dd][Cc][Oo][Vv][Ee][Rr])$","examples":["kindle","Paperback","hardcover","epub"]}}],"responses":{"200":{"description":"A public verified record matched the request.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/BaseEnvelope"},{"type":"object","properties":{"data":{"type":"object"}},"required":["data"]}]}}}},"400":{"description":"The query is malformed or uses an unsupported field or value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"No public verified record matched. No United States fallback is returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/api/policy/":{"get":{"operationId":"getSitePolicy","summary":"Get public identity and policy boundaries","description":"Read only and stateless. Repeated query keys, unknown query keys, and request URLs over 2048 characters are rejected.","parameters":[{"name":"work_id","in":"query","required":false,"description":"Canonical work identifier. THE PROVIDENCE uses the-providence.","schema":{"type":"string","minLength":1,"maxLength":80,"pattern":"\\S"}},{"name":"title","in":"query","required":false,"description":"Exact public title, matched without case sensitivity.","schema":{"type":"string","minLength":1,"maxLength":80,"pattern":"\\S"}},{"name":"market","in":"query","required":false,"description":"Two letter marketplace code for a currently verified public record.","schema":{"type":"string","pattern":"^(?:[Uu][Ss]|[Cc][Aa]|[Gg][Bb]|[Aa][Uu]|[Ii][Nn]|[Dd][Ee]|[Ff][Rr]|[Ee][Ss]|[Mm][Xx]|[Bb][Rr]|[Jj][Pp]|[Nn][Ll])$","examples":["US","GB","JP"]}},{"name":"locale","in":"query","required":false,"description":"Published BCP 47 marketplace locale.","schema":{"type":"string","enum":["en-US","en-CA","en-GB","en-AU","en-IN","de-DE","fr-FR","es-ES","es-MX","pt-BR","ja-JP","nl-NL"]}},{"name":"language","in":"query","required":false,"description":"ISO 639 language code. English, German, French, Spanish, Portuguese, Japanese, and Dutch names are also accepted.","schema":{"type":"string","pattern":"^(?:[Ee][Nn](?:[Gg][Ll][Ii][Ss][Hh])?|[Dd][Ee]|[Gg][Ee][Rr][Mm][Aa][Nn]|[Ff][Rr](?:[Ee][Nn][Cc][Hh])?|[Ee][Ss]|[Ss][Pp][Aa][Nn][Ii][Ss][Hh]|[Pp][Tt]|[Pp][Oo][Rr][Tt][Uu][Gg][Uu][Ee][Ss][Ee]|[Jj][Aa]|[Jj][Aa][Pp][Aa][Nn][Ee][Ss][Ee]|[Nn][Ll]|[Dd][Uu][Tt][Cc][Hh])$","examples":["en","English","ja"]}},{"name":"format","in":"query","required":false,"description":"Requested retail format. EPUB selects released direct editions only.","schema":{"type":"string","pattern":"^(?:[Ee][Pp][Uu][Bb]|[Kk][Ii][Nn][Dd][Ll][Ee](?: [Ee][Bb][Oo][Oo][Kk])?|[Pp][Aa][Pp][Ee][Rr][Bb][Aa][Cc][Kk]|[Hh][Aa][Rr][Dd][Cc][Oo][Vv][Ee][Rr])$","examples":["kindle","Paperback","hardcover","epub"]}}],"responses":{"200":{"description":"A public verified record matched the request.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/BaseEnvelope"},{"type":"object","properties":{"data":{"type":"object"}},"required":["data"]}]}}}},"400":{"description":"The query is malformed or uses an unsupported field or value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"No public verified record matched. No United States fallback is returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}}},"components":{"schemas":{"BaseEnvelope":{"type":"object","additionalProperties":false,"properties":{"canonical_url":{"type":"string","format":"uri"},"last_updated":{"type":"string","format":"date"},"checked_time":{"type":"string","format":"date-time"},"locale":{"type":["string","null"]},"language":{"type":["string","null"]},"market_scope":{"type":["string","null"]},"source":{"type":"string"},"data_version":{"type":"string"},"status":{"type":"string","enum":["PUBLIC_VERIFIED","NOT_AVAILABLE","INVALID_QUERY"]},"query":{"type":"object","additionalProperties":{"type":"string"}},"data":{}},"required":["canonical_url","last_updated","locale","language","market_scope","source","data_version","status","query"]},"ErrorEnvelope":{"allOf":[{"$ref":"#/components/schemas/BaseEnvelope"},{"type":"object","properties":{"data":{"type":"object","additionalProperties":false,"properties":{"message":{"type":"string"},"alternatives":{"type":"array","items":{"$ref":"#/components/schemas/PublicEdition"}},"substituted_market":{"type":"boolean","const":false}},"required":["message"]}},"required":["data"]}]},"SampleAction":{"type":"object","additionalProperties":false,"properties":{"label":{"type":"string","const":"Book Sample"},"destination_type":{"type":"string","const":"goodnovels_prelude"},"url":{"type":"string","format":"uri"},"instruction":{"type":"string"},"content_scope_verified":{"type":"boolean","const":true}},"required":["label","destination_type","url","instruction","content_scope_verified"]},"DirectBook":{"type":"object","properties":{"work_id":{"type":"string"},"title":{"type":"string"},"author":{"type":"string"},"purchase_channel":{"const":"direct"},"languages":{"type":"array","items":{"type":"string","enum":["en","es","pt-BR"]}},"available_formats":{"type":"array","items":{"const":"epub"}},"canonical_url":{"type":"string","format":"uri"},"editions":{"type":"array","items":{"type":"object"}}},"required":["work_id","title","author","purchase_channel","languages","available_formats","canonical_url","editions"]},"DirectEdition":{"type":"object","properties":{"id":{"type":"string"},"work_id":{"type":"string"},"title":{"type":"string"},"language":{"type":"string","enum":["en","es","pt-BR"]},"purchase_channel":{"const":"direct"},"format":{"const":"epub"},"price_cents":{"const":199},"currency":{"const":"USD"},"url":{"type":"string","format":"uri"}},"required":["id","work_id","title","language","purchase_channel","format","price_cents","currency","url"]},"DirectPurchaseLink":{"type":"object","properties":{"id":{"type":"string"},"work_id":{"type":"string"},"language":{"type":"string","enum":["en","es","pt-BR"]},"purchase_channel":{"const":"direct"},"format":{"const":"epub"},"price_cents":{"const":199},"currency":{"const":"USD"},"url":{"type":"string","format":"uri"}},"required":["id","work_id","language","purchase_channel","format","price_cents","currency","url"]},"PublicBook":{"type":"object","properties":{"work_id":{"type":"string"},"title":{"type":"string"},"author":{"type":"string"},"languages":{"type":"array","items":{"type":"string"}},"locales":{"type":"array","items":{"type":"string"}},"available_markets":{"type":"array","items":{"type":"string"}},"publication_year":{"type":"integer"},"genre":{"type":"array","items":{"type":"string"}},"setting":{"type":"string"},"reading_time":{"type":"string"},"length":{"type":"string"},"canonical_url":{"type":"string","format":"uri"},"cover_url":{"type":"string","format":"uri"},"hook":{"type":"string"},"premise":{"type":"string"},"description":{"type":"string"},"biblical_sources":{"type":"array","items":{"type":"string"}},"source_note":{"type":"string"},"author_page":{"type":"string","format":"uri"},"sample_action":{"$ref":"#/components/schemas/SampleAction"},"available_formats":{"type":"array","items":{"type":"string","enum":["kindle","paperback","hardcover"]}}},"required":["work_id","title","author","languages","locales","available_markets","publication_year","canonical_url","sample_action"]},"PublicEdition":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"work_id":{"type":"string"},"title":{"type":"string"},"author":{"type":"string"},"locale":{"type":"string"},"locale_slug":{"type":"string"},"market":{"type":"string"},"market_label":{"type":"string"},"country_name_native":{"type":"string"},"language":{"type":"string"},"language_code":{"type":"string"},"language_native":{"type":"string"},"format":{"type":"string","enum":["kindle","paperback","hardcover"]},"format_label":{"type":"string"},"asin":{"type":"string"},"isbn":{"type":["string","null"]},"amazon_url":{"type":"string","format":"uri"},"amazon_attribution_url":{"type":["string","null"],"format":"uri"},"cover_url":{"type":"string","format":"uri"},"domain":{"type":"string"},"link_type":{"type":"string","const":"ORDINARY_RETAIL"},"public_status":{"type":"string","const":"PUBLIC_VERIFIED"},"link_checked_at":{"type":"string","format":"date"}},"required":["id","work_id","title","author","locale","locale_slug","market","market_label","country_name_native","language","language_code","language_native","format","format_label","asin","isbn","amazon_url","amazon_attribution_url","cover_url","domain","link_type","public_status","link_checked_at"]},"PurchaseLink":{"type":"object","properties":{"id":{"type":"string"},"work_id":{"type":"string"},"locale":{"type":"string"},"market":{"type":"string"},"format":{"type":"string"},"asin":{"type":"string"},"url":{"type":"string","format":"uri"},"link_type":{"type":"string","const":"ORDINARY_RETAIL"},"link_checked_at":{"type":"string","format":"date"}},"required":["id","work_id","locale","market","format","asin","url","link_type","link_checked_at"]},"PressFacts":{"type":"object","properties":{"title":{"type":"string"},"author":{"type":"string"},"author_biography":{"type":"array","items":{"type":"string"},"minItems":2,"maxItems":2},"publication_year":{"type":"integer"},"publication":{"type":"string"},"promotional_and_media_contact":{"type":"string"},"original_language":{"type":"string"},"verified_edition_count":{"type":"integer"},"verified_markets":{"type":"array","items":{"type":"string"}},"formats":{"type":"array","items":{"type":"string"}},"genre":{"type":"array","items":{"type":"string"}},"purchase_options":{"type":"array","items":{"$ref":"#/components/schemas/PublicEdition"}},"setting":{"type":"string"},"hook":{"type":"string"},"description":{"type":"string"},"biblical_sources":{"type":"array","items":{"type":"string"}},"media_contact":{"type":"string","format":"email"},"book_club_contact":{"type":"string","format":"email"},"book_club_page":{"type":"string","format":"uri"},"press_room":{"type":"string","format":"uri"},"book_sample":{"type":"object"},"choose_your_edition":{"type":"string","format":"uri"},"approved_assets":{"type":"object"},"rights_boundary":{"type":"string"}}},"SiteIdentity":{"type":"object","properties":{"name":{"type":"string"},"brand_line":{"type":"string"},"description":{"type":"string"},"role":{"type":"string"},"publisher":{"type":"boolean","const":false},"retailer":{"type":"boolean","const":false},"rights_owner":{"type":"boolean","const":false},"url":{"type":"string","format":"uri"},"email":{"type":"string","format":"email"},"language":{"type":"string"},"current_featured_book":{"type":"string"},"api_documentation":{"type":"string","format":"uri"},"public_data_scope":{"type":"string"}}},"FactGraph":{"type":"object","additionalProperties":false,"properties":{"schema_version":{"type":"string"},"data_version":{"type":"string"},"last_verified":{"type":"string","format":"date"},"identity":{"type":"object"},"author":{"type":"object"},"work":{"type":"object"},"retail":{"type":"object"},"public_resources":{"type":"object"},"editorial":{"type":"object"},"claim_provenance":{"type":"array","items":{"type":"object"}},"boundaries":{"type":"object"},"direct_catalog":{"type":"array","items":{"type":"object"}}},"required":["schema_version","data_version","last_verified","identity","author","work","retail","public_resources","editorial","claim_provenance","boundaries"]}}}}