{"openapi":"3.1.0","info":{"title":"TVTyped public catalog","version":"1.3.0","description":"Read-only quote and poster discovery with exact printed text, artwork and configuration links. Approved preview artwork can appear in gallery-test; other samples are local development only. Preview prices are not payable offers. Use commerceEnabled and variant availability to determine sale status. GET never charges or creates an order."},"servers":[{"url":"https://tvtyped.com"}],"paths":{"/api/catalog":{"get":{"operationId":"searchPosters","summary":"Filter poster designs by quote, series, style, color, and size","parameters":[{"name":"q","in":"query","schema":{"type":"string","maxLength":200}},{"name":"collection","in":"query","schema":{"type":"string","enum":["star-trek","seinfeld","the-sopranos","the-simpsons","community","brooklyn-nine-nine","stand-up"]}},{"name":"series","in":"query","schema":{"type":"string","enum":["tng","ds9","voyager","enterprise","seinfeld","the-sopranos","the-simpsons","community","brooklyn-nine-nine","norm-macdonald","louis-ck","shane-gillis","john-mulaney"]}},{"name":"quote","in":"query","schema":{"type":"string","maxLength":120,"pattern":"^[a-z0-9-]+$"}},{"name":"style","in":"query","schema":{"type":"string","enum":["abstract","geometric","minimal","textured","typographic"]}},{"name":"color","in":"query","schema":{"type":"string","enum":["black","blue","cream","gold","green","pink","purple","red"]}},{"name":"size","in":"query","schema":{"type":"string","enum":["medium","large"]}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":48,"default":24}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":100000,"default":0}}],"responses":{"200":{"description":"Matching designs","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","mode","total","limit","offset","next","items","commerceEnabled","currency"],"properties":{"revision":{"type":"string"},"mode":{"type":"string","enum":["demo","gallery-test","published"]},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"next":{"type":["string","null"],"format":"uri"},"items":{"type":"array","items":{"$ref":"#/components/schemas/Poster"}},"commerceEnabled":{"type":"boolean"},"currency":{"type":"string","const":"USD"}}}}}},"400":{"description":"Invalid request or missing record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/posters/{id}":{"get":{"operationId":"getPoster","summary":"Get a poster and size-specific configuration links","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Poster","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Poster"}}}},"404":{"description":"Invalid request or missing record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/quotes":{"get":{"operationId":"searchQuotes","summary":"Find quotes with designs matching the filters; pagination counts quotes","parameters":[{"name":"q","in":"query","schema":{"type":"string","maxLength":200}},{"name":"collection","in":"query","schema":{"type":"string","enum":["star-trek","seinfeld","the-sopranos","the-simpsons","community","brooklyn-nine-nine","stand-up"]}},{"name":"series","in":"query","schema":{"type":"string","enum":["tng","ds9","voyager","enterprise","seinfeld","the-sopranos","the-simpsons","community","brooklyn-nine-nine","norm-macdonald","louis-ck","shane-gillis","john-mulaney"]}},{"name":"quote","in":"query","schema":{"type":"string","maxLength":120,"pattern":"^[a-z0-9-]+$"}},{"name":"style","in":"query","schema":{"type":"string","enum":["abstract","geometric","minimal","textured","typographic"]}},{"name":"color","in":"query","schema":{"type":"string","enum":["black","blue","cream","gold","green","pink","purple","red"]}},{"name":"size","in":"query","schema":{"type":"string","enum":["medium","large"]}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":48,"default":24}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":100000,"default":0}}],"responses":{"200":{"description":"Matching quotes; designCount counts matching designs","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["revision","mode","total","limit","offset","next","items"],"properties":{"revision":{"type":"string"},"mode":{"type":"string","enum":["demo","gallery-test","published"]},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"next":{"type":["string","null"],"format":"uri"},"items":{"type":"array","items":{"$ref":"#/components/schemas/Quote"}}}}}}},"400":{"description":"Invalid request or missing record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/quotes/{slug}":{"get":{"operationId":"getQuote","summary":"Get every visible design of one quote, with images and configuration links","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Quote and all designs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteDetail"}}}},"404":{"description":"Invalid request or missing record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Poster":{"type":"object","additionalProperties":false,"required":["id","slug","title","printedText","description","context","collection","series","styles","colors","quoteSlug","quoteUrl","visualDescription","material","designApprovedForSale","productFactsStatus","framed","sample","revision","url","image","variants"],"properties":{"id":{"type":"string"},"slug":{"type":"string"},"title":{"type":"string"},"printedText":{"type":"string"},"description":{"type":"string"},"context":{"type":"string"},"collection":{"type":"string"},"quoteSlug":{"type":"string"},"visualDescription":{"type":"string"},"revision":{"type":"string"},"material":{"type":["string","null"]},"designApprovedForSale":{"type":"boolean"},"productFactsStatus":{"type":"string","enum":["partially-reviewed","pending"]},"series":{"type":"string","enum":["tng","ds9","voyager","enterprise","seinfeld","the-sopranos","the-simpsons","community","brooklyn-nine-nine","norm-macdonald","louis-ck","shane-gillis","john-mulaney"]},"styles":{"type":"array","items":{"type":"string","enum":["abstract","geometric","minimal","textured","typographic"]}},"colors":{"type":"array","items":{"type":"string","enum":["black","blue","cream","gold","green","pink","purple","red"]}},"quoteUrl":{"type":"string","format":"uri"},"framed":{"type":"boolean"},"sample":{"type":"boolean"},"url":{"type":"string","format":"uri"},"image":{"$ref":"#/components/schemas/Image"},"variants":{"type":"array","minItems":2,"maxItems":8,"items":{"type":"object","additionalProperties":false,"required":["id","size","framing","frameColor","widthIn","heightIn","widthCm","heightCm","priceCents","currency","available","material","includedItems","image","url","buyUrl"],"properties":{"id":{"type":"string"},"size":{"type":"string","enum":["medium","large"]},"framing":{"type":"string","enum":["unframed","framed"]},"frameColor":{"type":["string","null"],"enum":["black","white","red-oak",null]},"widthIn":{"type":"number"},"heightIn":{"type":"number"},"widthCm":{"type":"number"},"heightCm":{"type":"number"},"priceCents":{"type":"integer","minimum":1},"currency":{"type":"string","const":"USD"},"available":{"type":"boolean"},"material":{"type":["string","null"]},"includedItems":{"type":["array","null"],"items":{"type":"string"}},"image":{"type":["string","null"],"format":"uri"},"url":{"type":"string","format":"uri"},"buyUrl":{"type":"string","format":"uri"}}}}}},"Image":{"type":"object","additionalProperties":false,"required":["url","alt","width","height"],"properties":{"url":{"type":"string","format":"uri"},"alt":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}},"Quote":{"type":"object","additionalProperties":false,"required":["slug","printedText","collection","series","seriesName","designCount","designIds","url","image"],"properties":{"slug":{"type":"string"},"printedText":{"type":"string"},"collection":{"type":"string"},"series":{"type":"string","enum":["tng","ds9","voyager","enterprise","seinfeld","the-sopranos","the-simpsons","community","brooklyn-nine-nine","norm-macdonald","louis-ck","shane-gillis","john-mulaney"]},"seriesName":{"type":"string"},"designCount":{"type":"integer"},"designIds":{"type":"array","items":{"type":"string"}},"url":{"type":"string","format":"uri"},"image":{"$ref":"#/components/schemas/Image"}}},"QuoteDetail":{"type":"object","additionalProperties":false,"required":["slug","printedText","collection","series","seriesName","designCount","designIds","url","image","designs"],"properties":{"slug":{"type":"string"},"printedText":{"type":"string"},"collection":{"type":"string"},"series":{"type":"string","enum":["tng","ds9","voyager","enterprise","seinfeld","the-sopranos","the-simpsons","community","brooklyn-nine-nine","norm-macdonald","louis-ck","shane-gillis","john-mulaney"]},"seriesName":{"type":"string"},"designCount":{"type":"integer"},"designIds":{"type":"array","items":{"type":"string"}},"url":{"type":"string","format":"uri"},"image":{"$ref":"#/components/schemas/Image"},"designs":{"type":"array","items":{"$ref":"#/components/schemas/Poster"}}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}