ESPN

App · 15 actions

Scores, schedules, standings, rosters, player stats, college polls, injuries, transactions and news from ESPN for the NFL, NBA, MLB, NHL, WNBA, college football and basketball, MLS and the big soccer leagues. Start a workflow when a game finishes or ESPN posts a story. No account or API key required.

Actions

ActionWhat it does
Find playersFind players in a league by name, best match first, with the id the other player actions take, their team and position.
Get college rankingsGet this week's AP Top 25 or coaches' poll for college football or basketball: each team's place, record, points and move since last week.
Get game detailsGet one game's box score: the score by quarter, period or half, each team's stats, each player's stats, every score as it happened, the attendance and ESPN's recap.
Get injuriesGet the injury report for the NFL, NBA, WNBA, MLB or NHL: each injured player's status (out, questionable, day-to-day), the injury and the expected return date.
Get newsGet ESPN's latest stories for a league or one team, newest first, each with its headline, summary, link and picture.
Get playerGet a player's profile (team, position, age, height, weight, draft, college) and this season's headline stats with their league rank.
Get player game logGet a player's stats game by game for a season, most recent first: the opponent, the result and the player's line in each.
Get scoreboardGet a league's games on one day: who played whom, the score, whether each game is scheduled, live or final, the venue and the TV channel.
Get standingsGet a league's table: every team's position, wins, losses, points, streak and home and away record, by conference or group, as on espn.com.
Get stat leadersGet the league's top players in each headline stat (passing yards, points per game, home runs, goals...) for a season.
Get teamGet a team's season so far: its record at home and away, where it stands in its division or table, and its next game.
Get team rosterGet a team's current players, each with their id, number, position, age, height, weight and any injury, and the head coach.
Get team scheduleGet a team's games for a season in date order: results for the games played and kick-off times for the rest.
Get transactionsGet the latest signings, releases, trades and injured-list moves in the NFL, NBA, WNBA, MLB or NHL, newest first.
List teamsList every team in a league, A to Z, with its id, short code, colour, logo and espn.com page.

Find players

Find players in a league by name, best match first, with the id the other player actions take, their team and position.

Inputs

LeagueleaguetextRequired
The league to read.One of: nfl, college-football (College Football), nba, wnba, mens-college-basketball (Men's College Basketball), womens-college-basketball (Women's College Basketball), mlb, nhl, usa.1 (MLS), usa.nwsl (NWSL), and 13 more.
Player namenametextRequired
All or part of the player's name, e.g. 'Haaland' or 'Caitlin Clark'.

Outputs

athleteslist
The players, best match first.
countnumber
How many there are.
Example output
{
  "athletes": [
    {
      "active": true,
      "headshot": "",
      "id": "253989",
      "jersey": "9",
      "link": "https://www.espn.com/soccer/player/_/id/253989/erling-haaland",
      "name": "Erling Haaland",
      "position": "Forward",
      "team": "Manchester City",
      "team_id": "382"
    }
  ],
  "count": 1
}

Get college rankings

Get this week's AP Top 25 or coaches' poll for college football or basketball: each team's place, record, points and move since last week.

Inputs

LeagueleaguetextRequired
The college league whose poll to read.One of: college-football (College Football), mens-college-basketball (Men's College Basketball), womens-college-basketball (Women's College Basketball).
Pollpolltext
Which poll. Defaults to the AP Top 25.One of: ap (AP Top 25), coaches (Coaches Poll). Default: ap.

Outputs

countnumber
How many there are.
leaguetext
The league, e.g. 'NFL'.
polltext
e.g. 'AP Top 25'.
publishedtext
When the poll was released, in UTC.
rankingslist
The ranked teams, 1 first.
weektext
e.g. 'Week 8' or 'Preseason'.
Example output
{
  "count": 1,
  "league": "College Football",
  "poll": "AP Top 25",
  "published": "2026-10-18T07:00:00Z",
  "rankings": [
    {
      "abbreviation": "MIA",
      "conference": "ACC",
      "first_place_votes": 40,
      "logo": "https://a.espncdn.com/i/teamlogos/ncaa/500/2390.png",
      "points": 1697,
      "previous_rank": 3,
      "rank": 1,
      "record": "6-0",
      "team": "Miami Hurricanes",
      "team_id": "2390",
      "trend": "+2"
    }
  ],
  "week": "Week 8"
}

Get game details

Get one game's box score: the score by quarter, period or half, each team's stats, each player's stats, every score as it happened, the attendance and ESPN's recap.

Inputs

LeagueleaguetextRequired
The league to read.One of: nfl, college-football (College Football), nba, wnba, mens-college-basketball (Men's College Basketball), womens-college-basketball (Women's College Basketball), mlb, nhl, usa.1 (MLS), usa.nwsl (NWSL), and 13 more.
Game IDgame_idtextRequired
ESPN's id for the game, from 'Get scoreboard' or 'Get team schedule' (or the number after gameId/ in the game's espn.com address).

Outputs

attendancenumber
The crowd, when ESPN has it.
gameobject
The game.
playerslist
Each player's stats, one row per player per stat table.
recaptext
The recap's first lines.
recap_headlinetext
ESPN's recap headline, once written.
scoring_playslist
Every score, in order. Empty in basketball.
teamslist
Each team's line score and stats.
Example output
{
  "attendance": 77383,
  "game": {
    "away": {
      "abbreviation": "DAL",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/scoreboard/dal.png",
      "name": "Dallas Cowboys",
      "record": "2-4",
      "score": 13,
      "team_id": "6",
      "winner": false
    },
    "broadcasts": [
      "NBC"
    ],
    "city": "Green Bay, WI",
    "clock": "0:00",
    "completed": true,
    "date": "2026-10-19T00:20:00Z",
    "headline": "Jordan Love, Green Bay's defense lead the way in Packers' 23-13 victory over Cowboys",
    "home": {
      "abbreviation": "GB",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/scoreboard/gb.png",
      "name": "Green Bay Packers",
      "record": "4-2",
      "score": 23,
      "team_id": "9",
      "winner": true
    },
    "id": "401873007",
    "league": "NFL",
    "link": "https://www.espn.com/nfl/game/_/gameId/401873007/cowboys-packers",
    "name": "Dallas Cowboys at Green Bay Packers",
    "period": 4,
    "short_name": "DAL @ GB",
    "status": "final",
    "status_detail": "Final",
    "venue": "Lambeau Field",
    "winner": "Green Bay Packers"
  },
  "players": [
    {
      "athlete": "Jordan Love",
      "athlete_id": "4036378",
      "group": "Passing",
      "position": "QB",
      "starter": false,
      "stats": {
        "C/ATT": "23/41",
        "TD": "1",
        "YDS": "276"
      },
      "team": "Green Bay Packers"
    }
  ],
  "recap": "Green Bay's defense led the way.",
  "recap_headline": "Packers beat Cowboys 23-13",
  "scoring_plays": [
    {
      "away_score": 0,
      "clock": "4:43",
      "home_score": 7,
      "period": 1,
      "team": "Green Bay Packers",
      "text": "Matthew Golden 9 Yd pass from Jordan Love",
      "type": "Passing Touchdown"
    }
  ],
  "teams": [
    {
      "line_scores": [
        "7",
        "10",
        "3",
        "3"
      ],
      "statistics": {
        "Possession": "30:51",
        "Total Yards": "341"
      },
      "team": "Green Bay Packers",
      "team_id": "9"
    }
  ]
}

Get injuries

Get the injury report for the NFL, NBA, WNBA, MLB or NHL: each injured player's status (out, questionable, day-to-day), the injury and the expected return date.

Inputs

LeagueleaguetextRequired
The league to read. ESPN keeps injury reports for these five leagues.One of: nfl, nba, wnba, mlb, nhl.
Teamteamtext
Only this team's. Leave empty for the whole league.

Outputs

countnumber
How many there are.
injurieslist
The injured players, team by team.
leaguetext
The league, e.g. 'NFL'.
Example output
{
  "count": 1,
  "injuries": [
    {
      "athlete": "Lamar Jackson",
      "athlete_id": "3916387",
      "comment": "Jackson could potentially practice in Week 7.",
      "detail": "Sprain",
      "expected_return": "2026-10-25",
      "injury": "Ankle",
      "position": "QB",
      "side": "Left",
      "status": "Out",
      "team": "Baltimore Ravens",
      "team_id": "33",
      "updated": "2026-10-19T16:19:00Z"
    }
  ],
  "league": "NFL"
}

Get news

Get ESPN's latest stories for a league or one team, newest first, each with its headline, summary, link and picture.

Inputs

LeagueleaguetextRequired
The league to read.One of: nfl, college-football (College Football), nba, wnba, mens-college-basketball (Men's College Basketball), womens-college-basketball (Women's College Basketball), mlb, nhl, usa.1 (MLS), usa.nwsl (NWSL), and 13 more.
Teamteamtext
Only this team's. Leave empty for the whole league.
How many storieslimitnumber
From 1 to 50. Defaults to 10.From 1 to 50. Default: 10.

Outputs

articleslist
The stories, newest first.
countnumber
How many there are.
Example output
{
  "articles": [
    {
      "athletes": [
        "Brock Purdy"
      ],
      "byline": "Nick Wagoner",
      "description": "The 49ers quarterback is chasing a record on Monday night.",
      "headline": "Brock Purdy poised to make NFL history vs. Commanders",
      "id": "40699880",
      "image": "https://a.espncdn.com/photo/2026/1019/purdy.jpg",
      "league": "NFL",
      "link": "https://www.espn.com/nfl/story/_/id/40699880/brock-purdy-history",
      "premium": false,
      "published": "2026-10-19T22:03:38Z",
      "teams": [
        "San Francisco 49ers"
      ],
      "type": "Story"
    }
  ],
  "count": 1
}

Get player

Get a player's profile (team, position, age, height, weight, draft, college) and this season's headline stats with their league rank.

Inputs

LeagueleaguetextRequired
The league to read.One of: nfl, college-football (College Football), nba, wnba, mens-college-basketball (Men's College Basketball), womens-college-basketball (Women's College Basketball), mlb, nhl, usa.1 (MLS), usa.nwsl (NWSL), and 13 more.
Teamteamtext
The player's team, to list its players in the Player field.
PlayerathletetextRequired
The player. Pick a team first to choose from its roster, or use a player id from 'Find players', 'Get team roster' or 'Get injuries'.

Outputs

athleteobject
The player.
Example output
{
  "athlete": {
    "active": true,
    "age": 26,
    "birth_date": "1999-12-27",
    "birthplace": "Gilbert, AZ",
    "college": "Iowa State",
    "draft": "2022: Rd 7, Pk 262 (SF)",
    "experience": "5th Season",
    "first_name": "Brock",
    "headshot": "https://a.espncdn.com/i/headshots/nfl/players/full/4361741.png",
    "height": "6' 1\"",
    "id": "4361741",
    "jersey": "13",
    "last_name": "Purdy",
    "link": "https://www.espn.com/nfl/player/_/id/4361741/brock-purdy",
    "name": "Brock Purdy",
    "position": "Quarterback",
    "stats": [
      {
        "name": "Passing Yards",
        "rank": "18th",
        "value": "1,196"
      }
    ],
    "stats_title": "2026 regular season stats",
    "status": "Active",
    "team": "San Francisco 49ers",
    "team_id": "25",
    "weight": "220 lbs"
  }
}

Get player game log

Get a player's stats game by game for a season, most recent first: the opponent, the result and the player's line in each.

Inputs

LeagueleaguetextRequired
The league to read.One of: nfl, college-football (College Football), nba, wnba, mens-college-basketball (Men's College Basketball), womens-college-basketball (Women's College Basketball), mlb, nhl, usa.1 (MLS), usa.nwsl (NWSL), and 13 more.
Teamteamtext
The player's team, to list its players in the Player field.
PlayerathletetextRequired
The player. Pick a team first to choose from its roster, or use a player id from 'Find players', 'Get team roster' or 'Get injuries'.
Seasonseasontext
Leave empty for the current season.

Outputs

countnumber
How many there are.
gameslist
The player's games, most recent first.
seasontext
The season read, e.g. '2026' or '2026-27'.
Example output
{
  "count": 1,
  "games": [
    {
      "date": "2026-10-11T20:25:00Z",
      "game_id": "401872992",
      "home_away": "away",
      "link": "https://www.espn.com/nfl/game/_/gameId/401872992/49ers-seahawks",
      "opponent": "Seattle Seahawks",
      "opponent_id": "26",
      "result": "win",
      "score": "32-29",
      "season": "2026 Regular Season",
      "stats": {
        "Passing Touchdowns": "2",
        "Passing Yards": "189"
      }
    }
  ],
  "season": "2026"
}

Get scoreboard

Get a league's games on one day: who played whom, the score, whether each game is scheduled, live or final, the venue and the TV channel. Leave the date empty for today.

Inputs

LeagueleaguetextRequired
The league to read.One of: nfl, college-football (College Football), nba, wnba, mens-college-basketball (Men's College Basketball), womens-college-basketball (Women's College Basketball), mlb, nhl, usa.1 (MLS), usa.nwsl (NWSL), and 13 more.
Datedatedate
The day to read, as ESPN counts days (US Eastern time). Leave empty for ESPN's current slate: today's games, or this week's in the NFL and college football.
Teamteamtext
Only this team's. Leave empty for the whole league.

Outputs

countnumber
How many there are.
datetext
The day read, e.g. '2026-10-18'. Empty when no date was given and ESPN's current slate was read.
gameslist
The games, in ESPN's order (by start time).
leaguetext
The league, e.g. 'NFL'.
Example output
{
  "count": 1,
  "date": "2026-10-18",
  "games": [
    {
      "away": {
        "abbreviation": "DAL",
        "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/scoreboard/dal.png",
        "name": "Dallas Cowboys",
        "record": "2-4",
        "score": 13,
        "team_id": "6",
        "winner": false
      },
      "broadcasts": [
        "NBC"
      ],
      "city": "Green Bay, WI",
      "clock": "0:00",
      "completed": true,
      "date": "2026-10-19T00:20:00Z",
      "headline": "Jordan Love, Green Bay's defense lead the way in Packers' 23-13 victory over Cowboys",
      "home": {
        "abbreviation": "GB",
        "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/scoreboard/gb.png",
        "name": "Green Bay Packers",
        "record": "4-2",
        "score": 23,
        "team_id": "9",
        "winner": true
      },
      "id": "401873007",
      "league": "NFL",
      "link": "https://www.espn.com/nfl/game/_/gameId/401873007/cowboys-packers",
      "name": "Dallas Cowboys at Green Bay Packers",
      "period": 4,
      "short_name": "DAL @ GB",
      "status": "final",
      "status_detail": "Final",
      "venue": "Lambeau Field",
      "winner": "Green Bay Packers"
    }
  ],
  "league": "NFL"
}

Get standings

Get a league's table: every team's position, wins, losses, points, streak and home and away record, by conference or group, as on espn.com.

Inputs

LeagueleaguetextRequired
The league to read.One of: nfl, college-football (College Football), nba, wnba, mens-college-basketball (Men's College Basketball), womens-college-basketball (Women's College Basketball), mlb, nhl, usa.1 (MLS), usa.nwsl (NWSL), and 13 more.
Seasonseasontext
Leave empty for the current season.
Part of the seasonseason_typetext
Leave empty for the part ESPN shows now.Only when League is NFL, College Football, NBA, WNBA, Men's College Basketball, Women's College Basketball, MLB or NHL. One of: 2 (Regular season), 3 (Postseason), 1 (Preseason).

Outputs

countnumber
How many there are.
leaguetext
The league, e.g. 'NFL'.
seasontext
The season, e.g. '2026' or '2026-27'.
season_typetext
'Regular Season', 'Postseason' or 'Preseason'. Empty in soccer.
standingslist
One row per team, each group's leader first.
Example output
{
  "count": 1,
  "league": "NFL",
  "season": "2026",
  "season_type": "Regular Season",
  "standings": [
    {
      "abbreviation": "KC",
      "away_record": "2-0",
      "difference": 57,
      "games_behind": "-",
      "games_played": null,
      "group": "American Football Conference",
      "home_record": "3-0",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/kc.png",
      "losses": 0,
      "note": "",
      "points": null,
      "points_against": 83,
      "points_for": 140,
      "rank": 1,
      "record": "5-0",
      "streak": "W5",
      "team": "Kansas City Chiefs",
      "team_id": "12",
      "ties": 0,
      "win_percent": 1.0,
      "wins": 5
    }
  ]
}

Get stat leaders

Get the league's top players in each headline stat (passing yards, points per game, home runs, goals...) for a season.

Inputs

LeagueleaguetextRequired
The league to read. ESPN keeps no stat leaders for soccer.One of: nfl, college-football (College Football), nba, wnba, mens-college-basketball (Men's College Basketball), womens-college-basketball (Women's College Basketball), mlb, nhl.
Seasonseasontext
Leave empty for the current season.
Part of the seasonseason_typetext
Leave empty for the regular season.One of: 2 (Regular season), 3 (Postseason), 1 (Preseason).
Players per statlimitnumber
From 1 to 10. Defaults to 5.From 1 to 10. Default: 5.

Outputs

countnumber
How many there are.
leaderslist
Stat by stat, the best player first.
leaguetext
The league, e.g. 'NFL'.
seasontext
The season, e.g. '2026' or '2025-26'.
season_typetext
e.g. 'Regular Season' or 'Postseason'.
Example output
{
  "count": 1,
  "leaders": [
    {
      "athlete": "Matthew Stafford",
      "athlete_id": "12483",
      "position": "QB",
      "rank": 1,
      "stat": "Passing Yards",
      "summary": "1794",
      "team": "Los Angeles Rams",
      "team_id": "14",
      "value": 1794
    }
  ],
  "league": "NFL",
  "season": "2026",
  "season_type": "Regular Season"
}

Get team

Get a team's season so far: its record at home and away, where it stands in its division or table, and its next game.

Inputs

LeagueleaguetextRequired
The league to read.One of: nfl, college-football (College Football), nba, wnba, mens-college-basketball (Men's College Basketball), womens-college-basketball (Women's College Basketball), mlb, nhl, usa.1 (MLS), usa.nwsl (NWSL), and 13 more.
TeamteamtextRequired
The team to read, from the league chosen.

Outputs

teamobject
The team.
Example output
{
  "team": {
    "abbreviation": "SF",
    "away_record": "2-0",
    "color": "#aa0000",
    "home_record": "3-0",
    "id": "25",
    "link": "https://www.espn.com/nfl/team/_/name/sf/san-francisco-49ers",
    "location": "San Francisco",
    "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/sf.png",
    "losses": 0,
    "name": "San Francisco 49ers",
    "next_game": {
      "away": {
        "abbreviation": "DAL",
        "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/scoreboard/dal.png",
        "name": "Dallas Cowboys",
        "record": "2-4",
        "score": 13,
        "team_id": "6",
        "winner": false
      },
      "broadcasts": [
        "NBC"
      ],
      "city": "Green Bay, WI",
      "clock": "0:00",
      "completed": true,
      "date": "2026-10-19T00:20:00Z",
      "headline": "Jordan Love, Green Bay's defense lead the way in Packers' 23-13 victory over Cowboys",
      "home": {
        "abbreviation": "GB",
        "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/scoreboard/gb.png",
        "name": "Green Bay Packers",
        "record": "4-2",
        "score": 23,
        "team_id": "9",
        "winner": true
      },
      "id": "401873007",
      "league": "NFL",
      "link": "https://www.espn.com/nfl/game/_/gameId/401873007/cowboys-packers",
      "name": "Dallas Cowboys at Green Bay Packers",
      "period": 4,
      "short_name": "DAL @ GB",
      "status": "final",
      "status_detail": "Final",
      "venue": "Lambeau Field",
      "winner": "Green Bay Packers"
    },
    "nickname": "49ers",
    "points_against": 93.0,
    "points_for": 154.0,
    "record": "5-0",
    "short_name": "49ers",
    "standing": "1st in NFC West",
    "ties": 0,
    "wins": 5
  }
}

Get team roster

Get a team's current players, each with their id, number, position, age, height, weight and any injury, and the head coach.

Inputs

LeagueleaguetextRequired
The league to read.One of: nfl, college-football (College Football), nba, wnba, mens-college-basketball (Men's College Basketball), womens-college-basketball (Women's College Basketball), mlb, nhl, usa.1 (MLS), usa.nwsl (NWSL), and 13 more.
TeamteamtextRequired
The team to read, from the league chosen.

Outputs

athleteslist
The players, grouped as ESPN lists them (by position).
coachtext
The head coach. Empty when ESPN has none.
countnumber
How many there are.
teamtext
The team.
Example output
{
  "athletes": [
    {
      "age": 26,
      "birth_date": "1999-12-27",
      "birthplace": "Gilbert, AZ, USA",
      "experience_years": 5,
      "first_name": "Brock",
      "headshot": "https://a.espncdn.com/i/headshots/nfl/players/full/4361741.png",
      "height": "6' 1\"",
      "id": "4361741",
      "injury_status": "",
      "jersey": "13",
      "last_name": "Purdy",
      "name": "Brock Purdy",
      "nationality": "",
      "position": "Quarterback",
      "position_abbreviation": "QB",
      "status": "Active",
      "weight": "220 lbs"
    }
  ],
  "coach": "Kyle Shanahan",
  "count": 1,
  "team": "San Francisco 49ers"
}

Get team schedule

Get a team's games for a season in date order: results for the games played and kick-off times for the rest.

Inputs

LeagueleaguetextRequired
The league to read.One of: nfl, college-football (College Football), nba, wnba, mens-college-basketball (Men's College Basketball), womens-college-basketball (Women's College Basketball), mlb, nhl, usa.1 (MLS), usa.nwsl (NWSL), and 13 more.
TeamteamtextRequired
The team to read, from the league chosen.
Seasonseasontext
Leave empty for the current season.
Part of the seasonseason_typetext
Leave empty for the part ESPN shows now.Only when League is NFL, College Football, NBA, WNBA, Men's College Basketball, Women's College Basketball, MLB or NHL. One of: 2 (Regular season), 3 (Postseason), 1 (Preseason).

Outputs

countnumber
How many there are.
gameslist
The games, earliest first.
seasontext
The season, e.g. '2026' or '2026-27'.
season_typetext
The part of the season, e.g. 'Regular Season'. Empty in soccer.
teamtext
The team.
Example output
{
  "count": 1,
  "games": [
    {
      "away": {
        "abbreviation": "DAL",
        "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/scoreboard/dal.png",
        "name": "Dallas Cowboys",
        "record": "2-4",
        "score": 13,
        "team_id": "6",
        "winner": false
      },
      "broadcasts": [
        "NBC"
      ],
      "city": "Green Bay, WI",
      "clock": "0:00",
      "completed": true,
      "date": "2026-10-19T00:20:00Z",
      "headline": "Jordan Love, Green Bay's defense lead the way in Packers' 23-13 victory over Cowboys",
      "home": {
        "abbreviation": "GB",
        "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/scoreboard/gb.png",
        "name": "Green Bay Packers",
        "record": "4-2",
        "score": 23,
        "team_id": "9",
        "winner": true
      },
      "id": "401873007",
      "league": "NFL",
      "link": "https://www.espn.com/nfl/game/_/gameId/401873007/cowboys-packers",
      "name": "Dallas Cowboys at Green Bay Packers",
      "period": 4,
      "short_name": "DAL @ GB",
      "status": "final",
      "status_detail": "Final",
      "venue": "Lambeau Field",
      "winner": "Green Bay Packers"
    }
  ],
  "season": "2026",
  "season_type": "Regular Season",
  "team": "Green Bay Packers"
}

Get transactions

Get the latest signings, releases, trades and injured-list moves in the NFL, NBA, WNBA, MLB or NHL, newest first.

Inputs

LeagueleaguetextRequired
The league to read. ESPN lists signings and trades for these five.One of: nfl, nba, wnba, mlb, nhl.
Teamteamtext
Only this team's. Leave empty for the whole league.
How manylimitnumber
From 1 to 100. Defaults to 25.From 1 to 100. Default: 25.

Outputs

countnumber
How many there are.
leaguetext
The league, e.g. 'NFL'.
transactionslist
The moves, newest first.
Example output
{
  "count": 1,
  "league": "NFL",
  "transactions": [
    {
      "date": "2026-10-19",
      "description": "Signed QB Andy Dalton. Released QB Cooper Rush.",
      "team": "Atlanta Falcons",
      "team_id": "1"
    }
  ]
}

List teams

List every team in a league, A to Z, with its id, short code, colour, logo and espn.com page.

Inputs

LeagueleaguetextRequired
The league to read.One of: nfl, college-football (College Football), nba, wnba, mens-college-basketball (Men's College Basketball), womens-college-basketball (Women's College Basketball), mlb, nhl, usa.1 (MLS), usa.nwsl (NWSL), and 13 more.

Outputs

countnumber
How many there are.
leaguetext
The league, e.g. 'NFL'.
teamslist
The teams, A to Z.
Example output
{
  "count": 1,
  "league": "NFL",
  "teams": [
    {
      "abbreviation": "SF",
      "color": "#aa0000",
      "id": "25",
      "link": "https://www.espn.com/nfl/team/_/name/sf/san-francisco-49ers",
      "location": "San Francisco",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/sf.png",
      "name": "San Francisco 49ers",
      "nickname": "49ers",
      "short_name": "49ers"
    }
  ]
}

On this page