{"openapi":"3.1.0","info":{"title":"AnimatedWebs public catalog API","version":"1.0.0","description":"Anonymous, read-only template metadata. Prompts, specs, source code and demo files are licensed and are never returned here; signed-in agents use the MCP server instead. Licensing rules: /llms.txt.","contact":{"name":"AnimatedWebs (Like a King Inc.)","url":"https://animatedwebs.com/contact"},"termsOfService":"https://animatedwebs.com/terms"},"servers":[{"url":"https://animatedwebs.com"}],"security":[],"externalDocs":{"description":"Agent guide","url":"https://animatedwebs.com/agents.md"},"paths":{"/api/templates":{"get":{"operationId":"listTemplates","summary":"List or look up published templates (metadata only)","description":"Without slug, returns a filtered, paginated list. With slug, returns that one template or 404. Responses allow any origin (CORS *) and are cached for 5 minutes.","parameters":[{"name":"slug","in":"query","required":false,"description":"Return one template by slug. Other parameters are ignored.","schema":{"type":"string"}},{"name":"q","in":"query","required":false,"description":"Space-separated words; every word must appear in the title, tagline, category, tags or stack (case-insensitive).","schema":{"type":"string"}},{"name":"kind","in":"query","required":false,"description":"Exact kind.","schema":{"type":"string","enum":["website","section","background","component"]}},{"name":"category","in":"query","required":false,"description":"Exact category.","schema":{"type":"string","enum":["AI / SaaS","3D / WebGL","Storytelling","Editorial","Portfolio","Agency","Fintech","Web3","Ecommerce","Fashion & Luxury","Food & Hospitality","Health & Wellness","Real Estate & Architecture","Automotive","Gaming & Entertainment","Music & Events","Travel","Education","Nonprofit"]}},{"name":"access","in":"query","required":false,"description":"Free or Pro.","schema":{"type":"string","enum":["free","pro"]}},{"name":"demo","in":"query","required":false,"description":"1 returns only templates with a live demo.","schema":{"type":"string","enum":["1"]}},{"name":"page","in":"query","required":false,"description":"Page number, from 1.","schema":{"type":"integer","minimum":1,"default":1}},{"name":"per","in":"query","required":false,"description":"Items per page, 1 to 100.","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}}],"responses":{"200":{"description":"A page of templates, or one template when slug is set.","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/TemplatePage"},{"$ref":"#/components/schemas/Template"}]}}}},"404":{"description":"No template with that slug.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}}}}}},"/api/search":{"get":{"operationId":"search","summary":"Search templates and UI components","description":"Up to 8 templates and 6 UI components for a query. Words shorter than 2 characters are ignored; an empty query returns empty lists. Limited to 60 requests per minute per IP.","parameters":[{"name":"q","in":"query","required":false,"description":"Search text, up to 120 characters.","schema":{"type":"string"}}],"responses":{"200":{"description":"Matching templates and components.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResult"}}}},"429":{"description":"Rate limited.","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimited"}}}}}}}},"components":{"schemas":{"Template":{"type":"object","required":["slug","title","tagline","kind","category","access","tags","stack","url","demo","preview"],"properties":{"slug":{"type":"string"},"title":{"type":"string"},"tagline":{"type":"string"},"kind":{"type":"string","enum":["website","section","background","component"]},"category":{"type":"string","enum":["AI / SaaS","3D / WebGL","Storytelling","Editorial","Portfolio","Agency","Fintech","Web3","Ecommerce","Fashion & Luxury","Food & Hospitality","Health & Wellness","Real Estate & Architecture","Automotive","Gaming & Entertainment","Music & Events","Travel","Education","Nonprofit"]},"access":{"type":"string","enum":["free","pro"]},"tags":{"type":"array","items":{"type":"string"}},"stack":{"type":"array","items":{"type":"string"}},"url":{"type":"string","format":"uri","description":"Canonical template page."},"demo":{"type":["string","null"],"format":"uri","description":"Live demo URL, or null."},"preview":{"type":["string","null"],"format":"uri","description":"Preview image URL, or null."}}},"TemplatePage":{"type":"object","required":["total","page","per","pages","items"],"properties":{"total":{"type":"integer"},"page":{"type":"integer"},"per":{"type":"integer"},"pages":{"type":"integer"},"items":{"type":"array","items":{"$ref":"#/components/schemas/Template"}}}},"SearchTemplate":{"type":"object","properties":{"slug":{"type":"string"},"title":{"type":"string"},"tagline":{"type":"string"},"category":{"type":"string"},"access":{"type":"string","enum":["free","pro"]},"kind":{"type":"string","description":"Human label, e.g. Website template."},"image":{"type":["string","null"]},"demo":{"type":"boolean"},"url":{"type":"string","description":"Site-relative template path."}}},"SearchComponent":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"category":{"type":"string"},"thumbnail":{"type":["string","null"]},"url":{"type":"string"}}},"SearchResult":{"type":"object","required":["templates","components"],"properties":{"templates":{"type":"array","items":{"$ref":"#/components/schemas/SearchTemplate"}},"components":{"type":"array","items":{"$ref":"#/components/schemas/SearchComponent"}}}},"NotFound":{"type":"object","properties":{"error":{"type":"string","const":"not_found"}}},"RateLimited":{"type":"object","properties":{"error":{"type":"string","const":"rate_limited"},"retry_after":{"type":"integer"}}}}}}