{"openapi":"3.1.0","info":{"title":"PromptKit Public API","version":"1.0.0","description":"Public machine-readable API and prompt catalog for PromptKit (https://www.promptkit.app), the AI prompt generator and library for iOS. Enables AI agents and developers to search, inspect, and retrieve curated prompt templates across marketing, coding, copywriting, productivity, strategy, and AI art.","termsOfService":"https://www.promptkit.app/terms","contact":{"name":"LukyLab s.r.o. Support","email":"support@luckyapps.dev","url":"https://www.promptkit.app"},"license":{"name":"Proprietary / Creative Commons Attribution 4.0 for Sample Prompts","url":"https://www.promptkit.app/terms"}},"servers":[{"url":"https://www.promptkit.app","description":"Production Server"}],"paths":{"/api/prompts":{"get":{"summary":"List prompt categories and templates","description":"Retrieve all curated prompt categories and their prompt templates, with optional filtering by search keyword, category slug, and tag.","operationId":"getPrompts","parameters":[{"name":"q","in":"query","required":false,"description":"Search keyword matching in prompt title, description, or template text","schema":{"type":"string"}},{"name":"category","in":"query","required":false,"description":"Filter by category slug (e.g. 'coding-prompts-for-developers')","schema":{"type":"string"}},{"name":"tag","in":"query","required":false,"description":"Filter by tag name (e.g. 'Security', 'SEO', 'Paid Ads')","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Maximum number of prompts to return (1-100, default 50)","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}}],"responses":{"200":{"description":"Successful retrieval of categories and prompts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromptsListResponse"}}}},"400":{"description":"Invalid query parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/prompts/{slug}":{"get":{"summary":"Get prompt category by slug","description":"Retrieve full details and all prompt templates for a specific category slug.","operationId":"getPromptCategoryBySlug","parameters":[{"name":"slug","in":"path","required":true,"description":"Category slug identifier (e.g. 'coding-prompts-for-developers')","schema":{"type":"string"}}],"responses":{"200":{"description":"Category details and prompt templates","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromptCategoryDetailResponse"}}}},"404":{"description":"Category not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/openapi.json":{"get":{"summary":"Retrieve OpenAPI 3.1 Specification","description":"Returns the complete OpenAPI schema for PromptKit APIs.","operationId":"getOpenApiSpec","responses":{"200":{"description":"OpenAPI specification JSON","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/llms.txt":{"get":{"summary":"Retrieve LLMs.txt summary","description":"Returns markdown-formatted overview and high-level context optimized for AI agents and LLM scrapers.","operationId":"getLlmsTxt","responses":{"200":{"description":"Plain text LLM context file","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/llms-full.txt":{"get":{"summary":"Retrieve LLMs-full.txt full documentation","description":"Returns complete prompt library recipes and detailed taxonomy for LLMs.","operationId":"getLlmsFullTxt","responses":{"200":{"description":"Plain text full LLM reference file","content":{"text/plain":{"schema":{"type":"string"}}}}}}}},"components":{"schemas":{"PromptTemplate":{"type":"object","required":["id","title","description","promptText","modelRecommendation","tags"],"properties":{"id":{"type":"string","example":"code-1"},"categorySlug":{"type":"string","example":"coding-prompts-for-developers"},"categoryTitle":{"type":"string","example":"Coding & Architecture"},"title":{"type":"string","example":"Deep Code Review & Security Audit"},"description":{"type":"string","example":"Uncover memory leaks, race conditions, edge cases, and security flaws."},"promptText":{"type":"string","example":"Act as a Principal Software Engineer performing a rigorous code review..."},"modelRecommendation":{"type":"string","example":"Claude / ChatGPT"},"tags":{"type":"array","items":{"type":"string"},"example":["Code Quality","Security","Refactoring"]}}},"PromptCategorySummary":{"type":"object","required":["slug","title","shortTitle","headline","description","targetKeywords","promptCount","url"],"properties":{"slug":{"type":"string","example":"coding-prompts-for-developers"},"title":{"type":"string","example":"AI Coding & Architecture Prompts for Developers"},"shortTitle":{"type":"string","example":"Coding & Architecture"},"headline":{"type":"string","example":"Reliable Prompts for Software Engineering & Code Review"},"description":{"type":"string","example":"Level up your development workflow with prompts designed for code refactoring..."},"targetKeywords":{"type":"array","items":{"type":"string"}},"promptCount":{"type":"integer","example":3},"url":{"type":"string","example":"https://www.promptkit.app/prompts/coding-prompts-for-developers"}}},"PromptCategoryDetail":{"type":"object","required":["slug","title","shortTitle","headline","description","metaDescription","targetKeywords","iconName","url","prompts"],"properties":{"slug":{"type":"string","example":"coding-prompts-for-developers"},"title":{"type":"string","example":"AI Coding & Architecture Prompts for Developers"},"shortTitle":{"type":"string","example":"Coding & Architecture"},"headline":{"type":"string","example":"Reliable Prompts for Software Engineering & Code Review"},"description":{"type":"string","example":"Level up your development workflow..."},"metaDescription":{"type":"string"},"targetKeywords":{"type":"array","items":{"type":"string"}},"iconName":{"type":"string","example":"CommandLineIcon"},"url":{"type":"string","example":"https://www.promptkit.app/prompts/coding-prompts-for-developers"},"prompts":{"type":"array","items":{"$ref":"#/components/schemas/PromptTemplate"}}}},"PromptsListResponse":{"type":"object","required":["categories","prompts","totalCategories","totalPrompts"],"properties":{"categories":{"type":"array","items":{"$ref":"#/components/schemas/PromptCategorySummary"}},"prompts":{"type":"array","items":{"$ref":"#/components/schemas/PromptTemplate"}},"totalCategories":{"type":"integer","example":6},"totalPrompts":{"type":"integer","example":15}}},"PromptCategoryDetailResponse":{"type":"object","required":["category"],"properties":{"category":{"$ref":"#/components/schemas/PromptCategoryDetail"}}},"ErrorResponse":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","status"],"properties":{"code":{"type":"string","example":"NOT_FOUND"},"message":{"type":"string","example":"The requested resource was not found."},"status":{"type":"integer","example":404},"hint":{"type":"string","example":"Check /api/prompts for available endpoints."},"documentation_url":{"type":"string","example":"https://www.promptkit.app/openapi.json"},"invalid_params":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"reason":{"type":"string"}}}}}}}}}}}