Live scores, play-by-play, box scores, odds, injuries: NFL, NBA, NHL, MLB, NCAA, 23 soccer leagues
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Your Realtime Sports API key as a Bearer token. Free key, no card (1,000 calls in the first 30 days): https://www.realtimesportsapi.com/signup
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Team totals and player statistics for a game (basketball, soccer, baseball, football). Not available before kickoff.
Sport slug.
League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure.
Event (game) id from get_live_events, get_events or get_schedule.
Team totals and player statistics for a game (basketball, soccer, baseball, football). Not available before kickoff.
| Argument | Type | Description |
|---|---|---|
| sport* | string | Sport slug. |
| league* | string | League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure. |
| event_id* | string | Event (game) id from get_live_events, get_events or get_schedule. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"sport",
"league",
"event_id"
],
"properties": {
"sport": {
"enum": [
"football",
"basketball",
"baseball",
"hockey",
"soccer"
],
"type": "string",
"description": "Sport slug."
},
"league": {
"type": "string",
"minLength": 1,
"description": "League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure."
},
"event_id": {
"type": "string",
"minLength": 1,
"description": "Event (game) id from get_live_events, get_events or get_schedule."
}
},
"additionalProperties": false
}Full details for one game: teams, score, status, venue, season/week, broadcasts, officials.
| Argument | Type | Description |
|---|---|---|
| sport* | string | Sport slug. |
| league* | string | League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure. |
| event_id* | string | Event (game) id from get_live_events, get_events or get_schedule. |
| include_odds | boolean |
The league's current scoreboard window: recent, live and upcoming games. For specific dates or weeks use get_schedule.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max games (default 50). |
| sport* | string | Sport slug. |
| detail | string | compact (default) returns the key fields per game; full returns the complete v1 event objects. |
| league* | string | League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure. |
Current injury report grouped by team (empty in the off-season). Pass team_id for that team's complete report.
| Argument | Type | Description |
|---|---|---|
| sport* | string | Sport slug. |
| league* | string | League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure. |
| team_id | string | Team id from list_teams or from an event's homeTeam/awayTeam. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"sport",
"league"
],
"properties": {
"sport": {
"enum": [
"football",
"basketball",
"baseball",
"hockey",
"soccer"
],
"type": "string",
"description": "Sport slug."
},
"league": {
"type": "string",
"minLength": 1,
"description": "League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure."
},
"team_id": {
"type": "string",
"minLength": 1,
"description": "Team id from list_teams or from an event's homeTeam/awayTeam."
}
},
"additionalProperties": false
}Games in progress right now for a league, with score, period/clock and status. Empty list when nothing is live. Data is typically 20-30 s behind live play.
| Argument | Type | Description |
|---|---|---|
| sport* | string | Sport slug. |
| detail | string | compact (default) returns the key fields per game; full returns the complete v1 event objects. |
| league* | string | League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure. |
| include_odds | boolean | Attach current betting odds when available. |
Latest news headlines for a league (optionally one team), with links.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| sport* | string | Sport slug. |
| league* | string | League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure. |
| team_id | string | Team id from list_teams or from an event's homeTeam/awayTeam. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"sport",
"league"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 25,
"minimum": 1
},
"sport": {
"enum": [
"football",
"basketball",
"baseball",
"hockey",
"soccer"
],
"type": "string",
"description": "Sport slug."
},
"league": {
"type": "string",
"minLength": 1,
"description": "League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure."
},
"team_id": {
"type": "string",
"minLength": 1,
"description": "Team id from list_teams or from an event's homeTeam/awayTeam."
}
},
"additionalProperties": false
}Current spread, moneyline and total for a game from a single source book. Returns null when no odds are available.
| Argument | Type | Description |
|---|---|---|
| sport* | string | Sport slug. |
| league* | string | League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure. |
| event_id* | string | Event (game) id from get_live_events, get_events or get_schedule. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"sport",
"league",
"event_id"
],
"properties": {
"sport": {
"enum": [
"football",
"basketball",
"baseball",
"hockey",
"soccer"
],
"type": "string",
"description": "Sport slug."
},
"league": {
"type": "string",
"minLength": 1,
"description": "League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure."
},
"event_id": {
"type": "string",
"minLength": 1,
"description": "Event (game) id from get_live_events, get_events or get_schedule."
}
},
"additionalProperties": false
}Play-by-play for a game, oldest first, paginated. Use a larger limit (up to 300 here) to get more plays per call; check pagination.hasNextPage.
| Argument | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| limit | integer | Plays per page (default 50). |
| sport* | string | Sport slug. |
| league* | string | League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure. |
| event_id* |
Games in a date range (start_date/end_date, YYYY-MM-DD, at most 31 days, US Eastern calendar days like most US schedules) or, for NFL and college football, a season week (season + week). Up to 200 games.
| Argument | Type | Description |
|---|---|---|
| week | integer | Week number (NFL / college football only). |
| sport* | string | Sport slug. |
| detail | string | compact (default) returns the key fields per game; full returns the complete v1 event objects. |
| league* | string | League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure. |
One team: names, record, standing summary, venue.
| Argument | Type | Description |
|---|---|---|
| sport* | string | Sport slug. |
| league* | string | League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure. |
| team_id* | string | Team id from list_teams or from an event's homeTeam/awayTeam. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"sport",
"league",
"team_id"
],
"properties": {
"sport": {
"enum": [
"football",
"basketball",
"baseball",
"hockey",
"soccer"
],
"type": "string",
"description": "Sport slug."
},
"league": {
"type": "string",
"minLength": 1,
"description": "League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure."
},
"team_id": {
"type": "string",
"minLength": 1,
"description": "Team id from list_teams or from an event's homeTeam/awayTeam."
}
},
"additionalProperties": false
}Current roster for a team, grouped by position.
| Argument | Type | Description |
|---|---|---|
| sport* | string | Sport slug. |
| league* | string | League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure. |
| team_id* | string | Team id from list_teams or from an event's homeTeam/awayTeam. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"sport",
"league",
"team_id"
],
"properties": {
"sport": {
"enum": [
"football",
"basketball",
"baseball",
"hockey",
"soccer"
],
"type": "string",
"description": "Sport slug."
},
"league": {
"type": "string",
"minLength": 1,
"description": "League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure."
},
"team_id": {
"type": "string",
"minLength": 1,
"description": "Team id from list_teams or from an event's homeTeam/awayTeam."
}
},
"additionalProperties": false
}List the leagues this API monitors live, with the sport and league slugs every other tool needs. 29 leagues monitored live: NFL, college football, NBA, men's college basketball, MLB, NHL and 23 soccer competitions.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Teams in a league (paginated; college football has 800+ teams across divisions).
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| limit | integer | Teams per page (default 50). |
| sport* | string | Sport slug. |
| league* | string | League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"sport",
"league"
],
"properties": {
"page": {
"type": "integer",
"minimum": 1
},
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Teams per page (default 50)."
},
"sport": {
"enum": [
"football",
"basketball",
"baseball",
"hockey",
"soccer"
],
"type": "string",
"description": "Sport slug."
},
"league": {
"type": "string",
"minLength": 1,
"description": "League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure."
}
},
"additionalProperties": false
}Find players by name within a league; returns athlete ids and teams.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| query* | string | Player name, e.g. "mahomes". |
| sport* | string | Sport slug. |
| league* | string | League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"sport",
"league",
"query"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1
},
"query": {
"type": "string",
"minLength": 2,
"description": "Player name, e.g. \"mahomes\"."
},
"sport": {
"enum": [
"football",
"basketball",
"baseball",
"hockey",
"soccer"
],
"type": "string",
"description": "Sport slug."
},
"league": {
"type": "string",
"minLength": 1,
"description": "League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure."
}
},
"additionalProperties": false
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"sport",
"league",
"event_id"
],
"properties": {
"sport": {
"enum": [
"football",
"basketball",
"baseball",
"hockey",
"soccer"
],
"type": "string",
"description": "Sport slug."
},
"league": {
"type": "string",
"minLength": 1,
"description": "League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure."
},
"event_id": {
"type": "string",
"minLength": 1,
"description": "Event (game) id from get_live_events, get_events or get_schedule."
},
"include_odds": {
"type": "boolean"
}
},
"additionalProperties": false
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"sport",
"league"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Max games (default 50)."
},
"sport": {
"enum": [
"football",
"basketball",
"baseball",
"hockey",
"soccer"
],
"type": "string",
"description": "Sport slug."
},
"detail": {
"enum": [
"compact",
"full"
],
"type": "string",
"description": "compact (default) returns the key fields per game; full returns the complete v1 event objects."
},
"league": {
"type": "string",
"minLength": 1,
"description": "League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure."
}
},
"additionalProperties": false
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"sport",
"league"
],
"properties": {
"sport": {
"enum": [
"football",
"basketball",
"baseball",
"hockey",
"soccer"
],
"type": "string",
"description": "Sport slug."
},
"detail": {
"enum": [
"compact",
"full"
],
"type": "string",
"description": "compact (default) returns the key fields per game; full returns the complete v1 event objects."
},
"league": {
"type": "string",
"minLength": 1,
"description": "League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure."
},
"include_odds": {
"type": "boolean",
"description": "Attach current betting odds when available."
}
},
"additionalProperties": false
}| string |
| Event (game) id from get_live_events, get_events or get_schedule. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"sport",
"league",
"event_id"
],
"properties": {
"page": {
"type": "integer",
"minimum": 1,
"description": "Page number (default 1)."
},
"limit": {
"type": "integer",
"maximum": 300,
"minimum": 1,
"description": "Plays per page (default 50)."
},
"sport": {
"enum": [
"football",
"basketball",
"baseball",
"hockey",
"soccer"
],
"type": "string",
"description": "Sport slug."
},
"league": {
"type": "string",
"minLength": 1,
"description": "League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure."
},
"event_id": {
"type": "string",
"minLength": 1,
"description": "Event (game) id from get_live_events, get_events or get_schedule."
}
},
"additionalProperties": false
}| season | integer | Season year, used with week. |
| end_date | any | Last day, YYYY-MM-DD (US Eastern). Defaults to start_date. |
| start_date | string | First day, YYYY-MM-DD (US Eastern). |
| season_type | integer | 1 preseason, 2 regular (default), 3 postseason. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"sport",
"league"
],
"properties": {
"week": {
"type": "integer",
"maximum": 25,
"minimum": 0,
"description": "Week number (NFL / college football only)."
},
"sport": {
"enum": [
"football",
"basketball",
"baseball",
"hockey",
"soccer"
],
"type": "string",
"description": "Sport slug."
},
"detail": {
"enum": [
"compact",
"full"
],
"type": "string",
"description": "compact (default) returns the key fields per game; full returns the complete v1 event objects."
},
"league": {
"type": "string",
"minLength": 1,
"description": "League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure."
},
"season": {
"type": "integer",
"maximum": 2100,
"minimum": 2000,
"description": "Season year, used with week."
},
"end_date": {
"$ref": "#/properties/start_date",
"description": "Last day, YYYY-MM-DD (US Eastern). Defaults to start_date."
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day, YYYY-MM-DD (US Eastern)."
},
"season_type": {
"type": "integer",
"maximum": 3,
"minimum": 1,
"description": "1 preseason, 2 regular (default), 3 postseason."
}
},
"additionalProperties": false
}