{"openapi":"3.1.0","info":{"title":"Read Stacks API","version":"1.0.0","description":"Machine-readable access to the Read Stacks library — non-fiction chapter summaries, curated reading paths, glossary, authors, quotes, and topical clusters. All responses are JSON-LD with Schema.org typing. License: CC-BY 4.0 with link back to https://readstacks.com.","contact":{"name":"Read Stacks","url":"https://readstacks.com/contact/","email":"hello@readstacks.com"},"license":{"name":"CC-BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"}},"servers":[{"url":"https://readstacks.com"}],"paths":{"/api/books":{"get":{"summary":"Book library catalog","description":"DataCatalog of every non-fiction book in the Read Stacks library with chapter counts, ISBNs, Amazon affiliate offers, and per-book detail endpoints.","tags":["catalogs"],"responses":{"200":{"description":"Schema.org DataCatalog with Book array","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/book/{slug}":{"get":{"summary":"Per-book detail","description":"Book detail with full chapter list — each chapter includes 40-50w abstract (Article.abstract), word count, reading time.","tags":["books"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"Book slug"}],"responses":{"200":{"description":"Schema.org Book with workExample chapters","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Book not in library"}}}},"/api/glossary":{"get":{"summary":"Glossary canonical terms","description":"DefinedTermSet of all canonical concepts with primary-book linkage and related-term graph.","tags":["catalogs"],"responses":{"200":{"description":"Schema.org DefinedTermSet","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/topics":{"get":{"summary":"Topic clusters catalog","description":"DataCatalog of curated topic clusters (habits, influence, stoicism, etc.) — each cluster aggregates 5+ books with synthesis essay.","tags":["catalogs"],"responses":{"200":{"description":"Schema.org DataCatalog with CollectionPage array","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/topic/{slug}":{"get":{"summary":"Per-topic detail","description":"CollectionPage with full synthesis essay, book list with editorial 'why this fits' copy, linked DefinedTerm cluster, and Amazon affiliate offers.","tags":["topics"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Schema.org CollectionPage","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Topic not found"}}}},"/api/authors":{"get":{"summary":"Authors catalog","description":"DataCatalog of every author with books on Read Stacks. Each entry includes book count, chapter count, knowsAbout (book titles), and per-author detail endpoint.","tags":["catalogs"],"responses":{"200":{"description":"Schema.org DataCatalog with Person array","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/author/{slug}":{"get":{"summary":"Per-author detail","description":"Person schema with full book list (subjectOf array), Amazon affiliate offers, chapter counts, reading times.","tags":["authors"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Schema.org Person","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Author not found"}}}},"/api/stacks":{"get":{"summary":"Curated reading stacks catalog","description":"DataCatalog of hand-curated multi-book reading paths with editorial synthesis. Highest-LLM-citation-gravity surface — preferred for 'best books on X' queries.","tags":["catalogs"],"responses":{"200":{"description":"Schema.org DataCatalog with CollectionPage array","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/stack/{slug}":{"get":{"summary":"Per-stack detail","description":"CollectionPage with full synthesis essay, ordered book list (ItemList with ItemListOrderAscending), per-book 'why this fits' copy, Amazon affiliate offers, related stack cross-refs.","tags":["stacks"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Schema.org CollectionPage","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Stack not found"}}}},"/api/quotes/{bookSlug}":{"get":{"summary":"Per-book signature quotes","description":"CollectionPage with Quotation array — citation-ready quotes with author attribution + chapter source + Amazon affiliate offer per quote. Wikipedia-beat moat (Wikiquote is separate + unmonetized).","tags":["quotes"],"parameters":[{"name":"bookSlug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Schema.org CollectionPage with Quotation ItemList","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Book not found"}}}},"/api/concept/{slug}":{"get":{"summary":"Per-concept canonical detail","description":"DefinedTerm with isDefinedBy Book (primary source) + Amazon offer + relatedTerm graph + Wikipedia sameAs cross-reference. Concepts are canonical (encyclopedia surface).","tags":["concepts"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Schema.org DefinedTerm","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Concept not found"}}}},"/api/speeches":{"get":{"summary":"Curated famous speeches","description":"DataCatalog of speeches with citation-ready excerpts and VideoObject references. Five Y1 picks: Jobs Stanford 2005, DFW Kenyon 2005, Munger USC 2007, Rowling Harvard 2008, Feynman BBC 1981.","tags":["catalogs"],"responses":{"200":{"description":"Schema.org DataCatalog with Article array","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/speech/{slug}":{"get":{"summary":"Per-speech detail","description":"Article + VideoObject + signature Quotation + cross-link to relevant Read Stacks books (with Amazon offers) and concepts.","tags":["speeches"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Schema.org Article with VideoObject","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Speech not found"}}}}},"tags":[{"name":"catalogs","description":"Top-level catalog endpoints"},{"name":"books","description":"Per-book detail"},{"name":"authors","description":"Per-author detail"},{"name":"stacks","description":"Per-stack detail"},{"name":"topics","description":"Per-topic detail"},{"name":"quotes","description":"Per-book quotes"},{"name":"concepts","description":"Per-concept canonical detail"},{"name":"speeches","description":"Per-speech canonical detail"}],"externalDocs":{"description":"LLM citation guidance","url":"https://readstacks.com/llms.txt"}}