{
  "api_name": "CasinosAPI",
  "version": "2.0.0",
  "ai_optimized": true,
  "purpose": "Casino bonus data API with natural language search for AI assistants",
  "base_url": "https://casinosapi.com",
  "discovery": {
    "openapi": "https://casinosapi.com/api-docs/openapi.yaml",
    "endpoints": "https://casinosapi.com/api/index.json",
    "capabilities": "https://casinosapi.com/api/ai-capabilities.json",
    "llms_txt": "https://casinosapi.com/llms.txt"
  },
  "authentication": {
    "required": false,
    "type": "api_key",
    "header": "X-API-Key",
    "query_param": "key",
    "rate_limit": "100 requests/minute",
    "default_key": "grokcasino-api-key-2026-02-24-abcdef123456"
  },
  "endpoints": {
    "search": {
      "path": "/api/search",
      "method": "GET",
      "description": "Natural language search for casino bonuses",
      "ai_use_cases": [
        "Find casinos matching user bonus preferences",
        "Filter by wagering requirements",
        "Discover no-wagering bonuses",
        "Compare offers across casinos"
      ],
      "parameters": {
        "q": {
          "type": "string",
          "required": true,
          "description": "Natural language query",
          "examples": ["200% bonus", "under €500 no wagering", "100 free spins"]
        },
        "location": {
          "type": "string",
          "required": false,
          "description": "ISO country code (e.g., FI, SE, DE)"
        },
        "limit": {
          "type": "integer",
          "default": 20,
          "max": 100
        }
      }
    },
    "casino_detail": {
      "path": "/api/casino",
      "method": "GET",
      "description": "Get detailed information about a specific casino",
      "parameters": {
        "slug": "Casino slug identifier",
        "name": "Casino name (partial match)"
      }
    },
    "compare": {
      "path": "/api/compare",
      "method": "GET",
      "description": "Compare multiple casinos side-by-side",
      "parameters": {
        "casinos": "Comma-separated slugs"
      }
    },
    "bonus_list": {
      "path": "/api/bonus",
      "method": "GET",
      "description": "List all bonuses for a location",
      "parameters": {
        "location": "ISO country code"
      }
    },
    "health": {
      "path": "/api/health",
      "method": "GET",
      "description": "API health check",
      "auth_required": false
    }
  }
}