# Yahoo Sports API

> Yahoo Sports returns scores, schedules, standings, and player statistics, available as a workflow and API.

Yahoo Sports returns league scores and schedules for a required league and optional date, team, and time zone. Get standings returns team standings for a required league and optional season year. Get player stats returns regular-season and career statistics for a required player name and optional league, team, and season.

- Page: https://fous.com/tools/yahoo-sports
- Handle: `@yahoo-sports`
- Category: [Sports](https://fous.com/tools/category/sports)
- Source website: https://sports.yahoo.com
- Last verified: Sep 29, 2026

## Methods

### Get player stats

Operation `get_player_stats`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Get a Yahoo Sports player’s regular-season and career statistics by name, with optional league, team, and season. Statistics are included when Yahoo provides numeric values for both the selected season and career; seasons without statistics are unavailable.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `team` | string | no |  | Team name to distinguish players, such as Philadelphia 76ers. |
| `league` | string | no | `"NBA"` | League to search, such as NBA. If omitted, searches the main US leagues. |
| `player` | string | yes | `"LeBron James"` | Player name, such as LeBron James. |
| `season` | string | no | `"2025"` | Season year or season label, such as 2024 or 2024-25. Defaults to the latest season with statistics. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "player"
  ],
  "properties": {
    "team": {
      "type": "string",
      "default": "",
      "description": "Team name to distinguish players, such as Philadelphia 76ers."
    },
    "league": {
      "type": "string",
      "default": "",
      "description": "League to search, such as NBA. If omitted, searches the main US leagues.",
      "examples": [
        "NBA",
        "NFL",
        "MLB"
      ]
    },
    "player": {
      "type": "string",
      "description": "Player name, such as LeBron James.",
      "examples": [
        "LeBron James",
        "Patrick Mahomes",
        "Shohei Ohtani"
      ]
    },
    "season": {
      "type": "string",
      "default": "latest",
      "description": "Season year or season label, such as 2024 or 2024-25. Defaults to the latest season with statistics.",
      "examples": [
        "2025"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "league": "NBA",
      "player": "LeBron James"
    },
    {
      "league": "NFL",
      "player": "Patrick Mahomes"
    },
    {
      "league": "MLB",
      "player": "Shohei Ohtani",
      "season": "2025"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `age` | integer or null | `41` |  |
| `team` | string or null | `"Philadelphia 76ers"` |  |
| `stats` | array |  |  |
| `stats[].stat_name` | string | `"Assists"` |  |
| `stats[].career_value` | number | `12016` |  |
| `stats[].season_value` | number | `432` |  |
| `stats[].stat_abbreviation` | string or null | `"Ast"` |  |
| `league` | string | `"NBA"` |  |
| `player` | string | `"LeBron James"` |  |
| `season` | string | `"2025-26"` |  |
| `position` | string or null | `"Small Forward, Power Forward"` |  |
| `player_id` | string | `"nba.p.3704"` |  |
| `headshot_image_link` | string or null | `"https://s.yimg.com/iu/api/res/1.2/_bFttyGaZVtkNxzU55m.eA--~B/YXBwaWQ9c2hhcmVkO2ZpPWZpbGw7cT03NTtoPTE2MDt3PTE2MA--/https` |  |
| `yahoo_sports_player_link` | string | `"https://sports.yahoo.com/nba/players/3704/"` |  |

**Example input**

```json
{
  "league": "NBA",
  "player": "LeBron James"
}
```

**Example output**

```json
{
  "age": 41,
  "team": "Philadelphia 76ers",
  "stats": [
    {
      "stat_name": "Assists",
      "career_value": 12016,
      "season_value": 432,
      "stat_abbreviation": "Ast"
    },
    {
      "stat_name": "Three-Points Made",
      "career_value": 2636,
      "season_value": 77,
      "stat_abbreviation": "3PM"
    },
    {
      "stat_name": "Field Goal Attempts",
      "career_value": 31502,
      "season_value": 919,
      "stat_abbreviation": "FGA"
    }
  ],
  "league": "NBA",
  "player": "LeBron James",
  "season": "2025-26",
  "position": "Small Forward, Power Forward",
  "player_id": "nba.p.3704",
  "headshot_image_link": "https://s.yimg.com/iu/api/res/1.2/_bFttyGaZVtkNxzU55m.eA--~B/YXBwaWQ9c2hhcmVkO2ZpPWZpbGw7cT03NTtoPTE2MDt3PTE2MA--/https://s.yimg.com/xe/i/us/sp/v/nba_cutout/players_l/02042026/3704.3.png",
  "yahoo_sports_player_link": "https://sports.yahoo.com/nba/players/3704/"
}
```

### Get scores

Operation `get_scores`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Get scores and schedules for a league and date, or the date’s football week. TV or venue details can be missing; on large schedules, venue lookups are limited to the first 24 games.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `date` | string | no | `"2026-09-27"` | Game date, or a date in the football week. Defaults to today. Example: 2026-09-29 |
| `team` | string | no | `"Chicago Bears"` | Only games featuring this team, matching its name or abbreviation. Example: Indiana Fever |
| `league` | string | yes | `"NFL"` | League name, such as NBA, NFL, college football, men's college basketball, Premier League, or MLS. Example: NBA |
| `time_zone` | string | no | `"America/Los_Angeles"` | Time zone for game start times; defaults to US Eastern. Example: America/Los_Angeles |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "league"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "description": "Game date, or a date in the football week. Defaults to today. Example: 2026-09-29",
      "examples": [
        "2026-09-27",
        "2026-09-29",
        "2026-09-26"
      ]
    },
    "team": {
      "type": "string",
      "description": "Only games featuring this team, matching its name or abbreviation. Example: Indiana Fever",
      "examples": [
        "Chicago Bears",
        "Indiana Fever",
        "Philadelphia Union"
      ]
    },
    "league": {
      "type": "string",
      "description": "League name, such as NBA, NFL, college football, men's college basketball, Premier League, or MLS. Example: NBA",
      "examples": [
        "NFL",
        "WNBA",
        "MLS"
      ]
    },
    "time_zone": {
      "type": "string",
      "default": "America/New_York",
      "description": "Time zone for game start times; defaults to US Eastern. Example: America/Los_Angeles",
      "examples": [
        "America/Los_Angeles"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "date": "2026-09-27",
      "team": "Chicago Bears",
      "league": "NFL",
      "time_zone": "America/Los_Angeles"
    },
    {
      "date": "2026-09-29",
      "team": "Indiana Fever",
      "league": "WNBA"
    },
    {
      "date": "2026-09-26",
      "team": "Philadelphia Union",
      "league": "MLS"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `games` | array |  |  |
| `games[].clock` | string or null | `"1:52"` |  |
| `games[].venue` | string or null | `"Soldier Field"` |  |
| `games[].period` | string or null | `"2nd"` |  |
| `games[].status` | string | `"live"` |  |
| `games[].game_id` | string | `"nfl.g.20260928003"` |  |
| `games[].away_team` | string | `"Philadelphia Eagles"` |  |
| `games[].game_link` | string | `"https://sports.yahoo.com/nfl/philadelphia-eagles-chicago-bears-20260928003/"` |  |
| `games[].home_team` | string | `"Chicago Bears"` |  |
| `games[].away_score` | integer or null | `0` |  |
| `games[].home_score` | integer or null | `10` |  |
| `games[].start_time` | string | `"2026-09-28T17:15:00-07:00"` | Scheduled start time in the requested time zone, ISO 8601. |
| `games[].tv_channel` | string or null | `"ABC/ESPN"` |  |

**Example input**

```json
{
  "date": "2026-09-27",
  "team": "Chicago Bears",
  "league": "NFL",
  "time_zone": "America/Los_Angeles"
}
```

**Example output**

```json
{
  "games": [
    {
      "clock": "1:52",
      "venue": "Soldier Field",
      "period": "2nd",
      "status": "live",
      "game_id": "nfl.g.20260928003",
      "away_team": "Philadelphia Eagles",
      "game_link": "https://sports.yahoo.com/nfl/philadelphia-eagles-chicago-bears-20260928003/",
      "home_team": "Chicago Bears",
      "away_score": 0,
      "home_score": 10,
      "start_time": "2026-09-28T17:15:00-07:00",
      "tv_channel": "ABC/ESPN"
    }
  ]
}
```

### Get standings

Operation `get_standings`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Get Yahoo Sports team standings for a league and starting season year. Fields Yahoo does not publish are null; NFL has last 5 rather than last 10 games. Teams without Yahoo standings in a selected season are omitted.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `league` | string | yes | `"NBA"` | League name, for example NBA or Premier League. |
| `season` | integer | no | `2025` | Starting year of the season, for example 2025. Defaults to the season selected by Yahoo Sports. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "league"
  ],
  "properties": {
    "league": {
      "type": "string",
      "description": "League name, for example NBA or Premier League.",
      "examples": [
        "NBA",
        "NFL",
        "MLS"
      ]
    },
    "season": {
      "type": "integer",
      "description": "Starting year of the season, for example 2025. Defaults to the season selected by Yahoo Sports.",
      "examples": [
        2025
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "league": "NBA",
      "season": 2025
    },
    {
      "league": "NFL"
    },
    {
      "league": "MLS"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `teams` | array |  |  |
| `teams[].rank` | integer | `1` |  |
| `teams[].team` | string | `"Detroit"` |  |
| `teams[].ties` | integer or null | `0` |  |
| `teams[].wins` | integer or null | `60` |  |
| `teams[].group` | string | `"Eastern"` | Division, conference, or league group. |
| `teams[].losses` | integer or null | `22` |  |
| `teams[].points` | integer or null | `60` |  |
| `teams[].page_url` | string | `"https://sports.yahoo.com/nba/teams/detroit/"` |  |
| `teams[].games_behind` | number or null | `4` |  |
| `teams[].last_10_games` | string or null | `"8-2"` |  |
| `teams[].current_streak` | string or null | `"W-3"` |  |
| `teams[].win_percentage` | number or null | `0.732` | Wins divided by games played where Yahoo does not publish a percentage. |
| `teams[].overtime_losses` | integer or null |  |  |
| `league` | string | `"NBA"` |  |
| `season` | integer | `2025` |  |

**Example input**

```json
{
  "league": "NBA",
  "season": 2025
}
```

**Example output**

```json
{
  "teams": [
    {
      "rank": 1,
      "team": "Detroit",
      "ties": null,
      "wins": 60,
      "group": "Eastern",
      "losses": 22,
      "points": null,
      "page_url": "https://sports.yahoo.com/nba/teams/detroit/",
      "games_behind": null,
      "last_10_games": "8-2",
      "current_streak": "W-3",
      "win_percentage": 0.732,
      "overtime_losses": null
    },
    {
      "rank": 2,
      "team": "Boston",
      "ties": null,
      "wins": 56,
      "group": "Eastern",
      "losses": 26,
      "points": null,
      "page_url": "https://sports.yahoo.com/nba/teams/boston/",
      "games_behind": 4,
      "last_10_games": "8-2",
      "current_streak": "W-2",
      "win_percentage": 0.683,
      "overtime_losses": null
    },
    {
      "rank": 3,
      "team": "New York",
      "ties": null,
      "wins": 53,
      "group": "Eastern",
      "losses": 29,
      "points": null,
      "page_url": "https://sports.yahoo.com/nba/teams/new-york/",
      "games_behind": 7,
      "last_10_games": "6-4",
      "current_streak": "L-1",
      "win_percentage": 0.646,
      "overtime_losses": null
    }
  ],
  "league": "NBA",
  "season": 2025
}
```

## Quick start

Replace `YOUR_API_KEY` with a Fous API key. To create one, open Developers at the bottom of Fous Studio, turn on Developer mode, then go to API keys (https://app.fous.com/keys). Change the values in `input` to run the same tool on new data.

```bash
curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@yahoo-sports",
  "visibility": "public",
  "operation": "get_player_stats",
  "version": 1,
  "input": {
    "league": "NBA",
    "player": "LeBron James"
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
import json
import urllib.error
import urllib.request

api_key = "YOUR_API_KEY"

body = json.loads("{\n  \"api\": \"@yahoo-sports\",\n  \"visibility\": \"public\",\n  \"operation\": \"get_player_stats\",\n  \"version\": 1,\n  \"input\": {\n    \"league\": \"NBA\",\n    \"player\": \"LeBron James\"\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=180) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
const apiKey = "YOUR_API_KEY";

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(180_000),
  body: JSON.stringify({
  "api": "@yahoo-sports",
  "visibility": "public",
  "operation": "get_player_stats",
  "version": 1,
  "input": {
    "league": "NBA",
    "player": "LeBron James"
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

## Use from an AI assistant

Connect this tool to Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client as its own MCP server. Each method is a typed tool whose arguments are the method’s input.

- Server URL: `https://api.fous.com/mcp/tools/yahoo-sports`
- Authorization: `Authorization: Bearer <Fous API key>`

**Tools**

- `get_player_stats`: Get player stats. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `get_scores`: Get scores. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `get_standings`: Get standings. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `fous_get_run`: the result of a run that was still going, by its `request_id`. Free.

Claude Code:

```bash
claude mcp add --scope user --transport http fous-yahoo-sports https://api.fous.com/mcp/tools/yahoo-sports --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"
```

To give the assistant every tool, connect `https://api.fous.com/mcp`: it finds one with `fous_search_tools` and runs it with `fous_run_tool`. Setup for other clients: https://fous.com/llms-full.txt.

## Use cases

- Track scores and schedules across leagues
- Compare team standings by season
- Review a player's season and career statistics
- Find games featuring a specific team
- Plan around game times and venues

## FAQ

### Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

### Can I call this Yahoo Sports tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

### How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

### Do I need a Yahoo Sports account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from sports.yahoo.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.

### What were the scores for a league on a date?

Get scores returns games and scores for the selected league and date, with an optional team filter and time zone.

### Which teams lead the standings?

Get standings returns teams ranked for the selected league and season.

### What are a player's season and career statistics?

Get player stats returns available regular-season and career statistics for the selected player and season.

## Related

- [ESPN API](https://fous.com/tools/espn.md): ESPN provides daily scores and schedules, team results, player statistics, matchup summaries, and latest topic-specific headlines; coverage and published details vary, especially for college and soccer.
- [MLB API](https://fous.com/tools/mlb.md): MLB provides scores, schedules and game details for one date or up to seven days, regular-season division standings defaulting to the current year, and player profiles with regular-season stats for a selected season and career.
- [NFL API](https://fous.com/tools/nfl.md): NFL provides weekly scores and schedules, regular-season standings, current rosters, and player season and career stats; released players are excluded, and ages or stats may be unavailable.
- [NHL API](https://fous.com/tools/nhl.md): NHL provides games, schedules, and scores when published, standings by date, and player profiles with regular-season stats; dates outside a season have no teams, and unavailable stats are null.
- [NBA API](https://fous.com/tools/nba.md): NBA provides up-to-seven-day schedules and scores, seasonal standings, player bios and available regular-season averages, plus matchup box scores, with undated matchups showing the latest.
- [NCAA API](https://fous.com/tools/ncaa.md): NCAA provides college sports scores and schedules from NCAA.com, including date-based games or football weeks, plus latest NCAA.com Top 25 rankings where published.
- [Sports Reference API](https://fous.com/tools/sports-reference.md): Sports Reference provides regular-season career stats, awards and season records across basketball, football, baseball and hockey, plus season leaders using the latest published season if unspecified.
- [Premier League API](https://fous.com/tools/premier-league.md): Premier League provides current/chosen-season tables and recent form, date-range fixtures/results (up to 380), player profiles and stats, and seasonal leaders; older-season stats may be limited.
- [All Sports tools](https://fous.com/tools/category/sports)