TheSportsDB

{
  "service_type": "platform",
  "base_url": "https://www.thesportsdb.com/api/",
  "auth_method": "api_key",
  "auth_config": {
    "api_key_required": true,
    "header": "x-api-key",
    "query_param": "apiKey"
  },
  "endpoints": [
    {
      "name": "lookup_all_teams",
      "method": "GET",
      "path": "/api/v1/json/{APIKEY}/lookup_all_teams.php?id={league_id}",
      "description": "Returns all teams in a league"
    },
    {
      "name": "lookupteam",
      "method": "GET",
      "path": "/api/v1/json/{APIKEY}/lookupteam.php?id={team_id}",
      "description": "Returns team details by ID"
    },
    {
      "name": "searchteams",
      "method": "GET",
      "path": "/api/v1/json/{APIKEY}/searchteams.php?t={team_name}",
      "description": "Search for teams by name"
    },
    {
      "name": "eventsseason",
      "method": "GET",
      "path": "/api/v1/json/{APIKEY}/eventsseason.php?id={league_id}&s={season}",
      "description": "Returns all events for a season"
    },
    {
      "name": "lookupevent",
      "method": "GET",
      "path": "/api/v1/json/{APIKEY}/lookupevent.php?id={event_id}",
      "description": "Returns event details by ID"
    },
    {
      "name": "searchplayers",
      "method": "GET",
      "path": "/api/v1/json/{APIKEY}/searchplayers.php?p={player_name}",
      "description": "Search for players by name"
    },
    {
      "name": "lookuplayer",
      "method": "GET",
      "path": "/api/v1/json/{APIKEY}/lookuplayer.php?id={player_id}",
      "description": "Returns player details by ID"
    },
    {
      "name": "all_leagues",
      "method": "GET",
      "path": "/api/v1/json/{APIKEY}/all_leagues.php",
      "description": "Returns all leagues"
    },
    {
      "name": "all_sports",
      "method": "GET",
      "path": "/api/v1/json/{APIKEY}/all_sports.php",
      "description": "Returns all sports"
    },
    {
      "name": "list_all_events",
      "method": "GET",
      "path": "/api/v1/json/{APIKEY}/eventsday.php?d={date}",
      "description": "Returns all events for a specific date"
    },
    {
      "name": "lookupevent_tv",
      "method": "GET",
      "path": "/api/v1/json/{APIKEY}/lookupevent_tv.php?id={event_id}",
      "description": "Returns TV listings for an event"
    },
    {
      "name": "searchtts",
      "method": "GET",
      "path": "/api/v1/json/{APIKEY}/searchtts.php?tt={team_name}",
      "description": "Search for team thumbnails"
    },
    {
      "name": "searchhonours",
      "method": "GET",
      "path": "/api/v1/json/{APIKEY}/searchhonours.php?t={team_name}",
      "description": "Search for team honours"
    },
    {
      "name": "lookupmilestones",
      "method": "GET",
      "path": "/api/v1/json/{APIKEY}/lookupmilestones.php?id={player_id}",
      "description": "Returns player milestones"
    },
    {
      "name": "lookupcontract",
      "method": "GET",
      "path": "/api/v1/json/{APIKEY}/lookupcontract.php?id={player_id}",
      "description": "Returns player contracts"
    },
    {
      "name": "lookupvenues",
      "method": "GET",
      "path": "/api/v1/json/{APIKEY}/lookupvenues.php?id={venue_id}",
      "description": "Returns venue details"
    },
    {
      "name": "searchvenues",
      "method": "GET",
      "path": "/api/v1/json/{APIKEY}/searchvenues.php?t={venue_name}",
      "description": "Search venues by name"
    },
    {
      "name": "searchleagues",
      "method": "GET",
      "path": "/api/v1/json/{APIKEY}/searchleagues.php?l={league_name}",
      "description": "Search leagues by name"
    }
  ],
  "pricing_model": {
    "type": "freemium",
    "details": {
      "free_tier": {
        "limits": "Free tier with limited requests per day (approx 1000/day) and limited features.",
        "features": "Basic access to data and artwork, with delayed updates."
      },
      "premium_tier": "Paid subscription available starting at $5/month (approx) with higher rate limits, additional features like real-time data, no delays, and access to full artwork."
    }
  },
  "rate_limits": {
    "free_tier": {
      "requests_per_day": 1000,
      "requests_per_second": 10
    },
    "premium_tier": {
      "requests_per_second": 50
    }
  },
  "capabilities": [
    "Access to sports data (teams, players, events, leagues, venues) for multiple sports including soccer, basketball, baseball, hockey, rugby, NFL, and more.",
    "Artwork images for teams, players, and events (logos, thumbnails, banners).",
    "Event schedules and results across leagues and seasons.",
    "Player profiles with biographical info, stats, contracts, milestones, honours.",
    "TV listings for sports events.",
    "Search functionality for teams, players, leagues, venues.",
    "Crowd-sourced data with editor contributions.",
    "API supports JSON output and images via URLs.",
    "Free tier available with limitations; premium tier for extended access."
  ],
  "raw_analysis": "TheSportsDB is a freemium, crowd-sourced sports data plat

0/3 tests passed

```json
{
  "overall": 52,
  "dimensions": {
    "token_efficiency": 6.5,
    "first_try_success": 5.0,
    "response_parseability": 8.0,
    "error_clarity": 4.0,
    "doc_quality": 4.0,
    "auth_simplicity": 5.0,
    "latency": 7.5,
    "consistency": 6.0
  },
  "pricing_normalized": {
    "free_tier": {
      "requests_per_day": 1000,
      "cost": 0
    },
    "premium_tier": {
      "monthly_cost_usd": 5,
      "features": "Real-time data, no delays, full artwork"
    }
  },
  "issues": [
    "Website root returns 403 Forbidden (likely blocking automated scans, but also indicates lack of a public entry point for agents)",
    "No robots.txt (404) — agents cannot discover crawl rules",
    "No llms.txt (404) — no machine-readable documentation for LLM agents",
    "No security headers detected, suggesting minimal attention to modern web standards",
    "Documentation quality unknown — no ability to automatically verify endpoints or usage examples",
    "Crowd-sourced data model may have variable quality and consistency across sports/leagues"
  ],
  "recommendations": [
    "Publish an llms.txt file with API overview, endpoint examples, and authentication instructions",
    "Create a publicly accessible robots.txt to signal crawl allowances to agents",
    "Provide structured OpenAPI/Swagger specs to improve response parseability and first-try success",
    "Add example requests/responses in documentation to reduce onboarding friction",
    "Clarify rate limits, data freshness, and update schedules for the free tier directly in docs",
    "Consider offering API key via simple signup (magic link or OAuth) rather than manual approval"
  ]
}
```