Yahoo Sports API

Hinweise zur Response

- A valid date with no games returns an empty `games` array (not an error). - `away_score`/`home_score` are `null` until the game starts. - `status` is Yahoo's raw status code (e.g. `PREGAME`, `INPROGRESS`, `FINAL`); `status_display` is the human-readable label. - Each game's `slug` is the identifier the `game`/boxscore endpoint expects. - Soccer games include their upstream `competition` ID, name, URL, and league logo where Yahoo embeds them. - The combined root response always includes the full current competition catalog. With `competition_id`, `count` and `games` reflect the selected source competition; a valid competition with no games on that date returns an empty array. - Invalid `league`/`date` values return an invalid-parameter error before upstream IO. Example root-filter request: ```text /api/v1/yahoo-sports/scoreboard?league=soccer&date=2026-11-01&competition_id=soccer.l.fbgb ``` Example direct league response: ```json { "code": 200, "msg": "OK", "data": { "league": "nfl", "date": "2026-08-13", "count": 1, "source_url": "https://sports.yahoo.com/nfl/scoreboard/?date=2026-08-13", "fetched_at": "2026-08-13T20:05:00Z", "games": [ { "id": "nfl.g.20260813023", "slug": "green-bay-packers-pittsburgh-steelers-20260813023", "display_name": "Green Bay @ Pittsburgh", "status": "PREGAME", "status_display": "7:00 PM", "start_time": "2026-08-13T16:00:00-07:00", "venue": { "name": "Acrisure Stadium", "city": "Pittsburgh", "state": "PA", "country": "USA" }, "away_team": { "id": "nfl.t.9", "name": "Green Bay Packers", "short_name": "Green Bay", "abbreviation": "GB" }, "home_team": { "id": "nfl.t.23", "name": "Pittsburgh Steelers", "short_name": "Pittsburgh", "abbreviation": "PIT" }, "broadcasts": [{ "name": "NFL Network", "abbr": "NFLN" }] } ] } } ``` Example root-filtered response for a selector-only category with no games on the selected date: ```json { "code": 200, "msg": "OK", "data": { "league": "soccer", "date": "2026-11-01", "competition_id": "soccer.l.fbfacup", "count": 0, "source_url": "https://sports.yahoo.com/soccer/scoreboard/?date=2026-11-01", "fetched_at": "2026-11-01T00:00:00Z", "games": [] } } ```

Hinweise zur Response

- `groups` preserves Yahoo's own conference/division ordering; each group's `entries` preserves Yahoo's own position ordering. - `games_back` is `null` for a division/conference leader. - Single-table soccer leagues (`mls`, `premier-league`, `la-liga`, `serie-a`, `bundesliga`, `ligue-1`, `champions-league`, `nwsl`, `ligamx-apertura`, `ligamx-clausura`) return a single ungrouped table — `groups` has one entry with empty `conference`/`division` — and each entry's `record.points` is populated (3 per win, 1 per draw); `record.points` is omitted for every other league. - `world-cup` is the one exception with real grouping: its group-stage format returns multiple groups (e.g. `division: "Group J"`), not a single table. - `college-basketball` groups by conference only (`division` is empty for every group); `college-football` groups by conference then division (e.g. `division: "FBS"`). - Invalid `league` or unsupported standings values return an invalid-parameter error before upstream IO.

Hinweise zur Response

- `team` is looked up by matching the requested slug against the page's own team links, so an unknown slug returns a not-found error rather than a wrong team. - `record` reflects Yahoo's current-season record; preseason/off-season windows may show `0-0`. - Invalid `league`/`team` values return an invalid-parameter error before upstream IO; an unknown team slug returns a 404.

Hinweise zur Response

- `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. - Invalid `league`/`team` values return an invalid-parameter error before upstream IO.

Hinweise zur Response

- `games` preserves Yahoo's own chronological ordering. - Each game's `slug` field is the identifier the `game`/boxscore endpoint expects. - Invalid `league`/`team` values return an invalid-parameter error before upstream IO.

Hinweise zur Response

- `line_score` has one entry per period actually played (innings/quarters/periods), each carrying that period's away/home score. - `team_stats` has one entry per team with a flat, labeled stat list (e.g. runs, hits, errors for baseball); a stat's `label` falls back to its raw `id` when Yahoo's own payload de-duplicated the label text elsewhere on the page. - Pre-game and in-progress games return whatever score/line-score/stat data Yahoo has published so far — this is a genuine partial result, not an error. - Soccer responses include the source `competition` ID and name. `game_url` accepts only HTTPS `sports.yahoo.com/soccer/...` game links with a source game ID in the final path segment. - `play_by_play` contains Yahoo's source event objects when present. The event fields vary by sport (for example, NHL plays include rink coordinates), so their contents are preserved without flattening them into a cross-sport schema. - `win_probability_timeline` contains Yahoo's source probability points when present. Yahoo does not publish this timeline for every sport or game; soccer game pages may omit it. - These arrays contain the complete data Yahoo embeds on the selected game page. They are not paginated and this endpoint does not add event filters. - Invalid `league`/`game` values return an invalid-parameter error before upstream IO; an unknown game slug returns a 404.