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

# Yahoo Sports standings

`GET /yahoo-sports/standings`

## Request

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

Returns league standings (record, streak, games back, and clinch status) grouped by conference/division, from sports.yahoo.com's own server-rendered standings page. The `league` enum accepts `nfl`, `nba`, `wnba`, `mlb`, `nhl`, `college-football`, `college-basketball`, `mls`, `premier-league`, `la-liga`, `serie-a`, `bundesliga`, `ligue-1`, `nwsl`, `ligamx-apertura`, `ligamx-clausura`, `world-cup`, and `champions-league` (not `college-womens-basketball`, whose standings page does not embed a full grouped table). Soccer leagues return a single ungrouped table (no conference/division) and each entry's `record.points` is populated (3 per win, 1 per draw).

## Query parameters

- `league` 'nfl' | 'nba' | 'wnba' | 'mlb' | 'nhl' | 'college-football' | 'college-basketball' | 'mls' | 'premier-league' | 'la-liga' | 'serie-a' | 'bundesliga' | 'ligue-1' | 'champions-league' | 'nwsl' | 'ligamx-apertura' | 'ligamx-clausura' | 'world-cup', required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- YahoosportsStandingsResponseDoc
  - `code` integer
  - `data` YahoosportsStandingsResponse
    - `count` integer
    - `fetched_at` string
    - `groups` YahoosportsStandingsGroup[]
      - `conference` string
      - `division` string
      - `entries` YahoosportsStandingsEntry[]
        - `away_record` string
        - `clinched_division` boolean
        - `clinched_playoff` boolean
        - `games_back` number
        - `home_record` string
        - `last10` string
        - `position` integer
        - `record` YahoosportsTeamRecord
          - `display` string
          - `losses` integer
          - `points` integer: Points is soccer's own standings metric (3 per win, 1 per draw); omitted for every other league.
          - `ties` integer
          - `win_pct` string
          - `wins` integer
        - `streak` 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
    - `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/028417aa35bb?raw)