espn-api

Fetch ESPN sports data by constructing URLs with the correct sport/league slug and applying the v2 vs site/v2 standings path rule. The Skill provides URL-building patterns, CDN xhr=1 parameters, and Python fetch scripts to retrieve scores, rosters, and player stats accurately.

ESPN API requests often fail due to incorrect league slugs, missing CDN xhr=1 parameters, or wrong date/pagination formats. Using the correct sport/league slug selection and applying the documented v2 vs site/v2 path rules ensures the JSON response populates correctly.

Parse $ref linked objects in ESPN API responses by following the annotated schema examples to resolve references to other JSON resources. The Skill aligns parsing logic with documented JSON shapes to traverse these linked objects across Core API and CDN endpoints.

You can use the included Python CLI fetch scripts to pull ESPN CDN game packages, game summaries, and athlete stats. These scripts apply the required xhr=1 parameter and handle pagination limits to retrieve data from the CDN endpoints.

Find ESPN league slugs for soccer and rugby using the comprehensive league-slug reference included in the Skill. Soccer uses dot-slugs while rugby uses numeric IDs, and selecting the correct slug is required to build functional API URLs.

The ESPN undocumented API has pagination limits and requires rate-limit handling when fetching large datasets. The Skill provides guidance on applying required date and pagination parameters to manage these constraints and avoid hitting rate limits.