{
    "api_version": "2.0",
    "success": true,
    "timestamp": "2026-07-11T18:33:46+02:00",
    "data": {
        "openapi": "3.0.3",
        "info": {
            "title": "AcademyScanner Public API",
            "version": "2.0",
            "description": "API publike read-only për universitete, skanime, rankings dhe regresione."
        },
        "servers": [
            {
                "url": "/api/v2"
            }
        ],
        "paths": {
            "/universities": {
                "get": {
                    "summary": "Listë universitetesh",
                    "parameters": [
                        "page",
                        "limit",
                        "search",
                        "country"
                    ]
                }
            },
            "/universities/{id}": {
                "get": {
                    "summary": "Detaje universiteti"
                }
            },
            "/rankings": {
                "get": {
                    "summary": "Renditja kryesore",
                    "parameters": [
                        "page",
                        "limit"
                    ]
                }
            },
            "/scans/{id}": {
                "get": {
                    "summary": "Detaje skanimi me pikëzime"
                }
            },
            "/scan-diff": {
                "get": {
                    "summary": "Krahasim i dy skanimeve",
                    "parameters": [
                        "a",
                        "b"
                    ]
                }
            },
            "/leaderboard/{category}": {
                "get": {
                    "summary": "Top-N për kategori",
                    "parameters": [
                        "category"
                    ]
                }
            },
            "/regressions": {
                "get": {
                    "summary": "Rënie të fundit të rezultatit"
                }
            },
            "/schema": {
                "get": {
                    "summary": "Ky dokument"
                }
            }
        },
        "auth": {
            "anonymous": "Rate limit 100/orë nga IP",
            "api_key": "X-API-Key header, Bearer token, ose ?api_key=... query param"
        },
        "categories": [
            "overall",
            "security",
            "research",
            "technical",
            "webometrics",
            "presence",
            "accessibility",
            "ssl",
            "email",
            "green",
            "i18n",
            "performance",
            "seo"
        ]
    }
}