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:
| API | sport value | Competitions available |
|---|---|---|
| Global American Football | americanfootball | NFL |
| Global Basketball | basketball | Euroleague, NBA |
| Global Ice Hockey | icehockey | Euro Hockey Tour |
| Cricket | cricket | ODI Series: Australia vs. England |
Feeds available per API:
| API | Feeds covered by Simulations |
|---|---|
| Global American Football | Sport Event Summary, Sport Event Timeline, Season Standings, Season Links, Season Summaries, Season Info, Season Competitors |
| Global Basketball | The above, plus Sport Event Lineups |
| Global Ice Hockey | The 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
apisarray 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-basedrecordings(league: ...)query is still used for NFL, NBA, MLB, NHL, and the other league-keyed sports. - Read each recording's
apisarray 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 (notsr: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 theleaguefield if you need just one. - Coverage is Tier 1 only.
🔢 Products
| Sport | Product | Version(s) |
|---|---|---|
| American Football | Global American Football API | v4 |
| Basketball | Global Basketball API | v4 |
| Ice Hockey | Global Ice Hockey API | v4 |
| Cricket | Cricket API | v2 |
☑️ 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
- Simulations Overview — full list of supported leagues/sports, replay path format, and feed names
- Global American Football API
- Global Basketball API
- Global Ice Hockey API
- Cricket API
