FRC Events

{
  "service_type": "platform",
  "base_url": "https://frc-events.firstinspires.org",
  "auth_method": "api_key",
  "auth_config": {
    "header": "Authorization",
    "scheme": "Basic",
    "notes": "FIRST requires a registered account (username/password) on frc-events.firstinspires.org; authentication is performed via HTTP Basic Auth using those credentials. An API key/token is issued for programmatic access."
  },
  "endpoints": [
    {
      "name": "Seasons",
      "path": "/api/v3.0/{season}/seasons",
      "method": "GET",
      "description": "List FRC seasons available"
    },
    {
      "name": "Events",
      "path": "/api/v3.0/{season}/events",
      "method": "GET",
      "description": "List all events for a given season"
    },
    {
      "name": "Event",
      "path": "/api/v3.0/{season}/events/{eventCode}",
      "method": "GET",
      "description": "Details for a specific event"
    },
    {
      "name": "Teams",
      "path": "/api/v3.0/{season}/teams",
      "method": "GET",
      "description": "List teams registered in a season"
    },
    {
      "name": "Team",
      "path": "/api/v3.0/{season}/teams/{teamNumber}",
      "method": "GET",
      "description": "Details for a specific team"
    },
    {
      "name": "Matches",
      "path": "/api/v3.0/{season}/matches/{eventCode}",
      "method": "GET",
      "description": "Match results for an event"
    },
    {
      "name": "Rankings",
      "path": "/api/v3.0/{season}/rankings/{eventCode}",
      "method": "GET",
      "description": "Rankings for an event"
    },
    {
      "name": "Alliances",
      "path": "/api/v3.0/{season}/alliances/{eventCode}",
      "method": "GET",
      "description": "Playoff alliance selections for an event"
    },
    {
      "name": "Awards",
      "path": "/api/v3.0/{season}/awards/{eventCode}",
      "method": "GET",
      "description": "Awards given at an event"
    }
  ],
  "pricing_model": {
    "type": "free",
    "details": {
      "notes": "The FRC Events API is provided free of charge by FIRST. Access requires registration for a free account on the FIRST Inspires/FMS platform. Rate limits apply to prevent abuse."
    }
  },
  "rate_limits": {
    "notes": "FIRST publishes rate limiting guidelines; excessive requests may result in temporary throttling or blocking. Specific numeric limits are not consistently documented publicly and may be enforced per-account.",
    "enforcement": "per-account"
  },
  "capabilities": [
    "Query FRC season metadata",
    "Retrieve event schedules and results",
    "Look up team registration and profiles",
    "Access match scores and rankings",
    "Retrieve playoff alliance selections",
    "Fetch event awards",
    "Historical season data access",
    "Structured JSON responses for programmatic consumption"
  ],
  "raw_analysis": "FIRST/ FMS FRC Events API is the official data service for the FIRST Robotics Competition (FRC). It is maintained by FIRST (For Inspiration and Recognition of Science and Technology), the nonprofit that runs the FRC program. The service exposes structured data about seasons, events, teams, matches, rankings, alliances, and awards — essentially the full competitive record of FRC.\n\nTarget users are FRC teams, scouting groups, data analysts, and third-party apps (e.g., The Blue Alliance, Statbotics-adjacent tools, scouting apps) that need programmatic access to competition data. Maturity is high: the API has existed for many years, is versioned (currently v3.0), and is widely relied upon during competition season. It is stable but occasionally subject to load during peak events.\n\nAuthentication is via registered account credentials (username/token) using HTTP Basic Auth, not a public open REST endpoint without auth. Base URL is https://frc-events.firstinspires.org (distinct from the marketing site firstinspires.org). Responses are JSON. There is no formal paid tier; access is free subject to rate limits and acceptable-use expectations. The platform is essentially read-only (GET only) and does not provide write access to event data.\n\nIntegration considerations: consumers typically poll for live match updates during events; caching and backoff strategies are recommended. The API is a canonical source, often complemented by community mirror datasets for bulk historical analysis."
}

1/3 tests passed

{
  "overall": 73,
  "dimensions": {
    "token_efficiency": 8.0,
    "first_try_success": 6.0,
    "response_parseability": 9.0,
    "error_clarity": 7.0,
    "doc_quality": 6.0,
    "auth_simplicity": 6.0,
    "latency": 9.5,
    "consistency": 8.0
  },
  "pricing_normalized": {
    "model": "free",
    "notes": "FIRST provides the FRC Events API free of charge; a free account is required for access. Rate limits apply to prevent abuse."
  },
  "issues": [
    "No robots.txt or llms.txt found (both 404) — agents have no crawl guidance and must rely on inline HTML comments.",
    "Authentication requires registering a free account on the FIRST Inspires/FMS platform, adding friction to first-try success.",
    "Missing security headers on responses.",
    "Documentation quality not verified from checks; likely hosted separately at frc-events.firstinspires.org with possible outdated or scattered references.",
    "Rate limits are mentioned but exact thresholds are not surfaced in provided data.",
    "Website contains anti-scraping messaging recommending API use, which is good guidance but suggests agents could inadvertently hit the wrong endpoint."
  ],
  "recommendations": [
    "Add robots.txt and llms.txt to guide AI agents toward the API endpoint and away from web scraping.",
    "Support 'Sign in with Notlogin' or API key self-service issuance so agents can onboard without manual account creation on FMS.",
    "Publish clear rate-limit documentation and error response schemas to improve error_clarity.",
    "Add security headers (HSTS, CSP, X-Content-Type-Options) to increase trust and consistency perception.",
    "Expose a machine-readable OpenAPI/Swagger spec or JSON schema to boost response_parseability and first_try_success.",
    "Provide curl/example snippets and a getting-started guide directly on the API landing page to improve doc_quality."
  ]
}