{
  "openapi": "3.0.0",
  "info": {
    "title": "Creatorships API",
    "description": "Creatorships AI Creator Intelligence, Influencer Search, and Campaign Automation API.",
    "version": "v1.0.0"
  },
  "servers": [
    {
      "url": "https://api.creatorships.ai",
      "description": "Production API Server"
    },
    {
      "url": "http://localhost:8080",
      "description": "Local Development Server"
    }
  ],
  "paths": {
    "/health": {
      "get": {
        "operationId": "getHealth",
        "summary": "Check API Health Status",
        "description": "Returns the operational health status of the API and its connected services.",
        "responses": {
          "200": {
            "description": "API is healthy",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": { "type": "string", "example": "healthy" },
                    "service": { "type": "string", "example": "creatorships-api" },
                    "timestamp": { "type": "string", "example": "2026-08-22T00:00:00.000Z" }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/public/creators/trending": {
      "get": {
        "operationId": "getTrendingCreators",
        "summary": "Get Trending Creators",
        "description": "Public list of top trending creators with verified engagement rates.",
        "responses": {
          "200": {
            "description": "List of trending creators",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": { "type": "boolean", "example": true },
                    "total": { "type": "integer", "example": 5 },
                    "creators": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": { "type": "string" },
                          "name": { "type": "string" },
                          "handle": { "type": "string" },
                          "platform": { "type": "string" },
                          "followers": { "type": "integer" },
                          "engagement_rate": { "type": "number" },
                          "category": { "type": "string" },
                          "location": { "type": "string" },
                          "verified": { "type": "boolean" }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/public/overview": {
      "get": {
        "operationId": "getPublicOverview",
        "summary": "Get Platform Overview",
        "description": "Platform feature matrix and agent guidance.",
        "responses": {
          "200": {
            "description": "Platform overview",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": { "type": "boolean" },
                    "name": { "type": "string" },
                    "version": { "type": "string" },
                    "description": { "type": "string" },
                    "capabilities": { "type": "array", "items": { "type": "string" } },
                    "documentation": { "type": "string" },
                    "openapi": { "type": "string" },
                    "llms_txt": { "type": "string" }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}