Football-Data

{
  "service_type": "platform",
  "base_url": "https://www.football-data.org",
  "auth_method": "api_key",
  "auth_config": {
    "header_name": "X-Auth-Token",
    "api_key_required": true
  },
  "endpoints": [
    {
      "path": "/v4/competitions",
      "method": "GET",
      "description": "List all available competitions"
    },
    {
      "path": "/v4/competitions/{competitionCode}",
      "method": "GET",
      "description": "Get details of a specific competition"
    },
    {
      "path": "/v4/competitions/{competitionCode}/matches",
      "method": "GET",
      "description": "List matches for a competition"
    },
    {
      "path": "/v4/matches",
      "method": "GET",
      "description": "List matches across competitions (with filters)"
    },
    {
      "path": "/v4/matches/{matchId}",
      "method": "GET",
      "description": "Get details of a specific match"
    },
    {
      "path": "/v4/teams",
      "method": "GET",
      "description": "List teams (with filters)"
    },
    {
      "path": "/v4/teams/{teamId}",
      "method": "GET",
      "description": "Get details of a specific team"
    },
    {
      "path": "/v4/teams/{teamId}/matches",
      "method": "GET",
      "description": "List matches for a specific team"
    },
    {
      "path": "/v4/persons/{personId}",
      "method": "GET",
      "description": "Get details of a specific player/person"
    },
    {
      "path": "/v4/persons/{personId}/matches",
      "method": "GET",
      "description": "List matches for a specific player"
    }
  ],
  "pricing_model": {
    "type": "freemium",
    "details": {
      "free_tier": "Limited API calls per day (e.g., 10 requests/minute, 30 requests/day)",
      "paid_tiers": ["Pro", "Ultra"],
      "cost": "Subscription-based pricing with monthly fees"
    }
  },
  "rate_limits": {
    "free": {
      "requests_per_minute": 10,
      "requests_per_day": 30,
      "note": "Rate limits may vary; check official docs."
    },
    "pro": {
      "requests_per_minute": 30,
      "requests_per_day": 3000,
      "note": "Exact limits on official site."
    },
    "ultra": {
      "requests_per_minute": 60,
      "requests_per_day": 20000,
      "note": "Exact limits on official site."
    }
  },
  "capabilities": [
    "Football match data",
    "Competition fixtures and results",
    "Team information and rosters",
    "Player profiles and statistics",
    "Live scores and schedules",
    "Standings and tables",
    "Historical match data",
    "Filter by date, competition, status"
  ],
  "raw_analysis": "Football-Data.org is a specialized API platform providing structured football (soccer) data for developers and data enthusiasts. It offers comprehensive coverage of competitions (e.g., Premier League, La Liga, Champions League) with endpoints for matches, teams, and players. The platform is mature, well-documented, and widely used in hobbyist and professional projects. It uses a REST API with versioned endpoints (v4) and requires an API key for authentication. The service follows a freemium model: a free tier gives limited access, while paid tiers (Pro, Ultra) increase rate limits and data availability. It stands out for its simplicity and reliability, though it may lack real-time streaming capabilities. Integrations are primarily through direct HTTP requests; no official SDKs but community wrappers exist. The platform is suitable for web apps, data analytics, and football-related applications."
}

2/3 tests passed

```json
{
  "overall": 72,
  "dimensions": {
    "token_efficiency": 7.5,
    "first_try_success": 8.0,
    "response_parseability": 4.0,
    "error_clarity": 6.5,
    "doc_quality": 8.0,
    "auth_simplicity": 9.0,
    "latency": 8.0,
    "consistency": 8.0
  },
  "pricing_normalized": {
    "free_tier": "Limited (10 req/min, 30 req/day)",
    "paid_tiers": "Pro, Ultra (monthly subscription)"
  },
  "issues": [
    "No structured data export (LLMs.txt or similar), agents must parse HTML/API responses manually",
    "Free tier rate limits are restrictive for testing/heavy automation",
    "No llms.txt file for AI agents to quickly discover API schema"
  ],
  "recommendations": [
    "Add an llms.txt file or OpenAPI spec endpoint to reduce agent parsing effort",
    "Provide clear error codes and human-readable error messages in API responses",
    "Consider raising free tier limits to enable more agent-driven exploration"
  ]
}
```