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

# Yahoo Sports team schedule

`GET /yahoo-sports/team-schedule`

## Request

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

Returns a team's full schedule (regular season plus any already-played/scheduled playoff games), with the same per-game fields as the scoreboard, from sports.yahoo.com's own server-rendered team schedule 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

- YahoosportsTeamScheduleResponseDoc
  - `code` integer
  - `data` YahoosportsTeamScheduleResponse
    - `count` integer
    - `fetched_at` string
    - `games` YahoosportsGame[]
      - `away_score` integer
      - `away_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
      - `broadcasts` YahoosportsBroadcast[]
        - `abbr` string
        - `name` string
      - `display_name` string
      - `home_score` integer
      - `home_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
      - `id` string
      - `slug` string
      - `start_time` string
      - `status` string
      - `status_display` string
      - `url` string
      - `venue` YahoosportsVenue
        - `city` string
        - `country` string
        - `name` string
        - `state` string
      - `week` integer
    - `league` string
    - `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)