# ESPN

> 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.

App · 15 actions. Web page: https://docs.lodol.com/docs/integrations/espn

## Actions

### 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**

- League (`league`, text, required): 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 name (`name`, text, required): All or part of the player's name, e.g. 'Haaland' or 'Caitlin Clark'.

**Outputs**

- `athletes` (list): The players, best match first.
- `count` (number): How many there are.

**Example output**

```json
{
  "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**

- League (`league`, text, required): 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).
- Poll (`poll`, text): Which poll. Defaults to the AP Top 25. One of: `ap` (AP Top 25), `coaches` (Coaches Poll). Default: `ap`.

**Outputs**

- `count` (number): How many there are.
- `league` (text): The league, e.g. 'NFL'.
- `poll` (text): e.g. 'AP Top 25'.
- `published` (text): When the poll was released, in UTC.
- `rankings` (list): The ranked teams, 1 first.
- `week` (text): e.g. 'Week 8' or 'Preseason'.

**Example output**

```json
{
  "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**

- League (`league`, text, required): 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 ID (`game_id`, text, required): 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**

- `attendance` (number): The crowd, when ESPN has it.
- `game` (object): The game.
- `players` (list): Each player's stats, one row per player per stat table.
- `recap` (text): The recap's first lines.
- `recap_headline` (text): ESPN's recap headline, once written.
- `scoring_plays` (list): Every score, in order. Empty in basketball.
- `teams` (list): Each team's line score and stats.

**Example output**

```json
{
  "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**

- League (`league`, text, required): The league to read. ESPN keeps injury reports for these five leagues. One of: `nfl`, `nba`, `wnba`, `mlb`, `nhl`.
- Team (`team`, text): Only this team's. Leave empty for the whole league.

**Outputs**

- `count` (number): How many there are.
- `injuries` (list): The injured players, team by team.
- `league` (text): The league, e.g. 'NFL'.

**Example output**

```json
{
  "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**

- League (`league`, text, required): 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.
- Team (`team`, text): Only this team's. Leave empty for the whole league.
- How many stories (`limit`, number): From 1 to 50. Defaults to 10. From 1 to 50. Default: `10`.

**Outputs**

- `articles` (list): The stories, newest first.
- `count` (number): How many there are.

**Example output**

```json
{
  "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**

- League (`league`, text, required): 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.
- Team (`team`, text): The player's team, to list its players in the Player field.
- Player (`athlete`, text, required): 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**

- `athlete` (object): The player.

**Example output**

```json
{
  "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**

- League (`league`, text, required): 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.
- Team (`team`, text): The player's team, to list its players in the Player field.
- Player (`athlete`, text, required): 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'.
- Season (`season`, text): Leave empty for the current season.

**Outputs**

- `count` (number): How many there are.
- `games` (list): The player's games, most recent first.
- `season` (text): The season read, e.g. '2026' or '2026-27'.

**Example output**

```json
{
  "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**

- League (`league`, text, required): 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.
- Date (`date`, date): 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.
- Team (`team`, text): Only this team's. Leave empty for the whole league.

**Outputs**

- `count` (number): How many there are.
- `date` (text): The day read, e.g. '2026-10-18'. Empty when no date was given and ESPN's current slate was read.
- `games` (list): The games, in ESPN's order (by start time).
- `league` (text): The league, e.g. 'NFL'.

**Example output**

```json
{
  "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**

- League (`league`, text, required): 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.
- Season (`season`, text): Leave empty for the current season.
- Part of the season (`season_type`, text): 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**

- `count` (number): How many there are.
- `league` (text): The league, e.g. 'NFL'.
- `season` (text): The season, e.g. '2026' or '2026-27'.
- `season_type` (text): 'Regular Season', 'Postseason' or 'Preseason'. Empty in soccer.
- `standings` (list): One row per team, each group's leader first.

**Example output**

```json
{
  "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**

- League (`league`, text, required): 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`.
- Season (`season`, text): Leave empty for the current season.
- Part of the season (`season_type`, text): Leave empty for the regular season. One of: `2` (Regular season), `3` (Postseason), `1` (Preseason).
- Players per stat (`limit`, number): From 1 to 10. Defaults to 5. From 1 to 10. Default: `5`.

**Outputs**

- `count` (number): How many there are.
- `leaders` (list): Stat by stat, the best player first.
- `league` (text): The league, e.g. 'NFL'.
- `season` (text): The season, e.g. '2026' or '2025-26'.
- `season_type` (text): e.g. 'Regular Season' or 'Postseason'.

**Example output**

```json
{
  "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**

- League (`league`, text, required): 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.
- Team (`team`, text, required): The team to read, from the league chosen.

**Outputs**

- `team` (object): The team.

**Example output**

```json
{
  "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**

- League (`league`, text, required): 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.
- Team (`team`, text, required): The team to read, from the league chosen.

**Outputs**

- `athletes` (list): The players, grouped as ESPN lists them (by position).
- `coach` (text): The head coach. Empty when ESPN has none.
- `count` (number): How many there are.
- `team` (text): The team.

**Example output**

```json
{
  "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**

- League (`league`, text, required): 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.
- Team (`team`, text, required): The team to read, from the league chosen.
- Season (`season`, text): Leave empty for the current season.
- Part of the season (`season_type`, text): 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**

- `count` (number): How many there are.
- `games` (list): The games, earliest first.
- `season` (text): The season, e.g. '2026' or '2026-27'.
- `season_type` (text): The part of the season, e.g. 'Regular Season'. Empty in soccer.
- `team` (text): The team.

**Example output**

```json
{
  "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**

- League (`league`, text, required): The league to read. ESPN lists signings and trades for these five. One of: `nfl`, `nba`, `wnba`, `mlb`, `nhl`.
- Team (`team`, text): Only this team's. Leave empty for the whole league.
- How many (`limit`, number): From 1 to 100. Defaults to 25. From 1 to 100. Default: `25`.

**Outputs**

- `count` (number): How many there are.
- `league` (text): The league, e.g. 'NFL'.
- `transactions` (list): The moves, newest first.

**Example output**

```json
{
  "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**

- League (`league`, text, required): 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**

- `count` (number): How many there are.
- `league` (text): The league, e.g. 'NFL'.
- `teams` (list): The teams, A to Z.

**Example output**

```json
{
  "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"
    }
  ]
}
```
