CollegeFootballData.com

{
  "service_type": "platform",
  "base_url": "https://collegefootballdata.com",
  "auth_method": "api_key",
  "auth_config": {
    "key_name": "Authorization",
    "key_prefix": "Bearer",
    "key_source": "header"
  },
  "endpoints": [
    {
      "path": "/api/games",
      "method": "GET",
      "description": "Retrieve college football games data with filters (year, week, team, etc.)"
    },
    {
      "path": "/api/teams",
      "method": "GET",
      "description": "Get team information and statistics"
    },
    {
      "path": "/api/stats",
      "method": "GET",
      "description": "Fetch statistical data (offense, defense, special teams)"
    },
    {
      "path": "/api/rankings",
      "method": "GET",
      "description": "Historical and current rankings (AP, Coaches, Playoff)"
    },
    {
      "path": "/api/recruiting",
      "method": "GET",
      "description": "Recruiting rankings and player ratings"
    },
    {
      "path": "/api/draft",
      "method": "GET",
      "description": "NFL Draft information and player prospects"
    }
  ],
  "pricing_model": {
    "type": "freemium",
    "details": {
      "free_tier": "Limited API calls per day",
      "paid_plans": "Subscription tiers for higher rate limits and premium features",
      "description": "Free access up to 1000 API calls per day, with paid plans for higher volumes and additional features"
    }
  },
  "rate_limits": {
    "free": "1000 calls per day",
    "paid": "Higher limits based on subscription tier"
  },
  "capabilities": [
    "Detailed American college football statistics (games, teams, players)",
    "Historical data dating back to 1869",
    "Rankings and polls (AP, Coaches, College Football Playoff)",
    "Recruiting data and player ratings",
    "NFL Draft prospects and information",
    "Play-by-play data for many games",
    "API access with RESTful endpoints",
    "JSON responses"
  ],
  "raw_analysis": "CollegeFootballData.com is an unofficial API providing comprehensive American college football data. It aggregates statistics, game results, team information, rankings, recruiting, and draft data. The platform is community-driven and has been actively maintained since 2017. It serves developers, analysts, fantasy sports platforms, and researchers. The service offers a free tier (1000 calls/day) with paid plans for higher limits and premium features. Authentication is via an API key in the Authorization header. The API is well-documented with consistent JSON responses. It integrates with various sports analysis tools and has been used in academic and hobbyist projects. Maturity is high, with reliable uptime and regular updates during seasons."
}

3/3 tests passed

```json
{
  "overall": 78,
  "dimensions": {
    "token_efficiency": 8.0,
    "first_try_success": 7.5,
    "response_parseability": 9.0,
    "error_clarity": 7.0,
    "doc_quality": 8.5,
    "auth_simplicity": 6.5,
    "latency": 9.0,
    "consistency": 8.0
  },
  "pricing_normalized": {
    "free_tier_calls_per_day": 1000,
    "freemium": true
  },
  "issues": [
    "Missing security headers (no X-Frame-Options, CSP, etc.) — potential risk for programmatic access",
    "llms.txt endpoint returns HTML instead of markdown/text — reduces clarity for AI agents",
    "Free tier limited to 1000 calls/day may require multiple API keys for agent fleets"
  ],
  "recommendations": [
    "Implement proper llms.txt content-type (text/markdown) to improve agent discoverability",
    "Add standard security headers to API responses (especially for key-based access)",
    "Consider providing a dedicated agent-friendly quickstart guide with code examples"
  ]
}
```