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

# Yahoo Sports scoreboard

`GET /yahoo-sports/scoreboard`

## Request

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

Returns games (teams, score, status, venue, and broadcast info) for a league on a date, from sports.yahoo.com's own server-rendered scoreboard 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`.

## 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
- `date` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- YahoosportsScoreboardResponseDoc
  - `code` integer
  - `data` YahoosportsScoreboardResponse
    - `count` integer
    - `date` string
    - `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
  - `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/afac9b012a27?raw)