Yahoo Sports API endpoint
Returns one team schedule. 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-scheduleReturns a team's full schedule — regular season plus any already-played/scheduled playoff games — with the same per-game fields as the scoreboard, 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:
games preserves Yahoo's own chronological ordering.slug field is the identifier the game/boxscore endpoint expects.league/team values return an invalid-parameter error before upstream IO.| Field | Filled in, of 20 checked | Values in the sample |
|---|---|---|
| id | 20 | |
| slug | 20 | |
| status | 20 | PREGAME (12), FINAL (8) |
| status_display | 20 | “Final” and 13 other values |
| start_time | 20 | 2026-08-13 to 2027-01-10 |
| week | 20 | 1 to 18, median 7 |
| venue | 20 | |
| away_team | 20 | |
| home_team | 20 | |
| away_score | 8 | 7 to 38, median 20 |
| home_score | 8 | 13 to 42, median 17 |
| broadcasts | 19 | median 1 entry |
| url | 20 | sports.yahoo.com |
| 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-schedule?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": 25,
"source_url": "https://sports.yahoo.com/nfl/teams/green-bay/schedule/",
"fetched_at": "2026-08-13T20:05:00Z",
"games": [
{
"id": "nfl.g.20260110003",
"slug": "green-bay-packers-chicago-bears-20260110003",
"display_name": "Green Bay @ Chicago - Wild Card Playoff",
"status": "FINAL",
"status_display": "Final",
"start_time": "2026-01-10T13:00:00-08:00",
"away_team": {
"id": "nfl.t.9",
"name": "Green Bay Packers",
"abbreviation": "GB"
},
"home_team": {
"id": "nfl.t.3",
"name": "Chicago Bears",
"abbreviation": "CHI"
},
"away_score": 27,
"home_score": 31
}
]
}
}Request schema
No body schema
Response schema
#/definitions/yahoosports.teamScheduleResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | yahoosports.TeamScheduleResponse | No | ||||
| data.count | integer | No | 25 | |||
| data.fetched_at | string | No | ||||
| data.games | array | No | Game record, 46 fields: away_score, away_team, broadcasts, competition, display_name, home_score, home_team, id, slug, start_time, status, status_display and 3 more. Described under Yahoo Sports scoreboard API. | |||
| data.league | string | No | nfl | |||
| 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-schedule?league=nfl&team=green-bay" \
-H "x-api-key: $CRAWLORA_API_KEY"