GuidesRelease Log
Coverage MatrixDocumentationChange LogLog InContact Us
Release Log

Simulations – Global API and Cricket Added

We've added Simulations support for four new APIs — Global American Football, Global Basketball, Global Ice Hockey, and Cricket (v2).

These join the existing lineup (NFL, NCAAFB, UFL, NBA, WNBA, NCAAMB, NCAAWB, NBA G League, MLB, NHL, Soccer, Golf, NASCAR) and let you test your Global or Cricket integrations against recorded real games before going live.

The new recordings are fetched with the recordingsBySport(sport: ...) GraphQL query (the same way Soccer is already documented), not recordings(league: ...). Available competitions at launch:

APIsport valueCompetitions available
Global American FootballamericanfootballNFL
Global BasketballbasketballEuroleague, NBA
Global Ice HockeyicehockeyEuro Hockey Tour
CricketcricketODI Series: Australia vs. England

Feeds available per API:

APIFeeds covered by Simulations
Global American FootballSport Event Summary, Sport Event Timeline, Season Standings, Season Links, Season Summaries, Season Info, Season Competitors
Global BasketballThe above, plus Sport Event Lineups
Global Ice HockeyThe above, plus Sport Event Lineups and Season Leaders
Cricket (v2)Match Lineups, Match Summary, Match Timeline
📌

Simulations coverage for these APIs is scoped to Tier 1 competitions. Available competitions and recordings will expand over time — always read each recording's apis array for the live feed list rather than hardcoding against the table above.


⭐ Benefit

Shake out your Global or Cricket integration end-to-end against a recorded real game — on your own schedule, repeatably — so feed-parsing bugs, missing event handling, or push-connection issues surface in development rather than the next live match.


📋 Recommended Actions

  • Fetch recordings for the new APIs using the recordingsBySport(sport: "...") GraphQL query. The league-based recordings(league: ...) query is still used for NFL, NBA, MLB, NHL, and the other league-keyed sports.
  • Read each recording's apis array for the feed list rather than hardcoding — availability varies by sport and will grow as more recordings are captured.
  • For Cricket, recordings are keyed by sr:tournament: IDs (not sr:competition: as with Soccer). Make sure your integration handles that identifier type.
  • For Global Basketball, note that both Euroleague and NBA recordings are returned under the same sport: "basketball" query — filter on the league field if you need just one.
  • Coverage is Tier 1 only.

🔢 Products

SportProductVersion(s)
American FootballGlobal American Football APIv4
BasketballGlobal Basketball APIv4
Ice HockeyGlobal Ice Hockey APIv4
CricketCricket APIv2

☑️ Sample Request

Fetch available Global Basketball recordings — GraphQL

curl --request POST \
     --url https://playback.sportradar.com/graphql \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{"query":"{ recordingsBySport(sport: \"basketball\") { recordingId league start apis } }"}'

Swap sport: "basketball" for americanfootball, icehockey, or cricket to fetch recordings for the other new sports.


📚 Documentation