---
type: "firecrawl-provider"
description: "Yahoo Fantasy Football public data without a login: player search, a public league's player list with projected and actual stat periods and rank windows, public team rosters and the public Yahoo Sports player news index."
use_when: "Yahoo Fantasy Football public data without a login: player search, a public league's player list with projected and actual stat periods and rank windows, public team rosters and the public Yahoo Sports player news index."
categories: "Sports"
capabilities: 5
credits_per_call: 5
---
# Yahoo Fantasy Football (public) on Firecrawl Alexandria

Yahoo Fantasy Football public data without a login: player search, a public league's player list with projected and actual stat periods and rank windows, public team rosters and the public Yahoo Sports player news index.

- Categories: Sports
- Category index: [Sports category](https://firecrawl.dev/alexandria/agents/categories/sports)
- Provider key: `football-fantasysports-yahoo-com`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://firecrawl.dev/app/alexandria/football-fantasysports-yahoo-com)
- [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/football-fantasysports-yahoo-com/openapi.json)

## Capabilities

- [List players](https://firecrawl.dev/alexandria/agents/providers/football-fantasysports-yahoo-com/fantasy-football-players/list_players): One page (25 rows) of a public league's player list with the league's own filters: availability, position, NFL team, fantasy team, an explicit stat period (projected week / next 4 weeks / season, or actual week / season), sort and offset.
- [Player news](https://firecrawl.dev/alexandria/agents/providers/football-fantasysports-yahoo-com/fantasy-football-players/player_news): Public Yahoo Sports news index for an NFL player: article titles, publisher, source host, canonical and Yahoo links, publish times, as embedded in the sports.yahoo.com news page.
- [Player rankings](https://firecrawl.dev/alexandria/agents/providers/football-fantasysports-yahoo-com/fantasy-football-players/player_rankings): One page (25 rows) of a public league's player list in Ranks mode: projected rank windows (this week, next 4 weeks, season) and actual rank windows (last week, last 4 weeks, season), labelled separately.
- [Public team roster](https://firecrawl.dev/alexandria/agents/providers/football-fantasysports-yahoo-com/fantasy-football-players/public_team_roster): A public league team's roster for one week from Yahoo's read-only Fantasy API: lineup slot per player, player identity, actual fantasy points under the league's scoring and the raw stat lines.
- [Search players](https://firecrawl.dev/alexandria/agents/providers/football-fantasysports-yahoo-com/fantasy-football-players/search_players): Search NFL players by name through Yahoo's read-only Fantasy API inside a public league (the game-level search endpoint ignores its search filter, so a public league is required).

## 1. Choose this provider when

Yahoo Fantasy Football public data without a login: player search, a public league's player list with projected and actual stat periods and rank windows, public team rosters and the public Yahoo Sports player news index.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "football-fantasysports-yahoo-com",
  "capability": "fantasy-football-players/list_players",
  "options": {
    "league_id": "2820",
    "nfl_team": "ET_2",
    "position": "RB",
    "stat_period": "S_S_2026",
    "status": "ALL"
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `fantasy_team_id` (string): Fantasy team id in this league (fteam filter). Pattern: ^[0-9]{1,3}$. Example: `<fantasy_team_id>`
- `league_id` (string): Public league id, the number after /f1/ in a league URL (e.g. 2820). Pattern: ^[0-9]{1,9}$. Example: `<league_id>`
- `league_url` (string): A league page URL; the league id is taken from its /f1/{league_id} segment. Alternative to league_id. Pattern: ^https?://(www\.)?football\.fantasysports\.yahoo\.com/f1/[0-9]{1,9}(/.*)?$. Example: `<league_url>`
- `nfl_team` (string): NFL team filter code from the page's team dropdown (ET_2 = Buffalo). Pattern: ^ET_[0-9]{1,2}$. Example: `<nfl_team>`
- `offset` (number): Row offset; the page serves 25 rows. Use next_offset from the previous page. Example: `0`
- `position` (string): Position tab: O (all offense), QB, WR, RB, TE, K, DEF... as the league's player list offers. Pattern: ^[A-Z][A-Z/]{0,5}$. Example: `O`
- `sdir` (string): Sort direction as the site encodes it (sdir). Example: `1`
- `sort` (string): Sort key as the site encodes it: AR (actual rank), PTS (fantasy points), NAME, PR (projected rank)... Pattern: ^[A-Z0-9_]{1,12}$. Example: `AR`
- `stat_period` (string): Stat period code from the page's dropdown. Projected: S_PW_{week}, S_PN4W, S_PS_{season}, S_PSR_{season}. Actual: S_W_{week}, S_S_{season}, S_AS_{season}. Omitted: the page's default (reported in stat_period). Pattern: ^S_(PW_[0-9]{1,2}|PN4W|PS_[0-9]{4}|PSR_[0-9]{4}|W_[0-9]{1,2}|S_[0-9]{4}|AS_[0-9]{4})$. Example: `<stat_period>`
- `status` (string): Availability in this league: ALL, A (available), FA (free agents), W (waivers), T (taken), K (keepers), STATE_IR (available, IR eligible). Watch list (WL) needs a login and is not supported. Example: `ALL`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "football-fantasysports-yahoo-com",
    capability: "fantasy-football-players/list_players",
    options: {
      league_id: "2820",
      nfl_team: "ET_2",
      position: "RB",
      stat_period: "S_S_2026",
      status: "ALL",
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "football-fantasysports-yahoo-com",
  "capability": "fantasy-football-players/list_players",
  "options": {
    "league_id": "2820",
    "nfl_team": "ET_2",
    "position": "RB",
    "stat_period": "S_S_2026",
    "status": "ALL"
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "football-fantasysports-yahoo-com",
    "capability": "fantasy-football-players/list_players",
    "options": {
      "league_id": "2820",
      "nfl_team": "ET_2",
      "position": "RB",
      "stat_period": "S_S_2026",
      "status": "ALL"
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'football-fantasysports-yahoo-com/fantasy-football-players/list_players' \
  --options '{"league_id":"2820","nfl_team":"ET_2","position":"RB","stat_period":"S_S_2026","status":"ALL"}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "football-fantasysports-yahoo-com",
  "capability": "fantasy-football-players/list_players",
  "options": {
    "league_id": "2820",
    "nfl_team": "ET_2",
    "position": "RB",
    "stat_period": "S_S_2026",
    "status": "ALL"
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "football-fantasysports-yahoo-com",
  "capability": "fantasy-football-players/list_players",
  "options": {
    "league_id": "2820",
    "nfl_team": "ET_2",
    "position": "RB",
    "stat_period": "S_S_2026",
    "status": "ALL"
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "attribution": "Rotowire",
  "columns": [
    {
      "group": null,
      "index": 0,
      "label": "GP",
      "title": "Games Played"
    },
    {
      "group": null,
      "index": 1,
      "label": "Bye",
      "title": "Bye Week"
    },
    {
      "group": "Fantasy",
      "index": 2,
      "label": "Fan Pts",
      "title": "Fantasy Points"
    },
    {
      "group": "Rankings",
      "index": 3,
      "label": "Pre-Season",
      "title": null
    },
    {
      "group": "Rankings",
      "index": 4,
      "label": "Actual",
      "title": null
    },
    {
      "group": "Trends",
      "index": 5,
      "label": "% Ros",
      "title": "Percent player is rostered in Yahoo leagues"
    },
    {
      "group": "Passing",
      "index": 6,
      "label": "Yds",
      "title": "Passing Yards"
    },
    {
      "group": "Passing",
      "index": 7,
      "label": "TD",
      "title": "Passing Touchdowns"
    },
    {
      "group": "Passing",
      "index": 8,
      "label": "Int",
      "title": "Interceptions"
    },
    {
      "group": "Rushing",
      "index": 9,
      "label": "Att",
      "title": "Rushing Attempts"
    },
    {
      "group": "Rushing",
      "index": 10,
      "label": "Yds",
      "title": "Rushing Yards"
    },
    {
      "group": "Rushing",
      "index": 11,
      "label": "TD",
      "title": "Rushing Touchdowns"
    },
    {
      "group": "Receiving",
      "index": 12,
      "label": "Tgt",
      "title": "Targets"
    },
    {
      "group": "Receiving",
      "index": 13,
      "label": "Rec",
      "title": "Receptions"
    },
    {
      "group": "Receiving",
      "index": 14,
      "label": "Yds",
      "title": "Receiving Yards"
    },
    {
      "group": "Receiving",
      "index": 15,
      "label": "TD",
      "title": "Receiving Touchdowns"
    },
    {
      "group": "Ret",
      "index": 16,
      "label": "TD",
      "title": "Return Touchdowns"
    },
    {
      "group": "Misc",
      "index": 17,
      "label": "2PT",
      "title": "2-Point Conversions"
    },
    {
      "group": "Fum",
      "index": 18,
      "label": "Lost",
      "title": "Fumbles Lost"
    }
  ],
  "count": 8,
  "fantasy_team": null,
  "league_id": "2820",
  "league_type": "public",
  "next_offset": null,
  "nfl_team": {
    "code": "ET_2",
    "label": "Buffalo"
  },
  "observed_at_ms": 1791024598506,
  "offset": 0,
  "players": [
    {
      "actual_rank": 36,
      "bye_week": 7,
      "fantasy_points": 48.2,
      "game_status": "Sun 1:00 pm vs NE",
      "games_played": 3,
      "injury_status": null,
      "injury_status_title": null,
      "name": "James Cook III",
      "news_url": "https://sports.yahoo.com/nfl/players/34019/news",
      "nfl_team_abbr": "Buf",
      "opponent": "NE",
      "owner_team_id": "7",
      "percent_rostered": 100,
      "player_id": "34019",
      "positions": "RB",
      "preseason_rank": 8,
      "profile_url": "https://sports.yahoo.com/nfl/players/34019",
      "roster_status": "Placeholder",
      "values": [
        "3",
        "7",
        "48.20",
        "8",
        "36",
        "100%",
        "0",
        "0",
        "0",
        "58",
        "346",
        "2",
        "8",
        "4",
        "16",
        "0",
        "0",
        "0",
        "1"
      ]
    },
    {
      "actual_rank": 317,
      "bye_week": 7,
      "fantasy_points": 7,
      "game_status": "Sun 1:00 pm vs NE",
      "games_played": 1,
      "injury_status": null,
      "injury_status_title": null,
      "name": "Ty Johnson",
      "news_url": "https://sports.yahoo.com/nfl/players/32018/news",
      "nfl_team_abbr": "Buf",
      "opponent": "NE",
      "owner_team_id": null,
      "percent_rostered": 1,
      "player_id": "32018",
      "positions": "RB",
      "preseason_rank": 295,
      "profile_url": "https://sports.yahoo.com/nfl/players/32018",
      "roster_status": "FA",
      "values": [
        "1",
        "7",
        "7.00",
        "295",
        "317",
        "1%",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0",
        "4",
        "4",
        "50",
        "0",
        "0",
        "0",
        "0"
      ]
    },
    {
      "actual_rank": 440,
      "bye_week": 7,
      "fantasy_points": 0.3,
      "game_status": "Sun 1:00 pm vs NE",
      "games_played": 3,
      "injury_status": "Q",
      "injury_status_title": "Questionable",
      "name": "Ray Davis",
      "news_url": "https://sports.yahoo.com/nfl/players/40980/news",
      "nfl_team_abbr": "Buf",
      "opponent": "NE",
      "owner_team_id": null,
      "percent_rostered": 9,
      "player_id": "40980",
      "positions": "RB",
      "preseason_rank": 228,
      "profile_url": "https://sports.yahoo.com/nfl/players/40980",
      "roster_status": "FA",
      "values": [
        "3",
        "7",
        "0.30",
        "228",
        "440",
        "9%",
        "0",
        "0",
        "0",
        "1",
        "3",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0"
      ]
    },
    {
      "actual_rank": 442,
      "bye_week": 7,
      "fantasy_points": 0.3,
      "game_status": "Sun 1:00 pm vs NE",
      "games_played": 2,
      "injury_status": "NA",
      "injury_status_title": "Inactive",
      "name": "Frank Gore Jr.",
      "news_url": "https://sports.yahoo.com/nfl/players/41243/news",
      "nfl_team_abbr": "Buf",
      "opponent": "NE",
      "owner_team_id": null,
      "percent_rostered": 0,
      "player_id": "41243",
      "positions": "RB",
      "preseason_rank": 2716,
      "profile_url": "https://sports.yahoo.com/nfl/players/41243",
      "roster_status": "FA",
      "values": [
        "2",
        "7",
        "0.30",
        "2,716",
        "442",
        "0%",
        "0",
        "0",
        "0",
        "1",
        "3",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0"
      ]
    },
    {
      "actual_rank": 552,
      "bye_week": 7,
      "fantasy_points": 0,
      "game_status": "Sun 1:00 pm vs NE",
      "games_played": null,
      "injury_status": "NA",
      "injury_status_title": "Inactive",
      "name": "Desmond Reid",
      "news_url": "https://sports.yahoo.com/nfl/players/43185/news",
      "nfl_team_abbr": "Buf",
      "opponent": "NE",
      "owner_team_id": null,
      "percent_rostered": 0,
      "player_id": "43185",
      "positions": "RB",
      "preseason_rank": 2535,
      "profile_url": "https://sports.yahoo.com/nfl/players/43185",
      "roster_status": "FA",
      "values": [
        null,
        "7",
        "0.00",
        "2,535",
        "552",
        "0%",
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null
      ]
    },
    {
      "actual_rank": 600,
      "bye_week": 7,
      "fantasy_points": 0,
      "game_status": "Sun 1:00 pm vs NE",
      "games_played": null,
      "injury_status": "NA",
      "injury_status_title": "Inactive",
      "name": "Jackson Acker",
      "news_url": "https://sports.yahoo.com/nfl/players/43331/news",
      "nfl_team_abbr": "Buf",
      "opponent": "NE",
      "owner_team_id": null,
      "percent_rostered": 0,
      "player_id": "43331",
      "positions": "RB",
      "preseason_rank": 2588,
      "profile_url": "https://sports.yahoo.com/nfl/players/43331",
      "roster_status": "FA",
      "values": [
        null,
        "7",
        "0.00",
        "2,588",
        "600",
        "0%",
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null
      ]
    },
    {
      "actual_rank": 615,
      "bye_week": 7,
      "fantasy_points": 0,
      "game_status": "Sun 1:00 pm vs NE",
      "games_played": null,
      "injury_status": "NA",
      "injury_status_title": "Inactive",
      "name": "Ian Wheeler",
      "news_url": "https://sports.yahoo.com/nfl/players/41322/news",
      "nfl_team_abbr": "Buf",
      "opponent": "NE",
      "owner_team_id": null,
      "percent_rostered": 0,
      "player_id": "41322",
      "positions": "RB",
      "preseason_rank": 2561,
      "profile_url": "https://sports.yahoo.com/nfl/players/41322",
      "roster_status": "FA",
      "values": [
        null,
        "7",
        "0.00",
        "2,561",
        "615",
        "0%",
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null
      ]
    },
    {
      "actual_rank": 908,
      "bye_week": 7,
      "fantasy_points": 0,
      "game_status": "Sun 1:00 pm vs NE",
      "games_played": null,
      "injury_status": "NA",
      "injury_status_title": "Inactive",
      "name": "Brock Lampe",
      "news_url": "https://sports.yahoo.com/nfl/players/42293/news",
      "nfl_team_abbr": "Buf",
      "opponent": "NE",
      "owner_team_id": null,
      "percent_rostered": 0,
      "player_id": "42293",
      "positions": "RB",
      "preseason_rank": 2553,
      "profile_url": "https://sports.yahoo.com/nfl/players/42293",
      "roster_status": "FA",
      "values": [
        null,
        "7",
        "0.00",
        "2,553",
        "908",
        "0%",
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null
      ]
    }
  ],
  "position": "RB",
  "scoring_context": "Fantasy points, availability and ownership are specific to this league's scoring and roster settings; the scoring rules themselves are not part of this result.",
  "scoring_type": "head",
  "sdir": "1",
  "sort": "AR",
  "source_url": "https://football.fantasysports.yahoo.com/f1/2820/players?status=ALL&pos=RB&eteam=ET_2&fteam=NONE&cut_type=9&stat1=S_S_2026&myteam=0&sort=AR&sdir=1&count=0",
  "stat_period": {
    "code": "S_S_2026",
    "group": "Season Stats",
    "kind": "actual",
    "label": "Season (total)"
  },
  "stat_periods": [
    {
      "code": "S_PW_4",
      "group": "Projected Stats",
      "label": "Week 4 (proj)"
    },
    {
      "code": "S_PW_5",
      "group": "Projected Stats",
      "label": "Week 5 (proj)"
    },
    {
      "code": "S_PW_6",
      "group": "Projected Stats",
      "label": "Week 6 (proj)"
    },
    {
      "code": "S_PN4W",
      "group": "Projected Stats",
      "label": "Next 4 Weeks (proj)"
    },
    {
      "code": "S_PS_2026",
      "group": "Projected Stats",
      "label": "Season (proj)"
    },
    {
      "code": "S_PSR_2026",
      "group": "Projected Stats",
      "label": "Remaining Games (proj)"
    },
    {
      "code": "S_W_2",
      "group": "Weekly Stats",
      "label": "Week 2"
    },
    {
      "code": "S_W_3",
      "group": "Weekly Stats",
      "label": "Week 3"
    },
    {
      "code": "S_W_4",
      "group": "Weekly Stats",
      "label": "Week 4"
    },
    {
      "code": "S_S_2026",
      "group": "Season Stats",
      "label": "Season (total)"
    },
    {
      "code": "S_S_2025",
      "group": "Season Stats",
      "label": "2025 Season (total)"
    },
    {
      "code": "S_S_2024",
      "group": "Season Stats",
      "label": "2024 Season (total)"
    },
    {
      "code": "S_SPS_2026",
      "group": "Season Stats",
      "label": "Splits: Season"
    },
    {
      "code": "S_SPC",
      "group": "Season Stats",
      "label": "Splits: Career"
    },
    {
      "code": "ADVST_ADVST_2026",
      "group": "Advanced Stats",
      "label": "2026"
    },
    {
      "code": "ADVST_ADVST_2025",
      "group": "Advanced Stats",
      "label": "2025"
    },
    {
      "code": "S_AS_2026",
      "group": "Average Stats",
      "label": "Season (avg)"
    },
    {
      "code": "K_K",
      "group": "Fantasy",
      "label": "Ranks"
    },
    {
      "code": "G_G",
      "group": "Fantasy",
      "label": "Game Day Calls"
    },
    {
      "code": "R_O",
      "group": "Fantasy",
      "label": "Research"
    },
    {
      "code": "M_W",
      "group": "Fantasy",
      "label": "Fantasy Matchups"
    },
    {
      "code": "O_O",
      "group": "Fantasy",
      "label": "Opponents"
    }
  ],
  "status": {
    "code": "ALL",
    "label": "All Players"
  }
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### List players

- Capability: `fantasy-football-players/list_players`
- Description: One page (25 rows) of a public league's player list with the league's own filters: availability, position, NFL team, fantasy team, an explicit stat period (projected week / next 4 weeks / season, or actual week / season), sort and offset.
- Instructions: Browse or rank players by projected or actual fantasy points in a public league. Pass stat_period explicitly (S_PW_5 = Week 5 projections, S_S_2026 = 2026 season totals, S_W_4 = Week 4 actuals, S_PN4W = next 4 weeks projected, S_PS_2026 = season projected). For rank windows use player_rankings.
- Cost: 5 credits per call
- Capability file: [List players](https://firecrawl.dev/alexandria/agents/providers/football-fantasysports-yahoo-com/fantasy-football-players/list_players)

Accepted options:
- `fantasy_team_id` (string): Fantasy team id in this league (fteam filter). Pattern: ^[0-9]{1,3}$. Example: `<fantasy_team_id>`
- `league_id` (string): Public league id, the number after /f1/ in a league URL (e.g. 2820). Pattern: ^[0-9]{1,9}$. Example: `<league_id>`
- `league_url` (string): A league page URL; the league id is taken from its /f1/{league_id} segment. Alternative to league_id. Pattern: ^https?://(www\.)?football\.fantasysports\.yahoo\.com/f1/[0-9]{1,9}(/.*)?$. Example: `<league_url>`
- `nfl_team` (string): NFL team filter code from the page's team dropdown (ET_2 = Buffalo). Pattern: ^ET_[0-9]{1,2}$. Example: `<nfl_team>`
- `offset` (number): Row offset; the page serves 25 rows. Use next_offset from the previous page. Example: `0`
- `position` (string): Position tab: O (all offense), QB, WR, RB, TE, K, DEF... as the league's player list offers. Pattern: ^[A-Z][A-Z/]{0,5}$. Example: `O`
- `sdir` (string): Sort direction as the site encodes it (sdir). Example: `1`
- `sort` (string): Sort key as the site encodes it: AR (actual rank), PTS (fantasy points), NAME, PR (projected rank)... Pattern: ^[A-Z0-9_]{1,12}$. Example: `AR`
- `stat_period` (string): Stat period code from the page's dropdown. Projected: S_PW_{week}, S_PN4W, S_PS_{season}, S_PSR_{season}. Actual: S_W_{week}, S_S_{season}, S_AS_{season}. Omitted: the page's default (reported in stat_period). Pattern: ^S_(PW_[0-9]{1,2}|PN4W|PS_[0-9]{4}|PSR_[0-9]{4}|W_[0-9]{1,2}|S_[0-9]{4}|AS_[0-9]{4})$. Example: `<stat_period>`
- `status` (string): Availability in this league: ALL, A (available), FA (free agents), W (waivers), T (taken), K (keepers), STATE_IR (available, IR eligible). Watch list (WL) needs a login and is not supported. Example: `ALL`

Response schema example:
```json
{
  "attribution": "Rotowire",
  "columns": [
    {
      "group": null,
      "index": 0,
      "label": "GP",
      "title": "Games Played"
    },
    {
      "group": null,
      "index": 1,
      "label": "Bye",
      "title": "Bye Week"
    },
    {
      "group": "Fantasy",
      "index": 2,
      "label": "Fan Pts",
      "title": "Fantasy Points"
    },
    {
      "group": "Rankings",
      "index": 3,
      "label": "Pre-Season",
      "title": null
    },
    {
      "group": "Rankings",
      "index": 4,
      "label": "Actual",
      "title": null
    },
    {
      "group": "Trends",
      "index": 5,
      "label": "% Ros",
      "title": "Percent player is rostered in Yahoo leagues"
    },
    {
      "group": "Passing",
      "index": 6,
      "label": "Yds",
      "title": "Passing Yards"
    },
    {
      "group": "Passing",
      "index": 7,
      "label": "TD",
      "title": "Passing Touchdowns"
    },
    {
      "group": "Passing",
      "index": 8,
      "label": "Int",
      "title": "Interceptions"
    },
    {
      "group": "Rushing",
      "index": 9,
      "label": "Att",
      "title": "Rushing Attempts"
    },
    {
      "group": "Rushing",
      "index": 10,
      "label": "Yds",
      "title": "Rushing Yards"
    },
    {
      "group": "Rushing",
      "index": 11,
      "label": "TD",
      "title": "Rushing Touchdowns"
    },
    {
      "group": "Receiving",
      "index": 12,
      "label": "Tgt",
      "title": "Targets"
    },
    {
      "group": "Receiving",
      "index": 13,
      "label": "Rec",
      "title": "Receptions"
    },
    {
      "group": "Receiving",
      "index": 14,
      "label": "Yds",
      "title": "Receiving Yards"
    },
    {
      "group": "Receiving",
      "index": 15,
      "label": "TD",
      "title": "Receiving Touchdowns"
    },
    {
      "group": "Ret",
      "index": 16,
      "label": "TD",
      "title": "Return Touchdowns"
    },
    {
      "group": "Misc",
      "index": 17,
      "label": "2PT",
      "title": "2-Point Conversions"
    },
    {
      "group": "Fum",
      "index": 18,
      "label": "Lost",
      "title": "Fumbles Lost"
    }
  ],
  "count": 8,
  "fantasy_team": null,
  "league_id": "2820",
  "league_type": "public",
  "next_offset": null,
  "nfl_team": {
    "code": "ET_2",
    "label": "Buffalo"
  },
  "observed_at_ms": 1791024598506,
  "offset": 0,
  "players": [
    {
      "actual_rank": 36,
      "bye_week": 7,
      "fantasy_points": 48.2,
      "game_status": "Sun 1:00 pm vs NE",
      "games_played": 3,
      "injury_status": null,
      "injury_status_title": null,
      "name": "James Cook III",
      "news_url": "https://sports.yahoo.com/nfl/players/34019/news",
      "nfl_team_abbr": "Buf",
      "opponent": "NE",
      "owner_team_id": "7",
      "percent_rostered": 100,
      "player_id": "34019",
      "positions": "RB",
      "preseason_rank": 8,
      "profile_url": "https://sports.yahoo.com/nfl/players/34019",
      "roster_status": "Placeholder",
      "values": [
        "3",
        "7",
        "48.20",
        "8",
        "36",
        "100%",
        "0",
        "0",
        "0",
        "58",
        "346",
        "2",
        "8",
        "4",
        "16",
        "0",
        "0",
        "0",
        "1"
      ]
    },
    {
      "actual_rank": 317,
      "bye_week": 7,
      "fantasy_points": 7,
      "game_status": "Sun 1:00 pm vs NE",
      "games_played": 1,
      "injury_status": null,
      "injury_status_title": null,
      "name": "Ty Johnson",
      "news_url": "https://sports.yahoo.com/nfl/players/32018/news",
      "nfl_team_abbr": "Buf",
      "opponent": "NE",
      "owner_team_id": null,
      "percent_rostered": 1,
      "player_id": "32018",
      "positions": "RB",
      "preseason_rank": 295,
      "profile_url": "https://sports.yahoo.com/nfl/players/32018",
      "roster_status": "FA",
      "values": [
        "1",
        "7",
        "7.00",
        "295",
        "317",
        "1%",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0",
        "4",
        "4",
        "50",
        "0",
        "0",
        "0",
        "0"
      ]
    },
    {
      "actual_rank": 440,
      "bye_week": 7,
      "fantasy_points": 0.3,
      "game_status": "Sun 1:00 pm vs NE",
      "games_played": 3,
      "injury_status": "Q",
      "injury_status_title": "Questionable",
      "name": "Ray Davis",
      "news_url": "https://sports.yahoo.com/nfl/players/40980/news",
      "nfl_team_abbr": "Buf",
      "opponent": "NE",
      "owner_team_id": null,
      "percent_rostered": 9,
      "player_id": "40980",
      "positions": "RB",
      "preseason_rank": 228,
      "profile_url": "https://sports.yahoo.com/nfl/players/40980",
      "roster_status": "FA",
      "values": [
        "3",
        "7",
        "0.30",
        "228",
        "440",
        "9%",
        "0",
        "0",
        "0",
        "1",
        "3",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0"
      ]
    },
    {
      "actual_rank": 442,
      "bye_week": 7,
      "fantasy_points": 0.3,
      "game_status": "Sun 1:00 pm vs NE",
      "games_played": 2,
      "injury_status": "NA",
      "injury_status_title": "Inactive",
      "name": "Frank Gore Jr.",
      "news_url": "https://sports.yahoo.com/nfl/players/41243/news",
      "nfl_team_abbr": "Buf",
      "opponent": "NE",
      "owner_team_id": null,
      "percent_rostered": 0,
      "player_id": "41243",
      "positions": "RB",
      "preseason_rank": 2716,
      "profile_url": "https://sports.yahoo.com/nfl/players/41243",
      "roster_status": "FA",
      "values": [
        "2",
        "7",
        "0.30",
        "2,716",
        "442",
        "0%",
        "0",
        "0",
        "0",
        "1",
        "3",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0"
      ]
    },
    {
      "actual_rank": 552,
      "bye_week": 7,
      "fantasy_points": 0,
      "game_status": "Sun 1:00 pm vs NE",
      "games_played": null,
      "injury_status": "NA",
      "injury_status_title": "Inactive",
      "name": "Desmond Reid",
      "news_url": "https://sports.yahoo.com/nfl/players/43185/news",
      "nfl_team_abbr": "Buf",
      "opponent": "NE",
      "owner_team_id": null,
      "percent_rostered": 0,
      "player_id": "43185",
      "positions": "RB",
      "preseason_rank": 2535,
      "profile_url": "https://sports.yahoo.com/nfl/players/43185",
      "roster_status": "FA",
      "values": [
        null,
        "7",
        "0.00",
        "2,535",
        "552",
        "0%",
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null
      ]
    },
    {
      "actual_rank": 600,
      "bye_week": 7,
      "fantasy_points": 0,
      "game_status": "Sun 1:00 pm vs NE",
      "games_played": null,
      "injury_status": "NA",
      "injury_status_title": "Inactive",
      "name": "Jackson Acker",
      "news_url": "https://sports.yahoo.com/nfl/players/43331/news",
      "nfl_team_abbr": "Buf",
      "opponent": "NE",
      "owner_team_id": null,
      "percent_rostered": 0,
      "player_id": "43331",
      "positions": "RB",
      "preseason_rank": 2588,
      "profile_url": "https://sports.yahoo.com/nfl/players/43331",
      "roster_status": "FA",
      "values": [
        null,
        "7",
        "0.00",
        "2,588",
        "600",
        "0%",
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null
      ]
    },
    {
      "actual_rank": 615,
      "bye_week": 7,
      "fantasy_points": 0,
      "game_status": "Sun 1:00 pm vs NE",
      "games_played": null,
      "injury_status": "NA",
      "injury_status_title": "Inactive",
      "name": "Ian Wheeler",
      "news_url": "https://sports.yahoo.com/nfl/players/41322/news",
      "nfl_team_abbr": "Buf",
      "opponent": "NE",
      "owner_team_id": null,
      "percent_rostered": 0,
      "player_id": "41322",
      "positions": "RB",
      "preseason_rank": 2561,
      "profile_url": "https://sports.yahoo.com/nfl/players/41322",
      "roster_status": "FA",
      "values": [
        null,
        "7",
        "0.00",
        "2,561",
        "615",
        "0%",
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null
      ]
    },
    {
      "actual_rank": 908,
      "bye_week": 7,
      "fantasy_points": 0,
      "game_status": "Sun 1:00 pm vs NE",
      "games_played": null,
      "injury_status": "NA",
      "injury_status_title": "Inactive",
      "name": "Brock Lampe",
      "news_url": "https://sports.yahoo.com/nfl/players/42293/news",
      "nfl_team_abbr": "Buf",
      "opponent": "NE",
      "owner_team_id": null,
      "percent_rostered": 0,
      "player_id": "42293",
      "positions": "RB",
      "preseason_rank": 2553,
      "profile_url": "https://sports.yahoo.com/nfl/players/42293",
      "roster_status": "FA",
      "values": [
        null,
        "7",
        "0.00",
        "2,553",
        "908",
        "0%",
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null,
        null
      ]
    }
  ],
  "position": "RB",
  "scoring_context": "Fantasy points, availability and ownership are specific to this league's scoring and roster settings; the scoring rules themselves are not part of this result.",
  "scoring_type": "head",
  "sdir": "1",
  "sort": "AR",
  "source_url": "https://football.fantasysports.yahoo.com/f1/2820/players?status=ALL&pos=RB&eteam=ET_2&fteam=NONE&cut_type=9&stat1=S_S_2026&myteam=0&sort=AR&sdir=1&count=0",
  "stat_period": {
    "code": "S_S_2026",
    "group": "Season Stats",
    "kind": "actual",
    "label": "Season (total)"
  },
  "stat_periods": [
    {
      "code": "S_PW_4",
      "group": "Projected Stats",
      "label": "Week 4 (proj)"
    },
    {
      "code": "S_PW_5",
      "group": "Projected Stats",
      "label": "Week 5 (proj)"
    },
    {
      "code": "S_PW_6",
      "group": "Projected Stats",
      "label": "Week 6 (proj)"
    },
    {
      "code": "S_PN4W",
      "group": "Projected Stats",
      "label": "Next 4 Weeks (proj)"
    },
    {
      "code": "S_PS_2026",
      "group": "Projected Stats",
      "label": "Season (proj)"
    },
    {
      "code": "S_PSR_2026",
      "group": "Projected Stats",
      "label": "Remaining Games (proj)"
    },
    {
      "code": "S_W_2",
      "group": "Weekly Stats",
      "label": "Week 2"
    },
    {
      "code": "S_W_3",
      "group": "Weekly Stats",
      "label": "Week 3"
    },
    {
      "code": "S_W_4",
      "group": "Weekly Stats",
      "label": "Week 4"
    },
    {
      "code": "S_S_2026",
      "group": "Season Stats",
      "label": "Season (total)"
    },
    {
      "code": "S_S_2025",
      "group": "Season Stats",
      "label": "2025 Season (total)"
    },
    {
      "code": "S_S_2024",
      "group": "Season Stats",
      "label": "2024 Season (total)"
    },
    {
      "code": "S_SPS_2026",
      "group": "Season Stats",
      "label": "Splits: Season"
    },
    {
      "code": "S_SPC",
      "group": "Season Stats",
      "label": "Splits: Career"
    },
    {
      "code": "ADVST_ADVST_2026",
      "group": "Advanced Stats",
      "label": "2026"
    },
    {
      "code": "ADVST_ADVST_2025",
      "group": "Advanced Stats",
      "label": "2025"
    },
    {
      "code": "S_AS_2026",
      "group": "Average Stats",
      "label": "Season (avg)"
    },
    {
      "code": "K_K",
      "group": "Fantasy",
      "label": "Ranks"
    },
    {
      "code": "G_G",
      "group": "Fantasy",
      "label": "Game Day Calls"
    },
    {
      "code": "R_O",
      "group": "Fantasy",
      "label": "Research"
    },
    {
      "code": "M_W",
      "group": "Fantasy",
      "label": "Fantasy Matchups"
    },
    {
      "code": "O_O",
      "group": "Fantasy",
      "label": "Opponents"
    }
  ],
  "status": {
    "code": "ALL",
    "label": "All Players"
  }
}
```

### Player news

- Capability: `fantasy-football-players/player_news`
- Description: Public Yahoo Sports news index for an NFL player: article titles, publisher, source host, canonical and Yahoo links, publish times, as embedded in the sports.yahoo.com news page.
- Instructions: Recent news about a player resolved by search_players (news_url / player_id). Does not use the login-gated Fantasy player-note panel.
- Cost: 5 credits per call
- Capability file: [Player news](https://firecrawl.dev/alexandria/agents/providers/football-fantasysports-yahoo-com/fantasy-football-players/player_news)

Accepted options:
- `player_id` (string): Yahoo player id (e.g. 30977). Pattern: ^[0-9]{1,9}$. Example: `<player_id>`
- `player_url` (string): Pattern: ^https?://(www\.)?sports\.yahoo\.com/nfl/players/[0-9]{1,9}(/.*)?$. Example: `<player_url>`

Response schema example:
```json
{
  "count": 10,
  "items": [
    {
      "authors": [
        "Bernd Buchmasser"
      ],
      "canonical_url": "https://www.patspulpit.com/new-england-patriots-news/139229/patriots-defense-second-play-bills-qb-josh-allen",
      "clickthrough_url": "https://sports.yahoo.com/articles/patriots-worried-second-play-bills-100000812.html",
      "content_type": "Story",
      "display_time": "2026-10-03T10:00:00Z",
      "id": "175c955d-4d08-3576-955f-fe9bfbbb63f4",
      "provider": "SB Nation",
      "publish_time": "2026-10-03T10:00:00Z",
      "source_host": "patspulpit.com",
      "summary": "Buffalo’s quarterback is presenting all sorts of problems for the Patriots defense.",
      "title": "Patriots worried about ‘second play’ with Bills QB Josh Allen"
    },
    {
      "authors": [
        "Nick Sabato, Niagara Gazette, Niagara Falls, N.Y."
      ],
      "canonical_url": "https://www.niagara-gazette.com/sports/josh-allen-drake-maye-take-the-spotlight-as-defensive-injuries-headline-bills-patriots-tilt/article_ee583b55-720d-45ed-8e29-e53bf591edce.html",
      "clickthrough_url": "https://sports.yahoo.com/articles/josh-allen-drake-maye-spotlight-214600666.html",
      "content_type": "Story",
      "display_time": "2026-10-02T21:46:00Z",
      "id": "591bcb26-009e-3308-8b2f-3d078066ede2",
      "provider": "Niagara Gazette, Niagara Falls, N.Y.",
      "publish_time": "2026-10-02T21:46:00Z",
      "source_host": "niagara-gazette.com",
      "summary": "ORCHARD PARK — Injuries have been the theme of the highly-anticipated matchup between the Buffalo Bills and New England Patriots. But the concerns to start the week weren’t the concerns to end it for either team. Bills quarterback Josh Allen had a pronounced limp in his right leg following last week’s 24-16 win over the Los Angeles Chargers. Coach Joe Brady, now known for his unwillingness to ...",
      "title": "Josh Allen, Drake Maye take the spotlight as defensive injuries headline Bills-Patriots tilt"
    },
    {
      "authors": [
        "Matt Byham"
      ],
      "canonical_url": "https://www.buffalorumblings.com/buffalo-bills-odds/141643/bills-vs-patriots-predictions-week-3-picks",
      "clickthrough_url": "https://sports.yahoo.com/articles/3-bold-takes-bills-patriots-213755958.html",
      "content_type": "Story",
      "display_time": "2026-10-02T21:37:55Z",
      "id": "a55d1455-dba2-336f-9788-fb3ef3d1c076",
      "provider": "SB Nation",
      "publish_time": "2026-10-02T21:37:55Z",
      "source_host": "buffalorumblings.com",
      "summary": "Quarterback Josh Allen and the Buffalo Bills are likely extra motivated to face the New England Patriots in Week 4",
      "title": "3 bold takes for Bills-Patriots in Week 4"
    },
    {
      "authors": [
        "Khari Demos"
      ],
      "canonical_url": "https://www.si.com/nfl/bills/onsi/nfl-legend-phillip-rivers-on-intimidating-aspect-of-bills-head-coaching-interview",
      "clickthrough_url": "https://sports.yahoo.com/articles/nfl-legend-phillip-rivers-intimidating-204835732.html",
      "content_type": "Story",
      "display_time": "2026-10-02T20:48:35Z",
      "id": "3e4a511f-049d-3c3a-9bf6-e7135b278c7c",
      "provider": "Buffalo Bills On SI",
      "publish_time": "2026-10-02T20:48:35Z",
      "source_host": "si.com",
      "summary": "Remember when Phillip Rivers was almost the head coach of the Buffalo Bills? During last year's hiring cycle, the Bills entertained an out-of-left-field coaching candidate as Sean McDermott's successor: the 18-year NFL veteran.",
      "title": "NFL Legend Phillip Rivers on Intimidating Aspect of Bills' Head Coaching Interview"
    },
    {
      "authors": [
        "David Suggs"
      ],
      "canonical_url": "https://www.sportingnews.com/us/nfl/news/josh-allen-pace-nfl-record-bills/d96a9b487fad503c196f8dee",
      "clickthrough_url": "https://sports.yahoo.com/articles/josh-allen-pace-nfl-record-181447935.html",
      "content_type": "Story",
      "display_time": "2026-10-02T18:14:47Z",
      "id": "a2b2009f-21f3-37c0-a1d8-84499980555f",
      "provider": "The Sporting News",
      "publish_time": "2026-10-02T18:14:47Z",
      "source_host": "sportingnews.com",
      "summary": "Allen is one of four players to score at least two rushing touchdowns in three straight games to start the year.",
      "title": "Josh Allen is on pace for an NFL record that's never been done before"
    },
    {
      "authors": [
        "Michael Hurley"
      ],
      "canonical_url": "https://www.nbcsportsboston.com/nfl/new-england-patriots/drake-maye-learn-from-josh-allen/805818/?partner=yahoo",
      "clickthrough_url": "https://sports.yahoo.com/articles/drake-maye-learn-josh-allen-175545722.html",
      "content_type": "Story",
      "display_time": "2026-10-02T17:55:45Z",
      "id": "7c3da2fa-f127-3601-b6e8-4e2c2afc5df2",
      "provider": "NBC Sports Boston",
      "publish_time": "2026-10-02T17:55:45Z",
      "source_host": "nbcsportsboston.com",
      "summary": "With the two AFC East quarterbacks set to meet, can Maye follow a similar path to Allen?",
      "title": "What can Drake Maye learn from Josh Allen?"
    },
    {
      "authors": [
        "Ashish Mathur"
      ],
      "canonical_url": "https://roundtable.io/sports/nfl/pats/news/patriots-announce-brutal-christian-gonzalez-ahead-of-bills-game",
      "clickthrough_url": "https://sports.yahoo.com/articles/patriots-announce-brutal-christian-gonzalez-172849549.html",
      "content_type": "Story",
      "display_time": "2026-10-02T17:28:49Z",
      "id": "228a6484-60de-3c9b-abfd-1467146c5d1d",
      "provider": "Roundtable Sports",
      "publish_time": "2026-10-02T17:28:49Z",
      "source_host": "roundtable.io",
      "summary": "This is not good.",
      "title": "Patriots Announce Brutal Christian Gonzalez News Ahead of Bills Game"
    },
    {
      "authors": [
        "Sean Murphy"
      ],
      "canonical_url": "https://www.buffalorumblings.com/buffalo-bills-analysis/141786/5-buffalo-bills-to-watch-vs-the-new-england-patriots",
      "clickthrough_url": "https://sports.yahoo.com/articles/5-bills-watch-vs-patriots-170000576.html",
      "content_type": "Story",
      "display_time": "2026-10-02T17:00:00Z",
      "id": "a1daf71d-c020-3859-a252-8af559fcdd80",
      "provider": "SB Nation",
      "publish_time": "2026-10-02T17:00:00Z",
      "source_host": "buffalorumblings.com",
      "summary": "The Bills can take a commanding lead in the division with a win this week",
      "title": "5 Bills to watch vs. Patriots"
    },
    {
      "authors": [
        "Ashish Mathur"
      ],
      "canonical_url": "https://roundtable.io/sports/nfl/bills/news/espn-nfl-experts-unanimously-pick-winner-of-bills-patriots-week-4-game",
      "clickthrough_url": "https://sports.yahoo.com/articles/espn-nfl-experts-unanimously-pick-164618735.html",
      "content_type": "Story",
      "display_time": "2026-10-02T16:46:18Z",
      "id": "40168c45-0bde-363b-b245-77aebd59d4c7",
      "provider": "Roundtable Sports",
      "publish_time": "2026-10-02T16:46:18Z",
      "source_host": "roundtable.io",
      "summary": "ESPN NFL experts have picked the winner of the Buffalo Bills-New England Patriots Week 4 game.",
      "title": "ESPN NFL Experts Unanimously Pick Winner of Bills-Patriots Week 4 Game"
    },
    {
      "authors": [
        "Jordy McElroy, Patriots Wire"
      ],
      "canonical_url": "https://patriotswire.usatoday.com/story/sports/nfl/patriots/2026/10/02/bills-josh-allen-prediction-patriots-drake-maye/92057848007/",
      "clickthrough_url": "https://sports.yahoo.com/articles/josh-allen-makes-strong-prediction-164408113.html",
      "content_type": "Story",
      "display_time": "2026-10-02T16:44:08Z",
      "id": "d16b4321-8d06-3bf0-a787-8e57606e9811",
      "provider": "Patriots Wire",
      "publish_time": "2026-10-02T16:44:08Z",
      "source_host": "patriotswire.usatoday.com",
      "summary": "Josh Allen is confident that Patriots quarterback Drake Maye will snap out of his current slump.",
      "title": "Josh Allen makes strong prediction on Patriots QB Drake Maye"
    }
  ],
  "observed_at_ms": 1791024638735,
  "player_id": "30977",
  "player_name": "Josh Allen",
  "source_url": "https://sports.yahoo.com/nfl/players/30977/news/"
}
```

### Player rankings

- Capability: `fantasy-football-players/player_rankings`
- Description: One page (25 rows) of a public league's player list in Ranks mode: projected rank windows (this week, next 4 weeks, season) and actual rank windows (last week, last 4 weeks, season), labelled separately.
- Instructions: Compare players by Yahoo's projected vs actual rank windows in a public league. Sort with PR_W, PR_N4W, PR_S (projected) or AR_LW, AR_L4W, AR_S (actual); page with offset.
- Cost: 5 credits per call
- Capability file: [Player rankings](https://firecrawl.dev/alexandria/agents/providers/football-fantasysports-yahoo-com/fantasy-football-players/player_rankings)

Accepted options:
- `fantasy_team_id` (string): Fantasy team id in this league (fteam filter). Pattern: ^[0-9]{1,3}$. Example: `<fantasy_team_id>`
- `league_id` (string): Public league id, the number after /f1/ in a league URL (e.g. 2820). Pattern: ^[0-9]{1,9}$. Example: `<league_id>`
- `league_url` (string): A league page URL; the league id is taken from its /f1/{league_id} segment. Alternative to league_id. Pattern: ^https?://(www\.)?football\.fantasysports\.yahoo\.com/f1/[0-9]{1,9}(/.*)?$. Example: `<league_url>`
- `nfl_team` (string): NFL team filter code from the page's team dropdown (ET_2 = Buffalo). Pattern: ^ET_[0-9]{1,2}$. Example: `<nfl_team>`
- `offset` (number): Row offset; the page serves 25 rows. Use next_offset from the previous page. Example: `0`
- `position` (string): Position tab: O (all offense), QB, WR, RB, TE, K, DEF... as the league's player list offers. Pattern: ^[A-Z][A-Z/]{0,5}$. Example: `O`
- `sdir` (string): Sort direction as the site encodes it (sdir). Example: `1`
- `sort` (string): Rank column to sort by: PR_W / PR_N4W / PR_S projected (this week / next 4 weeks / season), AR_LW / AR_L4W / AR_S actual (last week / last 4 weeks / season). Example: `AR_S`
- `status` (string): Availability in this league: ALL, A (available), FA (free agents), W (waivers), T (taken), K (keepers), STATE_IR (available, IR eligible). Watch list (WL) needs a login and is not supported. Example: `ALL`

Response schema example:
```json
{
  "attribution": "Rotowire",
  "count": 25,
  "fantasy_team": null,
  "league_id": "2820",
  "league_type": "public",
  "next_offset": 25,
  "nfl_team": null,
  "observed_at_ms": 1791024614060,
  "offset": 0,
  "players": [
    {
      "actual": {
        "last_4_weeks": 1,
        "last_week": 37,
        "season": 1
      },
      "game_status": "Sun 1:00 pm vs NE",
      "injury_status": null,
      "injury_status_title": null,
      "name": "Josh Allen",
      "news_url": "https://sports.yahoo.com/nfl/players/30977/news",
      "nfl_team_abbr": "Buf",
      "opponent": "NE",
      "owner_team_id": "6",
      "player_id": "30977",
      "positions": "QB",
      "profile_url": "https://sports.yahoo.com/nfl/players/30977",
      "projected": {
        "next_4_weeks": 12,
        "season": 1,
        "this_week": 1
      },
      "roster_status": "Camden's Commanders"
    },
    {
      "actual": {
        "last_4_weeks": 4,
        "last_week": 3,
        "season": 4
      },
      "game_status": "Sun 4:25 pm vs Den",
      "injury_status": null,
      "injury_status_title": null,
      "name": "Brock Purdy",
      "news_url": "https://sports.yahoo.com/nfl/players/34218/news",
      "nfl_team_abbr": "SF",
      "opponent": "Den",
      "owner_team_id": "3",
      "player_id": "34218",
      "positions": "QB",
      "profile_url": "https://sports.yahoo.com/nfl/players/34218",
      "projected": {
        "next_4_weeks": 6,
        "season": 4,
        "this_week": 12
      },
      "roster_status": "Maxee B"
    },
    {
      "actual": {
        "last_4_weeks": 7,
        "last_week": 9,
        "season": 7
      },
      "game_status": "Mon 8:15 pm vs Atl",
      "injury_status": null,
      "injury_status_title": null,
      "name": "Tyler Shough",
      "news_url": "https://sports.yahoo.com/nfl/players/41825/news",
      "nfl_team_abbr": "NO",
      "opponent": "Atl",
      "owner_team_id": "1",
      "player_id": "41825",
      "positions": "QB",
      "profile_url": "https://sports.yahoo.com/nfl/players/41825",
      "projected": {
        "next_4_weeks": 7,
        "season": 8,
        "this_week": 8
      },
      "roster_status": "team 1 (bad)"
    },
    {
      "actual": {
        "last_4_weeks": 9,
        "last_week": 66,
        "season": 9
      },
      "game_status": "Sun 8:20 pm vs Det",
      "injury_status": null,
      "injury_status_title": null,
      "name": "Bryce Young",
      "news_url": "https://sports.yahoo.com/nfl/players/40029/news",
      "nfl_team_abbr": "Car",
      "opponent": "Det",
      "owner_team_id": "5",
      "player_id": "40029",
      "positions": "QB",
      "profile_url": "https://sports.yahoo.com/nfl/players/40029",
      "projected": {
        "next_4_weeks": 48,
        "season": 18,
        "this_week": 11
      },
      "roster_status": "Hurts when Bijan runs"
    },
    {
      "actual": {
        "last_4_weeks": 10,
        "last_week": 27,
        "season": 10
      },
      "game_status": "Final W 27-24 vs Pit",
      "injury_status": null,
      "injury_status_title": null,
      "name": "Deshaun Watson",
      "news_url": "https://sports.yahoo.com/nfl/players/30125/news",
      "nfl_team_abbr": "Cle",
      "opponent": "Pit",
      "owner_team_id": null,
      "player_id": "30125",
      "positions": "QB",
      "profile_url": "https://sports.yahoo.com/nfl/players/30125",
      "projected": {
        "next_4_weeks": 33,
        "season": 69,
        "this_week": 33
      },
      "roster_status": "W (Oct 7)"
    },
    {
      "actual": {
        "last_4_weeks": 11,
        "last_week": 50,
        "season": 11
      },
      "game_status": "Sun 4:25 pm @ LV",
      "injury_status": null,
      "injury_status_title": null,
      "name": "Patrick Mahomes",
      "news_url": "https://sports.yahoo.com/nfl/players/30123/news",
      "nfl_team_abbr": "KC",
      "opponent": "LV",
      "owner_team_id": "2",
      "player_id": "30123",
      "positions": "QB",
      "profile_url": "https://sports.yahoo.com/nfl/players/30123",
      "projected": {
        "next_4_weeks": 39,
        "season": 11,
        "this_week": 5
      },
      "roster_status": "Decades of Failure"
    },
    {
      "actual": {
        "last_4_weeks": 12,
        "last_week": 33,
        "season": 12
      },
      "game_status": "Sun 8:20 pm @ Car",
      "injury_status": null,
      "injury_status_title": null,
      "name": "Jared Goff",
      "news_url": "https://sports.yahoo.com/nfl/players/29235/news",
      "nfl_team_abbr": "Det",
      "opponent": "Car",
      "owner_team_id": "4",
      "player_id": "29235",
      "positions": "QB",
      "profile_url": "https://sports.yahoo.com/nfl/players/29235",
      "projected": {
        "next_4_weeks": 25,
        "season": 10,
        "this_week": 14
      },
      "roster_status": "Endzone Mike 9-7 B-"
    },
    {
      "actual": {
        "last_4_weeks": 13,
        "last_week": 12,
        "season": 13
      },
      "game_status": "Final L 24-27 @ Cle",
      "injury_status": null,
      "injury_status_title": null,
      "name": "Aaron Rodgers",
      "news_url": "https://sports.yahoo.com/nfl/players/7200/news",
      "nfl_team_abbr": "Pit",
      "opponent": "Cle",
      "owner_team_id": null,
      "player_id": "7200",
      "positions": "QB",
      "profile_url": "https://sports.yahoo.com/nfl/players/7200",
      "projected": {
        "next_4_weeks": 21,
        "season": 43,
        "this_week": 47
      },
      "roster_status": "W (Oct 7)"
    },
    {
      "actual": {
        "last_4_weeks": 15,
        "last_week": 38,
        "season": 15
      },
      "game_status": "Sun 1:00 pm @ Hou",
      "injury_status": null,
      "injury_status_title": null,
      "name": "Dak Prescott",
      "news_url": "https://sports.yahoo.com/nfl/players/29369/news",
      "nfl_team_abbr": "Dal",
      "opponent": "Hou",
      "owner_team_id": "4",
      "player_id": "29369",
      "positions": "QB",
      "profile_url": "https://sports.yahoo.com/nfl/players/29369",
      "projected": {
        "next_4_weeks": 4,
        "season": 6,
        "this_week": 13
      },
      "roster_status": "Endzone Mike 9-7 B-"
    },
    {
      "actual": {
        "last_4_weeks": 16,
        "last_week": 22,
        "season": 16
      },
      "game_status": "Sun 1:00 pm vs Ten",
      "injury_status": null,
      "injury_status_title": null,
      "name": "Lamar Jackson",
      "news_url": "https://sports.yahoo.com/nfl/players/31002/news",
      "nfl_team_abbr": "Bal",
      "opponent": "Ten",
      "owner_team_id": "10",
      "player_id": "31002",
      "positions": "QB",
      "profile_url": "https://sports.yahoo.com/nfl/players/31002",
      "projected": {
        "next_4_weeks": 1,
        "season": 3,
        "this_week": 3
      },
      "roster_status": "Shotgun Jaxon"
    },
    {
      "actual": {
        "last_4_weeks": 19,
        "last_week": 17,
        "season": 19
      },
      "game_status": "Sun 4:25 pm vs KC",
      "injury_status": null,
      "injury_status_title": null,
      "name": "Kirk Cousins",
      "news_url": "https://sports.yahoo.com/nfl/players/25812/news",
      "nfl_team_abbr": "LV",
      "opponent": "KC",
      "owner_team_id": null,
      "player_id": "25812",
      "positions": "QB",
      "profile_url": "https://sports.yahoo.com/nfl/players/25812",
      "projected": {
        "next_4_weeks": 24,
        "season": 41,
        "this_week": 34
      },
      "roster_status": "FA"
    },
    {
      "actual": {
        "last_4_weeks": 23,
        "last_week": 71,
        "season": 23
      },
      "game_status": "Sun 1:00 pm vs LAR",
      "injury_status": null,
      "injury_status_title": null,
      "name": "Jalen Hurts",
      "news_url": "https://sports.yahoo.com/nfl/players/32723/news",
      "nfl_team_abbr": "Phi",
      "opponent": "LAR",
      "owner_team_id": "5",
      "player_id": "32723",
      "positions": "QB",
      "profile_url": "https://sports.yahoo.com/nfl/players/32723",
      "projected": {
        "next_4_weeks": 9,
        "season": 14,
        "this_week": 30
      },
      "roster_status": "Hurts when Bijan runs"
    },
    {
      "actual": {
        "last_4_weeks": 24,
        "last_week": 14,
        "season": 24
      },
      "game_status": "Sun 1:00 pm @ Phi",
      "injury_status": null,
      "injury_status_title": null,
      "name": "Matthew Stafford",
      "news_url": "https://sports.yahoo.com/nfl/players/9265/news",
      "nfl_team_abbr": "LAR",
      "opponent": "Phi",
      "owner_team_id": "1",
      "player_id": "9265",
      "positions": "QB",
      "profile_url": "https://sports.yahoo.com/nfl/players/9265",
      "projected": {
        "next_4_weeks": 8,
        "season": 13,
        "this_week": 29
      },
      "roster_status": "team 1 (bad)"
    },
    {
      "actual": {
        "last_4_weeks": 25,
        "last_week": 20,
        "season": 25
      },
      "game_status": "Sun 1:00 pm @ Cin",
      "injury_status": null,
      "injury_status_title": null,
      "name": "Trevor Lawrence",
      "news_url": "https://sports.yahoo.com/nfl/players/33389/news",
      "nfl_team_abbr": "Jax",
      "opponent": "Cin",
      "owner_team_id": "3",
      "player_id": "33389",
      "positions": "QB",
      "profile_url": "https://sports.yahoo.com/nfl/players/33389",
      "projected": {
        "next_4_weeks": 27,
        "season": 9,
        "this_week": 7
      },
      "roster_status": "Maxee B"
    },
    {
      "actual": {
        "last_4_weeks": 26,
        "last_week": 16,
        "season": 26
      },
      "game_status": "Sun 1:00 pm vs Jax",
      "injury_status": null,
      "injury_status_title": null,
      "name": "Joe Burrow",
      "news_url": "https://sports.yahoo.com/nfl/players/32671/news",
      "nfl_team_abbr": "Cin",
      "opponent": "Jax",
      "owner_team_id": "7",
      "player_id": "32671",
      "positions": "QB",
      "profile_url": "https://sports.yahoo.com/nfl/players/32671",
      "projected": {
        "next_4_weeks": 26,
        "season": 12,
        "this_week": 4
      },
      "roster_status": "Placeholder"
    },
    {
      "actual": {
        "last_4_weeks": 27,
        "last_week": 30,
        "season": 27
      },
      "game_status": "Sun 1:00 pm @ TB",
      "injury_status": null,
      "injury_status_title": null,
      "name": "Jordan Love",
      "news_url": "https://sports.yahoo.com/nfl/players/32696/news",
      "nfl_team_abbr": "GB",
      "opponent": "TB",
      "owner_team_id": null,
      "player_id": "32696",
      "positions": "QB",
      "profile_url": "https://sports.yahoo.com/nfl/players/32696",
      "projected": {
        "next_4_weeks": 5,
        "season": 15,
        "this_week": 19
      },
      "roster_status": "FA"
    },
    {
      "actual": {
        "last_4_weeks": 30,
        "last_week": 6,
        "season": 30
      },
      "game_status": "Sun 1:00 pm @ Chi",
      "injury_status": null,
      "injury_status_title": null,
      "name": "Geno Smith",
      "news_url": "https://sports.yahoo.com/nfl/players/26662/news",
      "nfl_team_abbr": "NYJ",
      "opponent": "Chi",
      "owner_team_id": null,
      "player_id": "26662",
      "positions": "QB",
      "profile_url": "https://sports.yahoo.com/nfl/players/26662",
      "projected": {
        "next_4_weeks": 28,
        "season": 42,
        "this_week": 46
      },
      "roster_status": "FA"
    },
    {
      "actual": {
        "last_4_weeks": 32,
        "last_week": 7,
        "season": 32
      },
      "game_status": "Sun 1:00 pm @ NYG",
      "injury_status": null,
      "injury_status_title": null,
      "name": "Jacoby Brissett",
      "news_url": "https://sports.yahoo.com/nfl/players/29325/news",
      "nfl_team_abbr": "Ari",
      "opponent": "NYG",
      "owner_team_id": null,
      "player_id": "29325",
      "positions": "QB",
      "profile_url": "https://sports.yahoo.com/nfl/players/29325",
      "projected": {
        "next_4_weeks": 15,
        "season": 29,
        "this_week": 26
      },
      "roster_status": "FA"
    },
    {
      "actual": {
        "last_4_weeks": 39,
        "last_week": 8,
        "season": 39
      },
      "game_status": "Sun 4:25 pm @ SF",
      "injury_status": null,
      "injury_status_title": null,
      "name": "Bo Nix",
      "news_url": "https://sports.yahoo.com/nfl/players/40875/news",
      "nfl_team_abbr": "Den",
      "opponent": "SF",
      "owner_team_id": null,
      "player_id": "40875",
      "positions": "QB",
      "profile_url": "https://sports.yahoo.com/nfl/players/40875",
      "projected": {
        "next_4_weeks": 10,
        "season": 24,
        "this_week": 18
      },
      "roster_status": "FA"
    },
    {
      "actual": {
        "last_4_weeks": 41,
        "last_week": 1144,
        "season": 41
      },
      "game_status": "Sun 1:00 pm vs NYJ",
      "injury_status": "O",
      "injury_status_title": "Out",
      "name": "Caleb Williams",
      "news_url": "https://sports.yahoo.com/nfl/players/40900/news",
      "nfl_team_abbr": "Chi",
      "opponent": "NYJ",
      "owner_team_id": "2",
      "player_id": "40900",
      "positions": "QB",
      "profile_url": "https://sports.yahoo.com/nfl/players/40900",
      "projected": {
        "next_4_weeks": 41,
        "season": 23,
        "this_week": 1157
      },
      "roster_status": "Decades of Failure"
    },
    {
      "actual": {
        "last_4_weeks": 44,
        "last_week": 94,
        "season": 44
      },
      "game_status": "Sun 1:00 pm vs Dal",
      "injury_status": null,
      "injury_status_title": null,
      "name": "C.J. Stroud",
      "news_url": "https://sports.yahoo.com/nfl/players/40030/news",
      "nfl_team_abbr": "Hou",
      "opponent": "Dal",
      "owner_team_id": null,
      "player_id": "40030",
      "positions": "QB",
      "profile_url": "https://sports.yahoo.com/nfl/players/40030",
      "projected": {
        "next_4_weeks": 11,
        "season": 25,
        "this_week": 9
      },
      "roster_status": "FA"
    },
    {
      "actual": {
        "last_4_weeks": 46,
        "last_week": 115,
        "season": 46
      },
      "game_status": "Sun 1:00 pm @ Bal",
      "injury_status": null,
      "injury_status_title": null,
      "name": "Cam Ward",
      "news_url": "https://sports.yahoo.com/nfl/players/41786/news",
      "nfl_team_abbr": "Ten",
      "opponent": "Bal",
      "owner_team_id": null,
      "player_id": "41786",
      "positions": "QB",
      "profile_url": "https://sports.yahoo.com/nfl/players/41786",
      "projected": {
        "next_4_weeks": 32,
        "season": 36,
        "this_week": 57
      },
      "roster_status": "FA"
    },
    {
      "actual": {
        "last_4_weeks": 53,
        "last_week": 103,
        "season": 53
      },
      "game_status": "Sun 4:05 pm @ Min",
      "injury_status": null,
      "injury_status_title": null,
      "name": "Malik Willis",
      "news_url": "https://sports.yahoo.com/nfl/players/34042/news",
      "nfl_team_abbr": "Mia",
      "opponent": "Min",
      "owner_team_id": null,
      "player_id": "34042",
      "positions": "QB",
      "profile_url": "https://sports.yahoo.com/nfl/players/34042",
      "projected": {
        "next_4_weeks": 44,
        "season": 21,
        "this_week": 44
      },
      "roster_status": "FA"
    },
    {
      "actual": {
        "last_4_weeks": 64,
        "last_week": 70,
        "season": 64
      },
      "game_status": "Sun 4:25 pm @ Sea",
      "injury_status": null,
      "injury_status_title": null,
      "name": "Justin Herbert",
      "news_url": "https://sports.yahoo.com/nfl/players/32676/news",
      "nfl_team_abbr": "LAC",
      "opponent": "Sea",
      "owner_team_id": "8",
      "player_id": "32676",
      "positions": "QB",
      "profile_url": "https://sports.yahoo.com/nfl/players/32676",
      "projected": {
        "next_4_weeks": 57,
        "season": 30,
        "this_week": 35
      },
      "roster_status": "Jenny"
    },
    {
      "actual": {
        "last_4_weeks": 70,
        "last_week": 82,
        "season": 70
      },
      "game_status": "Sun 1:00 pm vs GB",
      "injury_status": "O",
      "injury_status_title": "Out",
      "name": "Baker Mayfield",
      "news_url": "https://sports.yahoo.com/nfl/players/30971/news",
      "nfl_team_abbr": "TB",
      "opponent": "GB",
      "owner_team_id": null,
      "player_id": "30971",
      "positions": "QB",
      "profile_url": "https://sports.yahoo.com/nfl/players/30971",
      "projected": {
        "next_4_weeks": 268,
        "season": 58,
        "this_week": 592
      },
      "roster_status": "FA"
    }
  ],
  "position": "QB",
  "rank_windows": {
    "actual": [
      "Last Week",
      "Last 4 Wks",
      "Season"
    ],
    "projected": [
      "This Week",
      "Next 4 Wks",
      "Season"
    ]
  },
  "scoring_context": "Fantasy points, availability and ownership are specific to this league's scoring and roster settings; the scoring rules themselves are not part of this result.",
  "scoring_type": "head",
  "sdir": "1",
  "sort": "AR_S",
  "source_url": "https://football.fantasysports.yahoo.com/f1/2820/players?status=ALL&pos=QB&eteam=ALL&fteam=NONE&cut_type=9&stat1=K_K&myteam=0&sort=AR_S&sdir=1&count=0",
  "status": {
    "code": "ALL",
    "label": "All Players"
  }
}
```

### Public team roster

- Capability: `fantasy-football-players/public_team_roster`
- Description: A public league team's roster for one week from Yahoo's read-only Fantasy API: lineup slot per player, player identity, actual fantasy points under the league's scoring and the raw stat lines.
- Instructions: Inspect a specific public team (league_id + team_id, e.g. from a /f1/{league}/{team} URL). Private leagues are refused with upstream_blocked (login required). Projected points are not on this API surface.
- Cost: 5 credits per call
- Capability file: [Public team roster](https://firecrawl.dev/alexandria/agents/providers/football-fantasysports-yahoo-com/fantasy-football-players/public_team_roster)

Accepted options:
- `include_stats` (boolean): Also return each player's raw stat lines (stat_id/value pairs) for the window; the fantasy points total is always included. Example: `false`
- `league_id` (string): Public league id, the number after /f1/ in a league URL (e.g. 2820). Pattern: ^[0-9]{1,9}$. Example: `<league_id>`
- `team_id` (string): Team id inside the league (1..num_teams). Pattern: ^[0-9]{1,3}$. Example: `<team_id>`
- `team_url` (string): A team page URL /f1/{league_id}/{team_id}; alternative to league_id + team_id. Pattern: ^https?://(www\.)?football\.fantasysports\.yahoo\.com/f1/[0-9]{1,9}/[0-9]{1,3}(/.*)?$. Example: `<team_url>`
- `week` (number): NFL week; omitted: the league's current week. Example: `10`

Response schema example:
```json
{
  "count": 15,
  "game_key": "470",
  "observed_at_ms": 1791024626480,
  "roster": {
    "coverage_type": "week",
    "is_prescoring": false,
    "players": [
      {
        "bye_week": 11,
        "display_position": "QB",
        "eligible_positions": [
          "QB"
        ],
        "fantasy_points": 5.1,
        "first_name": "Matthew",
        "has_player_notes": true,
        "headshot_url": "https://s.yimg.com/iu/api/res/1.2/WB0VYA2W5C4vPf8BtjcFdg--~C/YXBwaWQ9eXNwb3J0cztjaD0yMzM2O2NyPTE7Y3c9MTc5MDtkeD04NTc7ZHk9MDtmaT11bGNyb3A7aD02MDtxPTEwMDt3PTQ2/https://s.yimg.com/xe/i/us/sp/v/nfl_cutout/players_l/08192026/9265.2.png",
        "injury_note": null,
        "is_flex": false,
        "is_undroppable": false,
        "last_name": "Stafford",
        "name": "Matthew Stafford",
        "news_url": "https://sports.yahoo.com/nfl/players/9265/news",
        "nfl_team_abbr": "LAR",
        "nfl_team_key": "nfl.t.14",
        "nfl_team_name": "Los Angeles Rams",
        "player_id": "9265",
        "player_key": "470.p.9265",
        "points_coverage": {
          "coverage_type": "week",
          "season": null,
          "week": 1
        },
        "position_type": "O",
        "primary_position": "QB",
        "profile_url": "https://sports.yahoo.com/nfl/players/9265",
        "selected_position": "QB",
        "stats": [],
        "status": null,
        "status_full": null,
        "uniform_number": "9"
      },
      {
        "bye_week": 7,
        "display_position": "RB",
        "eligible_positions": [
          "RB",
          "W/R/T"
        ],
        "fantasy_points": 8.3,
        "first_name": "Omarion",
        "has_player_notes": true,
        "headshot_url": "https://s.yimg.com/iu/api/res/1.2/E3OBtN4RVVXkZvnZCY7AiA--~C/YXBwaWQ9eXNwb3J0cztjaD0yMzM2O2NyPTE7Y3c9MTc5MDtkeD04NTc7ZHk9MDtmaT11bGNyb3A7aD02MDtxPTEwMDt3PTQ2/https://s.yimg.com/xe/i/us/sp/v/nfl_cutout/players_l/09092026/41807.1.png",
        "injury_note": null,
        "is_flex": false,
        "is_undroppable": true,
        "last_name": "Hampton",
        "name": "Omarion Hampton",
        "news_url": "https://sports.yahoo.com/nfl/players/41807/news",
        "nfl_team_abbr": "LAC",
        "nfl_team_key": "nfl.t.24",
        "nfl_team_name": "Los Angeles Chargers",
        "player_id": "41807",
        "player_key": "470.p.41807",
        "points_coverage": {
          "coverage_type": "week",
          "season": null,
          "week": 1
        },
        "position_type": "O",
        "primary_position": "RB",
        "profile_url": "https://sports.yahoo.com/nfl/players/41807",
        "selected_position": "RB",
        "stats": [],
        "status": null,
        "status_full": null,
        "uniform_number": "8"
      },
      {
        "bye_week": 8,
        "display_position": "RB",
        "eligible_positions": [
          "RB",
          "W/R/T"
        ],
        "fantasy_points": 27.4,
        "first_name": "David",
        "has_player_notes": true,
        "headshot_url": "https://s.yimg.com/iu/api/res/1.2/hN80sQ635x90TiKS2KvZZA--~C/YXBwaWQ9eXNwb3J0cztjaD0yMzM2O2NyPTE7Y3c9MTc5MDtkeD04NTc7ZHk9MDtmaT11bGNyb3A7aD02MDtxPTEwMDt3PTQ2/https://s.yimg.com/xe/i/us/sp/v/nfl_cutout/players_l/08142026/31905.2.png",
        "injury_note": null,
        "is_flex": false,
        "is_undroppable": false,
        "last_name": "Montgomery",
        "name": "David Montgomery",
        "news_url": "https://sports.yahoo.com/nfl/players/31905/news",
        "nfl_team_abbr": "Hou",
        "nfl_team_key": "nfl.t.34",
        "nfl_team_name": "Houston Texans",
        "player_id": "31905",
        "player_key": "470.p.31905",
        "points_coverage": {
          "coverage_type": "week",
          "season": null,
          "week": 1
        },
        "position_type": "O",
        "primary_position": "RB",
        "profile_url": "https://sports.yahoo.com/nfl/players/31905",
        "selected_position": "RB",
        "stats": [],
        "status": null,
        "status_full": null,
        "uniform_number": "32"
      },
      {
        "bye_week": 6,
        "display_position": "WR",
        "eligible_positions": [
          "WR",
          "W/R/T"
        ],
        "fantasy_points": 2.2,
        "first_name": "Ja'Marr",
        "has_player_notes": true,
        "headshot_url": "https://s.yimg.com/iu/api/res/1.2/8DFQtQd4gJsvWGpzq0rbag--~C/YXBwaWQ9eXNwb3J0cztjaD0yMzM2O2NyPTE7Y3c9MTc5MDtkeD04NTc7ZHk9MDtmaT11bGNyb3A7aD02MDtxPTEwMDt3PTQ2/https://s.yimg.com/xe/i/us/sp/v/nfl_cutout/players_l/08122026/33393.1.png",
        "injury_note": null,
        "is_flex": false,
        "is_undroppable": true,
        "last_name": "Chase",
        "name": "Ja'Marr Chase",
        "news_url": "https://sports.yahoo.com/nfl/players/33393/news",
        "nfl_team_abbr": "Cin",
        "nfl_team_key": "nfl.t.4",
        "nfl_team_name": "Cincinnati Bengals",
        "player_id": "33393",
        "player_key": "470.p.33393",
        "points_coverage": {
          "coverage_type": "week",
          "season": null,
          "week": 1
        },
        "position_type": "O",
        "primary_position": "WR",
        "profile_url": "https://sports.yahoo.com/nfl/players/33393",
        "selected_position": "WR",
        "stats": [],
        "status": null,
        "status_full": null,
        "uniform_number": "1"
      },
      {
        "bye_week": 8,
        "display_position": "WR",
        "eligible_positions": [
          "WR",
          "W/R/T"
        ],
        "fantasy_points": 23.2,
        "first_name": "Chris",
        "has_player_notes": true,
        "headshot_url": "https://s.yimg.com/iu/api/res/1.2/LU_EjbVkQPNC7pNEvkf6PA--~C/YXBwaWQ9eXNwb3J0cztjaD0yMzM2O2NyPTE7Y3c9MTc5MDtkeD04NTc7ZHk9MDtmaT11bGNyb3A7aD02MDtxPTEwMDt3PTQ2/https://s.yimg.com/xe/i/us/sp/v/nfl_cutout/players_l/08202026/33966.1.png",
        "injury_note": null,
        "is_flex": false,
        "is_undroppable": false,
        "last_name": "Olave",
        "name": "Chris Olave",
        "news_url": "https://sports.yahoo.com/nfl/players/33966/news",
        "nfl_team_abbr": "NO",
        "nfl_team_key": "nfl.t.18",
        "nfl_team_name": "New Orleans Saints",
        "player_id": "33966",
        "player_key": "470.p.33966",
        "points_coverage": {
          "coverage_type": "week",
          "season": null,
          "week": 1
        },
        "position_type": "O",
        "primary_position": "WR",
        "profile_url": "https://sports.yahoo.com/nfl/players/33966",
        "selected_position": "WR",
        "stats": [],
        "status": null,
        "status_full": null,
        "uniform_number": "12"
      },
      {
        "bye_week": 5,
        "display_position": "TE",
        "eligible_positions": [
          "TE",
          "W/R/T"
        ],
        "fantasy_points": 8.6,
        "first_name": "Travis",
        "has_player_notes": true,
        "headshot_url": "https://s.yimg.com/iu/api/res/1.2/ynhkrbJAJKmF5XgXM2ydDg--~C/YXBwaWQ9eXNwb3J0cztjaD0yMzM2O2NyPTE7Y3c9MTc5MDtkeD04NTc7ZHk9MDtmaT11bGNyb3A7aD02MDtxPTEwMDt3PTQ2/https://s.yimg.com/xe/i/us/sp/v/nfl_cutout/players_l/08192026/26686.png",
        "injury_note": null,
        "is_flex": false,
        "is_undroppable": false,
        "last_name": "Kelce",
        "name": "Travis Kelce",
        "news_url": "https://sports.yahoo.com/nfl/players/26686/news",
        "nfl_team_abbr": "KC",
        "nfl_team_key": "nfl.t.12",
        "nfl_team_name": "Kansas City Chiefs",
        "player_id": "26686",
        "player_key": "470.p.26686",
        "points_coverage": {
          "coverage_type": "week",
          "season": null,
          "week": 1
        },
        "position_type": "O",
        "primary_position": "TE",
        "profile_url": "https://sports.yahoo.com/nfl/players/26686",
        "selected_position": "TE",
        "stats": [],
        "status": null,
        "status_full": null,
        "uniform_number": "87"
      },
      {
        "bye_week": 11,
        "display_position": "WR",
        "eligible_positions": [
          "WR",
          "W/R/T"
        ],
        "fantasy_points": 4.1,
        "first_name": "Davante",
        "has_player_notes": true,
        "headshot_url": "https://s.yimg.com/iu/api/res/1.2/Lq0buOz6WeFBtJha4zFsjQ--~C/YXBwaWQ9eXNwb3J0cztjaD0yMzM2O2NyPTE7Y3c9MTc5MDtkeD04NTc7ZHk9MDtmaT11bGNyb3A7aD02MDtxPTEwMDt3PTQ2/https://s.yimg.com/xe/i/us/sp/v/nfl_cutout/players_l/08252025/27581.png",
        "injury_note": null,
        "is_flex": true,
        "is_undroppable": false,
        "last_name": "Adams",
        "name": "Davante Adams",
        "news_url": "https://sports.yahoo.com/nfl/players/27581/news",
        "nfl_team_abbr": "LAR",
        "nfl_team_key": "nfl.t.14",
        "nfl_team_name": "Los Angeles Rams",
        "player_id": "27581",
        "player_key": "470.p.27581",
        "points_coverage": {
          "coverage_type": "week",
          "season": null,
          "week": 1
        },
        "position_type": "O",
        "primary_position": "WR",
        "profile_url": "https://sports.yahoo.com/nfl/players/27581",
        "selected_position": "W/R/T",
        "stats": [],
        "status": null,
        "status_full": null,
        "uniform_number": "17"
      },
      {
        "bye_week": 7,
        "display_position": "WR",
        "eligible_positions": [
          "WR",
          "W/R/T"
        ],
        "fantasy_points": 18.5,
        "first_name": "DJ",
        "has_player_notes": true,
        "headshot_url": "https://s.yimg.com/iu/api/res/1.2/cRf0PZjrcxCx9Oqer9Uo3Q--~C/YXBwaWQ9eXNwb3J0cztjaD0yMzM2O2NyPTE7Y3c9MTc5MDtkeD04NTc7ZHk9MDtmaT11bGNyb3A7aD02MDtxPTEwMDt3PTQ2/https://s.yimg.com/xe/i/us/sp/v/nfl_cutout/players_l/08122026/30994.1.png",
        "injury_note": null,
        "is_flex": false,
        "is_undroppable": false,
        "last_name": "Moore",
        "name": "DJ Moore",
        "news_url": "https://sports.yahoo.com/nfl/players/30994/news",
        "nfl_team_abbr": "Buf",
        "nfl_team_key": "nfl.t.2",
        "nfl_team_name": "Buffalo Bills",
        "player_id": "30994",
        "player_key": "470.p.30994",
        "points_coverage": {
          "coverage_type": "week",
          "season": null,
          "week": 1
        },
        "position_type": "O",
        "primary_position": "WR",
        "profile_url": "https://sports.yahoo.com/nfl/players/30994",
        "selected_position": "BN",
        "stats": [],
        "status": null,
        "status_full": null,
        "uniform_number": "2"
      },
      {
        "bye_week": 10,
        "display_position": "WR",
        "eligible_positions": [
          "WR",
          "W/R/T"
        ],
        "fantasy_points": 6.2,
        "first_name": "Rome",
        "has_player_notes": true,
        "headshot_url": "https://s.yimg.com/iu/api/res/1.2/7mOuM7u9usQ7ge8D.SKj_w--~C/YXBwaWQ9eXNwb3J0cztjaD0yMzM2O2NyPTE7Y3c9MTc5MDtkeD04NTc7ZHk9MDtmaT11bGNyb3A7aD02MDtxPTEwMDt3PTQ2/https://s.yimg.com/xe/i/us/sp/v/nfl_cutout/players_l/08122026/40901.1.png",
        "injury_note": null,
        "is_flex": false,
        "is_undroppable": false,
        "last_name": "Odunze",
        "name": "Rome Odunze",
        "news_url": "https://sports.yahoo.com/nfl/players/40901/news",
        "nfl_team_abbr": "Chi",
        "nfl_team_key": "nfl.t.3",
        "nfl_team_name": "Chicago Bears",
        "player_id": "40901",
        "player_key": "470.p.40901",
        "points_coverage": {
          "coverage_type": "week",
          "season": null,
          "week": 1
        },
        "position_type": "O",
        "primary_position": "WR",
        "profile_url": "https://sports.yahoo.com/nfl/players/40901",
        "selected_position": "BN",
        "stats": [],
        "status": null,
        "status_full": null,
        "uniform_number": "15"
      },
      {
        "bye_week": 9,
        "display_position": "RB",
        "eligible_positions": [
          "RB",
          "W/R/T",
          "IR"
        ],
        "fantasy_points": 3.1,
        "first_name": "Rico",
        "has_player_notes": true,
        "headshot_url": "https://s.yimg.com/iu/api/res/1.2/ywTo2aUjogCZOwXb2d4J.Q--~C/YXBwaWQ9eXNwb3J0cztjaD0yMzM2O2NyPTE7Y3c9MTc5MDtkeD04NTc7ZHk9MDtmaT11bGNyb3A7aD02MDtxPTEwMDt3PTQ2/https://s.yimg.com/xe/i/us/sp/v/nfl_cutout/players_l/08242026/33100.1.png",
        "injury_note": "Toe",
        "is_flex": false,
        "is_undroppable": false,
        "last_name": "Dowdle",
        "name": "Rico Dowdle",
        "news_url": "https://sports.yahoo.com/nfl/players/33100/news",
        "nfl_team_abbr": "Pit",
        "nfl_team_key": "nfl.t.23",
        "nfl_team_name": "Pittsburgh Steelers",
        "player_id": "33100",
        "player_key": "470.p.33100",
        "points_coverage": {
          "coverage_type": "week",
          "season": null,
          "week": 1
        },
        "position_type": "O",
        "primary_position": "RB",
        "profile_url": "https://sports.yahoo.com/nfl/players/33100",
        "selected_position": "BN",
        "stats": [],
        "status": "O",
        "status_full": "Out",
        "uniform_number": "13"
      },
      {
        "bye_week": 7,
        "display_position": "RB",
        "eligible_positions": [
          "RB",
          "W/R/T"
        ],
        "fantasy_points": 12.1,
        "first_name": "Jacory",
        "has_player_notes": true,
        "headshot_url": "https://s.yimg.com/iu/api/res/1.2/OyiNPym5zFBeEVu4nQO05w--~C/YXBwaWQ9eXNwb3J0cztjaD0yMzM2O2NyPTE7Y3c9MTc5MDtkeD04NTc7ZHk9MDtmaT11bGNyb3A7aD02MDtxPTEwMDt3PTQ2/https://s.yimg.com/xe/i/us/sp/v/nfl_cutout/players_l/08252026/42010.1.png",
        "injury_note": null,
        "is_flex": false,
        "is_undroppable": false,
        "last_name": "Croskey-Merritt",
        "name": "Jacory Croskey-Merritt",
        "news_url": "https://sports.yahoo.com/nfl/players/42010/news",
        "nfl_team_abbr": "Was",
        "nfl_team_key": "nfl.t.28",
        "nfl_team_name": "Washington Commanders",
        "player_id": "42010",
        "player_key": "470.p.42010",
        "points_coverage": {
          "coverage_type": "week",
          "season": null,
          "week": 1
        },
        "position_type": "O",
        "primary_position": "RB",
        "profile_url": "https://sports.yahoo.com/nfl/players/42010",
        "selected_position": "BN",
        "stats": [],
        "status": null,
        "status_full": null,
        "uniform_number": "22"
      },
      {
        "bye_week": 10,
        "display_position": "QB",
        "eligible_positions": [
          "QB"
        ],
        "fantasy_points": 6.44,
        "first_name": "Bo",
        "has_player_notes": true,
        "headshot_url": "https://s.yimg.com/iu/api/res/1.2/3YuKds1ZJjg51OHa8OArCg--~C/YXBwaWQ9eXNwb3J0cztjaD0yMzM2O2NyPTE7Y3c9MTc5MDtkeD04NTc7ZHk9MDtmaT11bGNyb3A7aD02MDtxPTEwMDt3PTQ2/https://s.yimg.com/xe/i/us/sp/v/nfl_cutout/players_l/08132026/40875.1.png",
        "injury_note": null,
        "is_flex": false,
        "is_undroppable": false,
        "last_name": "Nix",
        "name": "Bo Nix",
        "news_url": "https://sports.yahoo.com/nfl/players/40875/news",
        "nfl_team_abbr": "Den",
        "nfl_team_key": "nfl.t.7",
        "nfl_team_name": "Denver Broncos",
        "player_id": "40875",
        "player_key": "470.p.40875",
        "points_coverage": {
          "coverage_type": "week",
          "season": null,
          "week": 1
        },
        "position_type": "O",
        "primary_position": "QB",
        "profile_url": "https://sports.yahoo.com/nfl/players/40875",
        "selected_position": "BN",
        "stats": [],
        "status": null,
        "status_full": null,
        "uniform_number": "10"
      },
      {
        "bye_week": 11,
        "display_position": "RB",
        "eligible_positions": [
          "RB",
          "W/R/T"
        ],
        "fantasy_points": 0,
        "first_name": "Josh",
        "has_player_notes": true,
        "headshot_url": "https://s.yimg.com/iu/api/res/1.2/iCoq42m.6mMZL544UDDUMQ--~C/YXBwaWQ9eXNwb3J0cztjaD0yMzM2O2NyPTE7Y3c9MTc5MDtkeD04NTc7ZHk9MDtmaT11bGNyb3A7aD02MDtxPTEwMDt3PTQ2/https://s.yimg.com/xe/i/us/sp/v/nfl_cutout/players_l/08142026/31856.3.png",
        "injury_note": "Personal",
        "is_flex": false,
        "is_undroppable": false,
        "last_name": "Jacobs",
        "name": "Josh Jacobs",
        "news_url": "https://sports.yahoo.com/nfl/players/31856/news",
        "nfl_team_abbr": "GB",
        "nfl_team_key": "nfl.t.9",
        "nfl_team_name": "Green Bay Packers",
        "player_id": "31856",
        "player_key": "470.p.31856",
        "points_coverage": {
          "coverage_type": "week",
          "season": null,
          "week": 1
        },
        "position_type": "O",
        "primary_position": "RB",
        "profile_url": "https://sports.yahoo.com/nfl/players/31856",
        "selected_position": "BN",
        "stats": [],
        "status": "CEL",
        "status_full": "Reserve: Commissioner Exempt List",
        "uniform_number": "8"
      },
      {
        "bye_week": 11,
        "display_position": "K",
        "eligible_positions": [
          "K"
        ],
        "fantasy_points": 7,
        "first_name": "Jason",
        "has_player_notes": true,
        "headshot_url": "https://s.yimg.com/iu/api/res/1.2/INl0_KrycGL0EGMm.WaPKQ--~C/YXBwaWQ9eXNwb3J0cztjaD0yMzM2O2NyPTE7Y3c9MTc5MDtkeD04NTc7ZHk9MDtmaT11bGNyb3A7aD02MDtxPTEwMDt3PTQ2/https://s.yimg.com/xe/i/us/sp/v/nfl_cutout/players_l/08072026/28378.1.png",
        "injury_note": null,
        "is_flex": false,
        "is_undroppable": false,
        "last_name": "Myers",
        "name": "Jason Myers",
        "news_url": "https://sports.yahoo.com/nfl/players/28378/news",
        "nfl_team_abbr": "Sea",
        "nfl_team_key": "nfl.t.26",
        "nfl_team_name": "Seattle Seahawks",
        "player_id": "28378",
        "player_key": "470.p.28378",
        "points_coverage": {
          "coverage_type": "week",
          "season": null,
          "week": 1
        },
        "position_type": "K",
        "primary_position": "K",
        "profile_url": "https://sports.yahoo.com/nfl/players/28378",
        "selected_position": "K",
        "stats": [],
        "status": null,
        "status_full": null,
        "uniform_number": "5"
      },
      {
        "bye_week": 6,
        "display_position": "DEF",
        "eligible_positions": [
          "DEF"
        ],
        "fantasy_points": 8,
        "first_name": "Vikings",
        "has_player_notes": null,
        "headshot_url": "https://s.yimg.com/xe/ipt/50x50w.6.gif",
        "injury_note": null,
        "is_flex": false,
        "is_undroppable": false,
        "last_name": "",
        "name": "Vikings",
        "news_url": "https://sports.yahoo.com/nfl/players/100016/news",
        "nfl_team_abbr": "Min",
        "nfl_team_key": "nfl.t.16",
        "nfl_team_name": "Minnesota Vikings",
        "player_id": "100016",
        "player_key": "470.p.100016",
        "points_coverage": {
          "coverage_type": "week",
          "season": null,
          "week": 1
        },
        "position_type": "DT",
        "primary_position": "DEF",
        "profile_url": "https://sports.yahoo.com/nfl/teams/minnesota/",
        "selected_position": "DEF",
        "stats": [],
        "status": null,
        "status_full": null,
        "uniform_number": null
      }
    ],
    "week": 1
  },
  "scoring_context": "Fantasy points, availability and ownership are specific to this league's scoring and roster settings; the scoring rules themselves are not part of this result.",
  "season": "2026",
  "source_url": "https://pub-api-ro.fantasysports.yahoo.com/fantasy/v2/team/470.l.2820.t.1/roster;week=1/players/stats?format=json",
  "team": {
    "draft_grade": "D-",
    "draft_position": 3,
    "league_id": "2820",
    "league_scoring_type": "head",
    "logo_url": "https://s.yimg.com/ep/cx/blendr/v2/image-spaceship-png_1721951810651.png",
    "name": "team 1 (bad)",
    "number_of_moves": 2,
    "number_of_trades": 0,
    "team_id": "1",
    "team_key": "470.l.2820.t.1",
    "url": "https://football.fantasysports.yahoo.com/f1/2820/1",
    "waiver_priority": 5
  }
}
```

### Search players

- Capability: `fantasy-football-players/search_players`
- Description: Search NFL players by name through Yahoo's read-only Fantasy API inside a public league (the game-level search endpoint ignores its search filter, so a public league is required).
- Instructions: Resolve a player name to Yahoo player ids/keys before list_players, public_team_roster or player_news. Give league_id or league_url of any public league; the result lists the league's key but player ids are league-independent.
- Cost: 5 credits per call
- Capability file: [Search players](https://firecrawl.dev/alexandria/agents/providers/football-fantasysports-yahoo-com/fantasy-football-players/search_players)

Accepted options:
- `count` (number): Maximum results returned (the API answers with every match; extra rows are dropped). Example: `25`
- `league_id` (string): Public league id, the number after /f1/ in a league URL (e.g. 2820). Pattern: ^[0-9]{1,9}$. Example: `<league_id>`
- `league_url` (string): A league page URL; the league id is taken from its /f1/{league_id} segment. Alternative to league_id. Pattern: ^https?://(www\.)?football\.fantasysports\.yahoo\.com/f1/[0-9]{1,9}(/.*)?$. Example: `<league_url>`
- `query` (string, required): Player name or name prefix. Example: `<query>`

Response schema example:
```json
{
  "count": 1,
  "game_key": "470",
  "league": {
    "current_week": 4,
    "draft_status": "postdraft",
    "league_id": "2820",
    "league_key": "470.l.2820",
    "league_type": "public",
    "name": "Yahoo Prize H2H-Pts 2820",
    "num_teams": 10,
    "scoring_label": "H2H",
    "scoring_type": "head",
    "season": "2026",
    "url": "https://football.fantasysports.yahoo.com/f1/2820"
  },
  "observed_at_ms": 1791024583714,
  "players": [
    {
      "bye_week": 7,
      "display_position": "QB",
      "eligible_positions": [
        "QB"
      ],
      "first_name": "Josh",
      "has_player_notes": true,
      "headshot_url": "https://s.yimg.com/iu/api/res/1.2/z4qe7sEEXVyMrm0j1CeEww--~C/YXBwaWQ9eXNwb3J0cztjaD0yMzM2O2NyPTE7Y3c9MTc5MDtkeD04NTc7ZHk9MDtmaT11bGNyb3A7aD02MDtxPTEwMDt3PTQ2/https://s.yimg.com/xe/i/us/sp/v/nfl_cutout/players_l/08122026/30977.1.png",
      "injury_note": null,
      "is_undroppable": true,
      "last_name": "Allen",
      "name": "Josh Allen",
      "news_url": "https://sports.yahoo.com/nfl/players/30977/news",
      "nfl_team_abbr": "Buf",
      "nfl_team_key": "nfl.t.2",
      "nfl_team_name": "Buffalo Bills",
      "player_id": "30977",
      "player_key": "470.p.30977",
      "position_type": "O",
      "primary_position": "QB",
      "profile_url": "https://sports.yahoo.com/nfl/players/30977",
      "status": null,
      "status_full": null,
      "uniform_number": "17"
    }
  ],
  "query": "Josh Allen",
  "season": "2026",
  "source_url": "https://pub-api-ro.fantasysports.yahoo.com/fantasy/v2/league/470.l.2820/players;search=Josh%20Allen?format=json"
}
```
