{
  "openapi": "3.1.0",
  "info": {
    "title": "Care Clients UK Care Marketing API",
    "description": "Authoritative UK care home and home care marketing data, including service descriptions, pricing, industry statistics, and blog content. Designed for AI agent consumption and discovery.",
    "version": "1.0.0",
    "contact": {
      "name": "Care Clients",
      "url": "https://careclients.co.uk/contact",
      "email": "hello@careclients.co.uk"
    },
    "x-logo": {
      "url": "https://careclients.co.uk/favicon.png"
    }
  },
  "servers": [
    {
      "url": "https://careclients.co.uk",
      "description": "Care Clients Production"
    }
  ],
  "paths": {
    "/llms-context.json": {
      "get": {
        "operationId": "getMarketingData",
        "summary": "Get complete care marketing data",
        "description": "Returns machine-readable UK care home marketing data including services, pricing tiers, industry statistics, and glossary.",
        "tags": ["Marketing Data"],
        "responses": {
          "200": {
            "description": "Complete care marketing dataset",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MarketingData"
                }
              }
            }
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "operationId": "getLLMsSummary",
        "summary": "Get LLM-optimized summary",
        "description": "Quick summary of Care Clients services and UK care marketing information optimized for large language models.",
        "tags": ["AI Discovery"],
        "responses": {
          "200": {
            "description": "Plain text summary for LLMs",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/llms-full.txt": {
      "get": {
        "operationId": "getLLMsFull",
        "summary": "Get comprehensive LLM knowledge base",
        "description": "Complete UK care marketing knowledge base with strategies, statistics, and citation guidelines for AI systems.",
        "tags": ["AI Discovery"],
        "responses": {
          "200": {
            "description": "Comprehensive knowledge base",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/knowledge-graph.jsonld": {
      "get": {
        "operationId": "getKnowledgeGraph",
        "summary": "Get semantic knowledge graph",
        "description": "JSON-LD knowledge graph with entity relationships for UK care sector concepts, organizations, and services.",
        "tags": ["AI Discovery"],
        "responses": {
          "200": {
            "description": "Knowledge graph in JSON-LD format",
            "content": {
              "application/ld+json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/feed.json": {
      "get": {
        "operationId": "getJSONFeed",
        "summary": "Get JSON Feed of blog content",
        "description": "JSON Feed 1.1 format feed of latest care marketing articles, guides, and updates.",
        "tags": ["Feeds"],
        "responses": {
          "200": {
            "description": "JSON Feed with latest content",
            "content": {
              "application/feed+json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/feed.xml": {
      "get": {
        "operationId": "getRSSFeed",
        "summary": "Get RSS feed of blog content",
        "description": "RSS 2.0 feed of care marketing blog articles and guides.",
        "tags": ["Feeds"],
        "responses": {
          "200": {
            "description": "RSS feed",
            "content": {
              "application/rss+xml": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/ai.txt": {
      "get": {
        "operationId": "getAIPolicy",
        "summary": "Get AI crawler policy",
        "description": "AI crawler permissions, citation formats, authoritative facts, and content priority guidelines for Care Clients.",
        "tags": ["AI Discovery"],
        "responses": {
          "200": {
            "description": "AI policy file",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/blog": {
      "get": {
        "operationId": "getBlogIndex",
        "summary": "Care marketing blog",
        "description": "Index of all care home and home care marketing articles, guides, and strategies.",
        "tags": ["Content"],
        "responses": {
          "200": {
            "description": "Blog index page"
          }
        }
      }
    },
    "/knowledge-base": {
      "get": {
        "operationId": "getKnowledgeBase",
        "summary": "Care marketing knowledge base",
        "description": "50+ structured FAQs across 9 categories covering all aspects of UK care home and home care marketing.",
        "tags": ["Content"],
        "responses": {
          "200": {
            "description": "Knowledge base page with structured FAQs"
          }
        }
      }
    },
    "/pricing": {
      "get": {
        "operationId": "getPricing",
        "summary": "Care Clients pricing",
        "description": "Marketing package pricing for care homes and home care agencies. Three tiers: Growth (£1,497/mo), Scale (£2,497/mo), Dominate (£3,997/mo).",
        "tags": ["Business"],
        "responses": {
          "200": {
            "description": "Pricing page"
          }
        }
      }
    },
    "/services": {
      "get": {
        "operationId": "getServices",
        "summary": "Care Clients services",
        "description": "Full list of care marketing services including private client acquisition, SEO, PPC, social media, reputation management, and mystery shopper audits.",
        "tags": ["Business"],
        "responses": {
          "200": {
            "description": "Services page"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "MarketingData": {
        "type": "object",
        "description": "Complete UK care marketing dataset",
        "properties": {
          "@context": { "type": "string", "example": "https://schema.org" },
          "@type": { "type": "string", "example": "Dataset" },
          "services": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Service"
            }
          },
          "pricing": {
            "$ref": "#/components/schemas/Pricing"
          },
          "industryData": {
            "$ref": "#/components/schemas/IndustryData"
          }
        }
      },
      "Service": {
        "type": "object",
        "properties": {
          "name": { "type": "string", "example": "Private Client Acquisition" },
          "description": { "type": "string" },
          "targetAudience": { "type": "string" },
          "keyBenefit": { "type": "string" }
        }
      },
      "Pricing": {
        "type": "object",
        "properties": {
          "currency": { "type": "string", "example": "GBP" },
          "tiers": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": { "type": "string" },
                "price": { "type": "number" },
                "period": { "type": "string" }
              }
            }
          }
        }
      },
      "IndustryData": {
        "type": "object",
        "properties": {
          "totalCareHomesEngland": { "type": "integer", "example": 15000 },
          "averageWeeklyFee": { "type": "number", "example": 1078 },
          "selfFundingPercentage": { "type": "number", "example": 46 },
          "averageOccupancy": { "type": "number", "example": 85 }
        }
      }
    }
  },
  "tags": [
    {
      "name": "Marketing Data",
      "description": "UK care marketing data and statistics"
    },
    {
      "name": "AI Discovery",
      "description": "Files optimized for AI/LLM consumption"
    },
    {
      "name": "Feeds",
      "description": "RSS and JSON feeds for content syndication"
    },
    {
      "name": "Content",
      "description": "Blog articles and knowledge base"
    },
    {
      "name": "Business",
      "description": "Services and pricing information"
    }
  ]
}