---
title: "Yahoo Sports team roster"
method: GET
path: "/yahoo-sports/team-roster"
tags: ["Yahoo Sports"]
---

# Yahoo Sports team roster

`GET /yahoo-sports/team-roster`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/yahoo-sports/team-roster`
- Auth: API key in header `x-api-key`

Returns a team's full roster (position, jersey number, status, injury, physicals, college, and experience) from sports.yahoo.com's own server-rendered roster page. The `league` enum accepts `nfl`, `nba`, `wnba`, `mlb`, `nhl`, `college-football`, `college-basketball`, `college-womens-basketball`, `mls`, `premier-league`, `la-liga`, `serie-a`, `bundesliga`, `ligue-1`, `nwsl`, `ligamx-apertura`, `ligamx-clausura`, `copa-america`, `club-world-cup`, `world-cup`, `concacaf-champions-cup`, `concacaf-gold-cup`, `concacaf-league`, and `champions-league`. Get a team slug from the scoreboard or standings response (e.g. `green-bay`, `la-lakers`).

## Query parameters

- `league` 'nfl' | 'nba' | 'wnba' | 'mlb' | 'nhl' | 'college-football' | 'college-basketball' | 'college-womens-basketball' | 'mls' | 'premier-league' | 'la-liga' | 'serie-a' | 'bundesliga' | 'ligue-1' | 'champions-league' | 'nwsl' | 'ligamx-apertura' | 'ligamx-clausura' | 'copa-america' | 'club-world-cup' | 'world-cup' | 'concacaf-champions-cup' | 'concacaf-gold-cup' | 'concacaf-league', required
- `team` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- YahoosportsRosterResponseDoc
  - `code` integer
  - `data` YahoosportsRosterResponse
    - `count` integer
    - `fetched_at` string
    - `league` string
    - `players` YahoosportsRosterPlayer[]
      - `age` integer
      - `college` string
      - `experience_years` integer
      - `height` string
      - `id` string
      - `injury` string
      - `name` string
      - `number` string
      - `position` string
      - `status` string
      - `url` string
      - `weight` integer
    - `source_url` string
    - `team` YahoosportsTeamRef
      - `abbreviation` string
      - `id` string
      - `location` string
      - `logo` string
      - `name` string
      - `nickname` string
      - `primary_color` string
      - `secondary_color` string
      - `short_name` string
      - `url` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)