Yahoo Sports API endpoint
Returns one team roster. Use league=soccer for Yahoo's flat soccer team namespace, or a league key from yahoo-sports-leagues. Team slugs come from team or scoreboard records.
/yahoo-sports/team-rosterReturns a team's full roster — position, jersey number, status, injury, physicals, college, and experience — from Yahoo Sports.
Query parameters:
league: required enum. Allowed values: nfl, nba, wnba, mlb, nhl, college-football, college-basketball, college-womens-basketball, soccer, 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, womens-world-cup, europa-league, euro-championship.team: required. A Yahoo Sports team slug, e.g. green-bay, la-lakers, boston. Get one from the scoreboard or standings response's team.url (the last path segment).For soccer, team identity is global across competitions: league=soccer or a direct soccer league key uses Yahoo's flat /soccer/teams/{team}/ namespace. The team slug still comes from a source scoreboard, roster, or team record.
Notable response behavior:
players includes every player on the current roster page; status/injury reflect Yahoo's current designations (e.g. ACT, IR, Questionable).team is the roster page's own team header (id, name, colors, url); it is omitted if the page's team header could not be matched.league/team values return an invalid-parameter error before upstream IO.| Field | Filled in, of 102 checked | Values in the sample |
|---|---|---|
| id | 102 | |
| name | 102 | “Kyron Drones” and 101 other values |
| position | 102 | “QB” and 14 other values |
| status | 102 | ACT (52), UFA (20), PRA (17) and 4 more |
| age | 94 | 21 to 37, median 25 |
| height | 102 | |
| weight | 102 | 181 to 357, median 232 |
| college | 101 | “Virginia Tech” and 64 other values |
| url | 102 | sports.yahoo.com |
| number | 81 | 0 to 99, median 52 |
| experience_years | 77 | 1 to 16, median 4 |
| injury | 23 | Questionable (9), Injured Reserve (7), Physically Unable to perform (R… (3) and 3 more |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| league | string | Yes | League key Allowed values: nfl, nba, wnba, mlb, nhl, college-football, college-basketball, college-womens-basketball, soccer, 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, womens-world-cup, europa-league, euro-championship. | nfl | |
| team | string | Yes | Yahoo Sports team slug | green-bay | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/yahoo-sports/team-roster?league=nfl&team=green-bay" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"league": "nfl",
"team": {
"id": "nfl.t.9",
"name": "Green Bay Packers",
"short_name": "Green Bay",
"url": "https://sports.yahoo.com/nfl/teams/green-bay/"
},
"count": 53,
"source_url": "https://sports.yahoo.com/nfl/teams/green-bay/roster/",
"fetched_at": "2026-08-13T20:05:00Z",
"players": [
{
"id": "nfl.p.42019",
"name": "John Williams",
"position": "G",
"number": "73",
"status": "ACT",
"injury": "Questionable",
"age": 24,
"height": "6'4\"",
"weight": 322,
"college": "Cincinnati",
"experience_years": 2,
"url": "https://sports.yahoo.com/nfl/players/42019/"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/yahoosports.rosterResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | yahoosports.RosterResponse | No | ||||
| data.count | integer | No | 53 | |||
| data.fetched_at | string | No | ||||
| data.league | string | No | nfl | |||
| data.players | array | No | ||||
| data.players[].age | integer | No | ||||
| data.players[].college | string | No | ||||
| data.players[].experience_years | integer | No | ||||
| data.players[].height | string | No | 6'4" | |||
| data.players[].id | string | No | nfl.p.42019 | |||
| data.players[].injury | string | No | Questionable | |||
| data.players[].name | string | No | John Williams | |||
| data.players[].number | string | No | 73 | |||
| data.players[].position | string | No | G | |||
| data.players[].status | string | No | ACT | |||
| data.players[].url | string | No | ||||
| data.players[].weight | integer | No | ||||
| data.source_url | string | No | ||||
| data.team | yahoosports.TeamRef | No | TeamRef record, 10 fields: abbreviation, id, location, logo, name, nickname, primary_color, secondary_color, short_name, url. Described under Yahoo Sports game boxscore API. | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/yahoo-sports/team-roster?league=nfl&team=green-bay" \
-H "x-api-key: $CRAWLORA_API_KEY"