# WNBA API
> Live WNBA (women's basketball) data as an API — clean JSON, no key. Get the game scoreboard with live scores, clock and status; open any game for its leaders and result; browse the league standings (wins, losses, win percentage, games behind, streak); list all teams and open a team for its standing, venue and colours; pull a player's profile (position, jersey, height, weight, college); search players by name; and read the latest news. Live data sourced continuously from ESPN. The WNBA is one of the fastest-growing leagues in sports, with record viewership and a booming betting and fantasy market — ideal for score apps, fantasy and betting tools, dashboards and Discord bots. 8 data endpoints. Authenticated with an x-oanor-key; fair-use rate limits per plan.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/wnba-api/..."
```

## Pricing
- **Free** (Free) — 4,700 calls/Mo, 5 req/s
- **Starter** ($7/Mo) — 51,000 calls/Mo, 15 req/s
- **Pro** ($29/Mo) — 283,000 calls/Mo, 30 req/s
- **Mega** ($91/Mo) — 1,190,000 calls/Mo, 80 req/s

## Endpoints

### Games

#### `GET /v1/game` — A single game's detail

**Parameters:**
- `id` (query, required, string) — Game id Example: `401856970`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/wnba-api/v1/game?id=401856970"
```

**Response:**
```json
{
    "data": {
        "game": {
            "id": "401856970",
            "name": "Chicago Sky at Toronto Tempo",
            "teams": [
                {
                    "id": "131935",
                    "team": "Toronto Tempo",
                    "score": "85",
                    "record": "6-5",
                    "winner": true,
                    "home_away": "home",
                    "linescores": [
                        "29",
                        "19",
                        "22",
                        "15"
                    ],
                    "abbreviation": "TOR"
                },
                {
                    "id": "19",
                    "team": "Chicago Sky",
                    "score": "68",
                    "record": "4-7",
                    "winner": false,
                    "home_away": "away",
                    "linescores": [
                        "15",
                        "18",
                        "20",
                        "15"
                    ],
                    "abbreviation": "CHI"
                }
            ],
            "venue": "Coca-Cola Coliseum",
            "status": "Final",
            "leaders": [
                {
                    "value": "25",
                    "athlete": "Brittney Sykes"
                },
                {
                    "value": "18",
                    "athlete": "Azura Stevens"
                }
            ],
            "completed": 
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/scoreboard` — Games & scores

**Parameters:**
- `dates` (query, optional, string) — Date range YYYYMMDD-YYYYMMDD
- `seasontype` (query, optional, string) — 1=pre, 2=regular, 3=post

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/wnba-api/v1/scoreboard"
```

**Response:**
```json
{
    "data": {
        "count": 2,
        "games": [
            {
                "id": "401856970",
                "away": {
                    "id": "19",
                    "logo": "https://a.espncdn.com/i/teamlogos/wnba/500/chi.png",
                    "team": "Chicago Sky",
                    "score": "68",
                    "record": "4-7",
                    "winner": false,
                    "home_away": "away",
                    "abbreviation": "CHI"
                },
                "date": "2026-06-07T19:00Z",
                "home": {
                    "id": "131935",
                    "logo": "https://a.espncdn.com/i/teamlogos/wnba/500/tor.png",
                    "team": "Toronto Tempo",
                    "score": "85",
                    "record": "6-5",
                    "winner": true,
                    "home_away": "home",
                    "abbreviation": "TOR"
                },
                "name": "Chicago Sky at Toronto Tempo",
                "clock": "0.0",
                "venue": "Coca-Cola Coliseum",
                "period": 4,
                "status": "Final",
                "broadcast": "WNBA League Pass",
                "completed": true,
                "short_name": "CHI @ TOR",
                "season_type": 2
            },
            {
                "id": "401856971",
                "away": {
                    "id": "132052",
                    "logo": "https://a.espncdn.com/i/teamlogos/wnba/500/s
…(truncated, see openapi.json for full schema)
```

### Standings

#### `GET /v1/standings` — League standings

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/wnba-api/v1/standings"
```

**Response:**
```json
{
    "data": {
        "count": 1,
        "conferences": [
            {
                "teams": [
                    {
                        "id": "8",
                        "team": "Minnesota Lynx",
                        "wins": "9.0",
                        "losses": "2.0",
                        "streak": "W7",
                        "win_percent": ".818",
                        "abbreviation": "MIN",
                        "games_behind": "-"
                    },
                    {
                        "id": "20",
                        "team": "Atlanta Dream",
                        "wins": "7.0",
                        "losses": "3.0",
                        "streak": "W1",
                        "win_percent": ".700",
                        "abbreviation": "ATL",
                        "games_behind": "1.5"
                    },
                    {
                        "id": "17",
                        "team": "Las Vegas Aces",
                        "wins": "7.0",
                        "losses": "3.0",
                        "streak": "W3",
                        "win_percent": ".700",
                        "abbreviation": "LV",
                        "games_behind": "1.5"
                    },
                    {
                        "id": "3",
                        "team": "Dallas Wings",
                        "wins": "7.0",
                        "losses": "3.0",
                        "streak": "W4",
     
…(truncated, see openapi.json for full schema)
```

### Teams

#### `GET /v1/team` — Team detail

**Parameters:**
- `id` (query, required, string) — Team id Example: `5`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/wnba-api/v1/team?id=5"
```

**Response:**
```json
{
    "data": {
        "team": {
            "id": "5",
            "logo": "https://a.espncdn.com/i/teamlogos/wnba/500/ind.png",
            "name": "Indiana Fever",
            "color": "002d62",
            "record": "5-5",
            "location": "Indiana",
            "nickname": "Fever",
            "standing": "4th in Eastern Conference Division",
            "abbreviation": "IND",
            "alternate_color": "e03a3e"
        }
    },
    "meta": {
        "timestamp": "2026-06-08T01:20:08.288Z",
        "request_id": "08203971-c0b4-4bbd-bcbd-5f37365a227e"
    },
    "status": "ok",
    "message": "Team retrieved successfully",
    "success": true
}
```

#### `GET /v1/teams` — All WNBA teams

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/wnba-api/v1/teams"
```

**Response:**
```json
{
    "data": {
        "count": 15,
        "teams": [
            {
                "id": "20",
                "logo": "https://a.espncdn.com/i/teamlogos/wnba/500/atl.png",
                "name": "Atlanta Dream",
                "color": "e31837",
                "location": "Atlanta",
                "nickname": "Dream",
                "abbreviation": "ATL",
                "alternate_color": "5091cc"
            },
            {
                "id": "19",
                "logo": "https://a.espncdn.com/i/teamlogos/wnba/500/chi.png",
                "name": "Chicago Sky",
                "color": "5091cd",
                "location": "Chicago",
                "nickname": "Sky",
                "abbreviation": "CHI",
                "alternate_color": "ffd520"
            },
            {
                "id": "18",
                "logo": "https://a.espncdn.com/i/teamlogos/wnba/500/con.png",
                "name": "Connecticut Sun",
                "color": "f05023",
                "location": "Connecticut",
                "nickname": "Sun",
                "abbreviation": "CON",
                "alternate_color": "0a2240"
            },
            {
                "id": "3",
                "logo": "https://a.espncdn.com/i/teamlogos/wnba/500/dal.png",
                "name": "Dallas Wings",
                "color": "002b5c",
                "location": "Dallas",
                "nickname": "Wings",
                "abbreviation": "DAL",
                "alternate
…(truncated, see openapi.json for full schema)
```

### Players

#### `GET /v1/player` — Player profile

**Parameters:**
- `id` (query, required, string) — Player id Example: `4433403`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/wnba-api/v1/player?id=4433403"
```

**Response:**
```json
{
    "data": {
        "player": {
            "id": "4433403",
            "age": 24,
            "name": "Caitlin Clark",
            "team": "Indiana Fever",
            "active": true,
            "height": "6' 0\"",
            "jersey": "22",
            "status": "active",
            "weight": "157 lbs",
            "college": "Iowa",
            "headshot": "https://a.espncdn.com/i/headshots/wnba/players/full/4433403.png",
            "position": "G",
            "last_name": "Clark",
            "experience": "2nd Season",
            "first_name": "Caitlin",
            "date_of_birth": "22/1/2002",
            "position_name": "Guard"
        }
    },
    "meta": {
        "timestamp": "2026-06-08T01:20:09.014Z",
        "request_id": "5487c67b-9704-4555-bd6f-fb7c597b01ff"
    },
    "status": "ok",
    "message": "Player retrieved successfully",
    "success": true
}
```

#### `GET /v1/search` — Search players

**Parameters:**
- `query` (query, required, string) — Player name Example: `clark`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/wnba-api/v1/search?query=clark"
```

**Response:**
```json
{
    "data": {
        "count": 12,
        "query": "clark",
        "players": [
            {
                "id": "5ec40e1c-3104-322e-b80f-f358ea26aad4",
                "name": "Caitlin Clark",
                "image": "https://a.espncdn.com/i/headshots/wnba/players/full/4433403.png",
                "subtitle": "Indiana Fever"
            },
            {
                "id": "e50b7c1f-0792-372f-d2b9-ce80188f029f",
                "name": "Jordan Clarkson",
                "image": "https://a.espncdn.com/i/headshots/nba/players/full/2528426.png",
                "subtitle": "New York Knicks"
            },
            {
                "id": "44d75406-fd2f-49e2-ff9a-e3be72e82cf2",
                "name": "Wyndham Clark",
                "image": "https://a.espncdn.com/i/headshots/golf/players/full/11119.png"
            },
            {
                "id": "ac9aa77d-dbe6-3064-8bef-208071246a63",
                "name": "Brandon Clarke",
                "image": "https://a.espncdn.com/i/headshots/nba/players/full/3906665.png",
                "subtitle": "Memphis Grizzlies"
            },
            {
                "id": "22776ecf-aa0e-33ac-b56b-8c0eccab146a",
                "name": "Denzel Clarke",
                "image": "https://a.espncdn.com/i/headshots/mlb/players/full/4918085.png",
                "subtitle": "Athletics"
            },
            {
                "id": "09609790-79bb-81d4-522b-7a036e404c50",
                "name": "Alysha Clark",
     
…(truncated, see openapi.json for full schema)
```

### News

#### `GET /v1/news` — WNBA news

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/wnba-api/v1/news"
```

**Response:**
```json
{
    "data": {
        "count": 15,
        "articles": [
            {
                "link": "http://www.espn.com/wnba/recap?gameId=401856971",
                "type": "Recap",
                "image": "https://s.espncdn.com/stitcher/sports/basketball/wnba/events/401856971.png?templateId=espn.applewatch.awayhome.1",
                "headline": "Ogwumike and Hamby have double-doubles to help Sparks beat Fire 89-72",
                "published": "2026-06-08T01:14:01Z",
                "description": "— Nneka Ogwumike had 20 points and a season-high 17 rebounds, Dearica Hamby added 22 points and 12 rebounds and the Los Angeles Sparks beat the Portland Fire 89-72 on Sunday to snap their three-game losing streak."
            },
            {
                "link": "https://www.espn.com/video/clip/_/id/48995784/los-angeles-sparks-vs-fire-game-highlights",
                "type": "Media",
                "image": "https://a.espncdn.com/media/motion/wsc/2026/0608/c8063103-d1c5-4ea5-82ac-7e5022fc9cfe/c8063103-d1c5-4ea5-82ac-7e5022fc9cfe.jpg",
                "headline": "Los Angeles Sparks vs. Fire - Game Highlights",
                "published": "2026-06-08T01:06:56Z",
                "description": "Watch the Game Highlights from Los Angeles Sparks vs. Fire, 06/07/2026"
            },
            {
                "link": "http://www.espn.com/wnba/recap?gameId=401856970",
                "type": "Recap",
                "image": "https://s.espncdn.com/stitcher/sports/basketb
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Spec

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/wnba-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "service": "wnba-api",
        "endpoints": {
            "GET /v1/game": "A single game's detail by id.",
            "GET /v1/meta": "This document.",
            "GET /v1/news": "NBA news.",
            "GET /v1/team": "Team detail by id.",
            "GET /v1/teams": "All WNBA teams.",
            "GET /v1/player": "Player profile by id.",
            "GET /v1/search": "Search players by name.",
            "GET /v1/standings": "Conference standings.",
            "GET /v1/scoreboard": "Games & scores (dates=, seasontype=)."
        },
        "description": "WNBA basketball data: game scoreboard and results, single-game detail with leaders, conference standings, all teams, team detail, player profiles, player search and NBA news. Real live data, no key."
    },
    "meta": {
        "timestamp": "2026-06-08T01:20:09.557Z",
        "request_id": "900867bc-4c24-4c5d-a199-7952cdbe26cb"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/wnba-api
OpenAPI spec: https://www.oanor.com/api/wnba-api/openapi.json