Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Integration Guides
Coverage MatrixDocumentationChange LogLog InContact Us

Live Game Updates

Use this guide to effectively access live WNBA game updates and statistics. It also covers the Daily Change Log endpoint which can be used to track postgame stat revisions.

Prerequisite - Accessing Available Seasons

To avoid confusion and ensure you're accessing available data, refer to our Seasons feed. This resource lists all the seasons for which we have data.

For example: To ensure data availability for future seasons, such as a schedule in advance of when a season begins, first check the Seasons feed to verify that data for that specific season is already provided.

Starting with this feed can prevent unnecessary errors and streamline your data retrieval process.


Getting Started - Accessing the Games You Want

  1. Find the game ID by querying one of the following feeds:

  2. Use the Game Id to access live data from any of the following feeds:

    Data TypeRecommended Feed
    Play-by-Play Data- Game Play-by-Play
    - Push Events
    Scoring Updates- Game Boxscore
    - Play-by-Play
    - Push Clock
    Game Statistics- Game Summary
    - Push Statistics

    🏀

    Using Game IDs for Push Feeds

    Using a specific game ID is optional when filtering the push events or push statistics feeds. Without specifying a game ID, the feeds will automatically return data for all games currently in progress.

Utilizing Schedule Feeds

You only need to call the schedule feeds once or twice a day at most to get the most up-to-date season information. Follow these steps:

  1. Load the necessary schedule using any of the schedule feeds.
  2. To stay updated on any scheduling changes, refer to the Daily Change Log feed. More details are available in the Change Log section.
  3. Ensure to start requests to live games no earlier than 10 minutes before the scheduled time.

Limitations of Schedule Feeds for Real-Time Game Status Updates:

  • The Schedule feed provides game status information, including statuses like "closed," “inprogress,” and "complete." However, it does not update as frequently as the real-time game feeds, which offer more current game status updates.
  • For more immediate updates, consider using more real-time feeds like the Play-by-Play or Game Boxscore endpoints, which are designed to provide the most up-to-date status changes during games.

Play-by-Play Data

Play-by-Play data provides a detailed, sequential account of every action that occurs during a game, including all plays and events. This data type is crucial for analyzing game flow, player performance, and tactical decisions in real-time.

Option 1 - Using the Play-by-Play Feed

You can call the Play-by-Play feed to get a live play-by-play timeline, including shot types and locations, and on-court participants.

How to Pull the Play-by-Play Feed:

  1. Ensure you have your game IDs and schedules.
  2. Call the Play-by-Play feed: Use your game ID to request the Play-by-Play feed for real-time updates throughout the live game.

Recommended Pull Frequency:

  • Request this feed no sooner than 10 minutes before the scheduled start of the game (status = scheduled) based on your specific needs.
  • Once the game is in progress (status = inprogress), you may query the feed as necessary.
  • The endpoint offers real-time data updates and maintains a two-second TTL once the game status changes to inprogress.
  • Utilize the Daily Change Log to capture data changes after a game has ended.
🏀
Accessing WNBA Play-by-Play Data
Open Recipe

Play-by-Play Example:

{
  "id": "6a826d4d-592b-487d-9e1b-6df346ddab7c",
  "status": "closed",
  "coverage": "full",
  "scheduled": "2024-05-16T02:00:00+00:00",
  "duration": "2:00",
  "attendance": 3847,
  "lead_changes": 5,
  "times_tied": 7,
  "clock": "00:00",
  "quarter": 4,
  "track_on_court": true,
  "reference": "1022400006",
  "entry_mode": "WEBSOCKET",
  "sr_id": "sr:match:46601627",
  "clock_decimal": "00:00",
  "broadcasts": [
    {
      "type": "TV",
      "locale": "Home",
      "network": "SportsNet LA",
      "channel": "690"
    },
    {
      "type": "TV",
      "locale": "Away",
      "network": "Peachtree TV"
    }
  ],
  "time_zones": {
    "venue": "US/Pacific",
    "home": "US/Pacific",
    "away": "US/Eastern"
  },
  "season": {
    "id": "db004e22-7ed4-4316-8302-79454224f49d",
    "year": 2024,
    "type": "REG",
    "name": "Regular Season"
  },
  "home": {
    "name": "Sparks",
    "alias": "LAS",
    "market": "Los Angeles",
    "id": "0a5ad38d-2fe3-43ba-894b-1ba3d5042ea9",
    "points": 81,
    "bonus": true,
    "sr_id": "sr:team:3447",
    "remaining_timeouts": 0,
    "reference": "1611661320"
  },
  "away": {
    "name": "Dream",
    "alias": "ATL",
    "market": "Atlanta",
    "id": "5d70a9af-8c2b-4aec-9e68-9acc6ddb93e4",
    "points": 92,
    "bonus": true,
    "sr_id": "sr:team:35545",
    "remaining_timeouts": 1,
    "reference": "1611661330"
  },
  "periods": [
    {
      "type": "quarter",
      "id": "393af329-f3cc-4fef-a115-42323b50b4c4",
      "number": 1,
      "sequence": 1,
      "scoring": {
        "lead_changes": 0,
        "home": {
          "name": "Sparks",
          "market": "Los Angeles",
          "id": "0a5ad38d-2fe3-43ba-894b-1ba3d5042ea9",
          "points": 26
        },
        "away": {
          "name": "Dream",
          "market": "Atlanta",
          "id": "5d70a9af-8c2b-4aec-9e68-9acc6ddb93e4",
          "points": 26
        }
      },
      "events": [
        {
          "id": "2a9e58d8-381d-4714-885c-fa6ea7a82ddf",
          "clock": "10:00",
          "updated": "2024-05-16T02:04:11Z",
          "description": "Dream lineup change (Cheyenne Parker-Tyus, Rhyne Howard, Allisha Gray, Haley Jones, Tina Charles)",
          "wall_clock": "2024-05-16T02:04:11Z",
          "sequence": 1715825051093,
          "home_points": 0,
          "away_points": 0,
          "clock_decimal": "10:00",
          "created": "2024-05-16T02:04:11Z",
          "event_type": "lineupchange",
          "attribution": {
            "name": "Dream",
            "market": "Atlanta",
            "id": "5d70a9af-8c2b-4aec-9e68-9acc6ddb93e4",
            "sr_id": "sr:team:35545"
          },
          "on_court": {
            "home": {
              "name": "Sparks",
              "market": "Los Angeles",
              "id": "0a5ad38d-2fe3-43ba-894b-1ba3d5042ea9",
              "sr_id": "sr:team:3447",
              "reference": "1611661320",
              "players": [
                {
                  "full_name": "Lexie Brown",
                  "jersey_number": "4",
                  "id": "155215e8-3e76-49cd-b00a-e0d9a124ec7f",
                  "sr_id": "sr:player:1151590",
                  "reference": "1628882"
                },
                {
                  "full_name": "Layshia Clarendon",
                  "jersey_number": "25",
                  "id": "b77b40a2-5844-48c0-bae2-5067516b2acf",
                  "sr_id": "sr:player:1157032",
                  "reference": "203406"
                },
                {
                  "full_name": "Kia Nurse",
                  "jersey_number": "10",
                  "id": "c0d2573a-fc13-405d-bb9e-cc37552806ed",
                  "sr_id": "sr:player:1155250",
                  "reference": "1628915"
                },
                {
                  "full_name": "Cameron Brink",
                  "jersey_number": "22",
                  "id": "55cbf5b3-3dfb-447b-b661-d9ccbf601066",
                  "sr_id": "sr:player:2106290",
                  "reference": "1642287"
                },
                {
                  "full_name": "Dearica Hamby",
                  "jersey_number": "5",
                  "id": "693b6941-8999-40bb-a3a2-b77c34f1dc78",
                  "sr_id": "sr:player:1156992",
                  "reference": "204324"
                }
              ]
            },
            "away": {
              "name": "Dream",
              "market": "Atlanta",
              "id": "5d70a9af-8c2b-4aec-9e68-9acc6ddb93e4",
              "sr_id": "sr:team:35545",
              "reference": "1611661330",
              "players": [
                {
                  "full_name": "Cheyenne Parker-Tyus",
                  "jersey_number": "32",
                  "id": "4a97e708-71e5-4d58-b1e8-883adf027925",
                  "sr_id": "sr:player:1156878",
                  "reference": "204323"
                },
                {
                  "full_name": "Rhyne Howard",
                  "jersey_number": "10",
                  "id": "ab39141d-852e-4308-8b5d-8d06441ffbbd",
                  "sr_id": "sr:player:1618836",
                  "reference": "1631009"
                },
                {
                  "full_name": "Allisha Gray",
                  "jersey_number": "15",
                  "id": "293b5925-fd31-4640-8ada-bf6451a2c488",
                  "sr_id": "sr:player:1157078",
                  "reference": "1628277"
                },
                {
                  "full_name": "Haley Jones",
                  "jersey_number": "13",
                  "id": "7c97d5bc-1718-4284-9d85-87f2f1b23eec",
                  "sr_id": "sr:player:1947700",
                  "reference": "1641650"
                },
                {
                  "full_name": "Tina Charles",
                  "jersey_number": "31",
                  "id": "7797aa88-28c4-4a34-bb63-1af7f8d80ec0",
                  "sr_id": "sr:player:1156966",
                  "reference": "202250"
                }
              ]
            }
          }
        },
        {
          "id": "ae0be170-bd99-4ea0-8db8-2818b043278b",
          "clock": "10:00",
          "updated": "2024-05-16T02:04:11Z",
          "description": "Sparks lineup change (Lexie Brown, Layshia Clarendon, Kia Nurse, Cameron Brink, Dearica Hamby)",
          "wall_clock": "2024-05-16T02:04:11Z",
          "sequence": 1715825051095,
          "home_points": 0,
          "away_points": 0,
          "clock_decimal": "10:00",
          "created": "2024-05-16T02:04:11Z",
          "event_type": "lineupchange",
          "attribution": {
            "name": "Sparks",
            "market": "Los Angeles",
            "id": "0a5ad38d-2fe3-43ba-894b-1ba3d5042ea9",
            "sr_id": "sr:team:3447"
          },
          "on_court": {
            "home": {
              "name": "Sparks",
              "market": "Los Angeles",
              "id": "0a5ad38d-2fe3-43ba-894b-1ba3d5042ea9",
              "sr_id": "sr:team:3447",
              "reference": "1611661320",
              "players": [
                {
                  "full_name": "Lexie Brown",
                  "jersey_number": "4",
                  "id": "155215e8-3e76-49cd-b00a-e0d9a124ec7f",
                  "sr_id": "sr:player:1151590",
                  "reference": "1628882"
                },
                {
                  "full_name": "Layshia Clarendon",
                  "jersey_number": "25",
                  "id": "b77b40a2-5844-48c0-bae2-5067516b2acf",
                  "sr_id": "sr:player:1157032",
                  "reference": "203406"
                },
                {
                  "full_name": "Kia Nurse",
                  "jersey_number": "10",
                  "id": "c0d2573a-fc13-405d-bb9e-cc37552806ed",
                  "sr_id": "sr:player:1155250",
                  "reference": "1628915"
                },
                {
                  "full_name": "Cameron Brink",
                  "jersey_number": "22",
                  "id": "55cbf5b3-3dfb-447b-b661-d9ccbf601066",
                  "sr_id": "sr:player:2106290",
                  "reference": "1642287"
                },
                {
                  "full_name": "Dearica Hamby",
                  "jersey_number": "5",
                  "id": "693b6941-8999-40bb-a3a2-b77c34f1dc78",
                  "sr_id": "sr:player:1156992",
                  "reference": "204324"
                }
              ]
            },
            "away": {
              "name": "Dream",
              "market": "Atlanta",
              "id": "5d70a9af-8c2b-4aec-9e68-9acc6ddb93e4",
              "sr_id": "sr:team:35545",
              "reference": "1611661330",
              "players": [
                {
                  "full_name": "Cheyenne Parker-Tyus",
                  "jersey_number": "32",
                  "id": "4a97e708-71e5-4d58-b1e8-883adf027925",
                  "sr_id": "sr:player:1156878",
                  "reference": "204323"
                },
                {
                  "full_name": "Rhyne Howard",
                  "jersey_number": "10",
                  "id": "ab39141d-852e-4308-8b5d-8d06441ffbbd",
                  "sr_id": "sr:player:1618836",
                  "reference": "1631009"
                },
                {
                  "full_name": "Allisha Gray",
                  "jersey_number": "15",
                  "id": "293b5925-fd31-4640-8ada-bf6451a2c488",
                  "sr_id": "sr:player:1157078",
                  "reference": "1628277"
                },
                {
                  "full_name": "Haley Jones",
                  "jersey_number": "13",
                  "id": "7c97d5bc-1718-4284-9d85-87f2f1b23eec",
                  "sr_id": "sr:player:1947700",
                  "reference": "1641650"
                },
                {
                  "full_name": "Tina Charles",
                  "jersey_number": "31",
                  "id": "7797aa88-28c4-4a34-bb63-1af7f8d80ec0",
                  "sr_id": "sr:player:1156966",
                  "reference": "202250"
                }
              ]
            }
          }
        },
        {
          "id": "1e74ff07-1d3d-440e-8cdb-85748617671f",
          "clock": "10:00",
          "updated": "2024-09-04T14:10:24Z",
          "description": "Cheyenne Parker-Tyus vs. Cameron Brink (Layshia Clarendon gains possession)",
          "wall_clock": "2024-05-16T02:04:13Z",
          "sequence": 1715825053900,
          "home_points": 0,
          "away_points": 0,
          "clock_decimal": "10:00",
          "created": "2024-05-16T02:04:14Z",
          "event_type": "opentip",
          "attribution": {
            "name": "Sparks",
            "market": "Los Angeles",
            "id": "0a5ad38d-2fe3-43ba-894b-1ba3d5042ea9",
            "team_basket": "left",
            "sr_id": "sr:team:3447"
          },
          "location": {
            "coord_x": 1128,
            "coord_y": 600
          },
          "possession": {
            "name": "Sparks",
            "market": "Los Angeles",
            "id": "0a5ad38d-2fe3-43ba-894b-1ba3d5042ea9",
            "sr_id": "sr:team:3447",
            "reference": "1611661320"
          },
          "on_court": {
            "home": {
              "name": "Sparks",
              "market": "Los Angeles",
              "id": "0a5ad38d-2fe3-43ba-894b-1ba3d5042ea9",
              "sr_id": "sr:team:3447",
              "reference": "1611661320",
              "players": [
                {
                  "full_name": "Lexie Brown",
                  "jersey_number": "4",
                  "id": "155215e8-3e76-49cd-b00a-e0d9a124ec7f",
                  "sr_id": "sr:player:1151590",
                  "reference": "1628882"
                },
                {
                  "full_name": "Layshia Clarendon",
                  "jersey_number": "25",
                  "id": "b77b40a2-5844-48c0-bae2-5067516b2acf",
                  "sr_id": "sr:player:1157032",
                  "reference": "203406"
                },
                {
                  "full_name": "Kia Nurse",
                  "jersey_number": "10",
                  "id": "c0d2573a-fc13-405d-bb9e-cc37552806ed",
                  "sr_id": "sr:player:1155250",
                  "reference": "1628915"
                },
                {
                  "full_name": "Cameron Brink",
                  "jersey_number": "22",
                  "id": "55cbf5b3-3dfb-447b-b661-d9ccbf601066",
                  "sr_id": "sr:player:2106290",
                  "reference": "1642287"
                },
                {
                  "full_name": "Dearica Hamby",
                  "jersey_number": "5",
                  "id": "693b6941-8999-40bb-a3a2-b77c34f1dc78",
                  "sr_id": "sr:player:1156992",
                  "reference": "204324"
                }
              ]
            },
            "away": {
              "name": "Dream",
              "market": "Atlanta",
              "id": "5d70a9af-8c2b-4aec-9e68-9acc6ddb93e4",
              "sr_id": "sr:team:35545",
              "reference": "1611661330",
              "players": [
                {
                  "full_name": "Cheyenne Parker-Tyus",
                  "jersey_number": "32",
                  "id": "4a97e708-71e5-4d58-b1e8-883adf027925",
                  "sr_id": "sr:player:1156878",
                  "reference": "204323"
                },
                {
                  "full_name": "Rhyne Howard",
                  "jersey_number": "10",
                  "id": "ab39141d-852e-4308-8b5d-8d06441ffbbd",
                  "sr_id": "sr:player:1618836",
                  "reference": "1631009"
                },
                {
                  "full_name": "Allisha Gray",
                  "jersey_number": "15",
                  "id": "293b5925-fd31-4640-8ada-bf6451a2c488",
                  "sr_id": "sr:player:1157078",
                  "reference": "1628277"
                },
                {
                  "full_name": "Haley Jones",
                  "jersey_number": "13",
                  "id": "7c97d5bc-1718-4284-9d85-87f2f1b23eec",
                  "sr_id": "sr:player:1947700",
                  "reference": "1641650"
                },
                {
                  "full_name": "Tina Charles",
                  "jersey_number": "31",
                  "id": "7797aa88-28c4-4a34-bb63-1af7f8d80ec0",
                  "sr_id": "sr:player:1156966",
                  "reference": "202250"
                }
              ]
            }
          }
        },
        {
          "id": "6b0550bd-a7c4-4ea9-b2e7-8ec65442d441",
          "clock": "9:33",
          "updated": "2024-09-04T14:10:24Z",
          "description": "Kia Nurse misses three point stepback jump shot",
          "wall_clock": "2024-05-16T02:04:38Z",
          "sequence": 1715825078400,
          "home_points": 0,
          "away_points": 0,
          "clock_decimal": "9:33",
          "created": "2024-05-16T02:04:41Z",
          "event_type": "threepointmiss",
          "attribution": {
            "name": "Sparks",
            "market": "Los Angeles",
            "id": "0a5ad38d-2fe3-43ba-894b-1ba3d5042ea9",
            "team_basket": "left",
            "sr_id": "sr:team:3447"
          },
          "location": {
            "coord_x": 279,
            "coord_y": 509
          },
          "on_court": {
            "home": {
              "name": "Sparks",
              "market": "Los Angeles",
              "id": "0a5ad38d-2fe3-43ba-894b-1ba3d5042ea9",
              "sr_id": "sr:team:3447",
              "reference": "1611661320",
              "players": [
                {
                  "full_name": "Lexie Brown",
                  "jersey_number": "4",
                  "id": "155215e8-3e76-49cd-b00a-e0d9a124ec7f",
                  "sr_id": "sr:player:1151590",
                  "reference": "1628882"
                },
                {
                  "full_name": "Layshia Clarendon",
                  "jersey_number": "25",
                  "id": "b77b40a2-5844-48c0-bae2-5067516b2acf",
                  "sr_id": "sr:player:1157032",
                  "reference": "203406"
                },
                {
                  "full_name": "Kia Nurse",
                  "jersey_number": "10",
                  "id": "c0d2573a-fc13-405d-bb9e-cc37552806ed",
                  "sr_id": "sr:player:1155250",
                  "reference": "1628915"
                },
                {
                  "full_name": "Cameron Brink",
                  "jersey_number": "22",
                  "id": "55cbf5b3-3dfb-447b-b661-d9ccbf601066",
                  "sr_id": "sr:player:2106290",
                  "reference": "1642287"
                },
                {
                  "full_name": "Dearica Hamby",
                  "jersey_number": "5",
                  "id": "693b6941-8999-40bb-a3a2-b77c34f1dc78",
                  "sr_id": "sr:player:1156992",
                  "reference": "204324"
                }
              ]
            },
            "away": {
              "name": "Dream",
              "market": "Atlanta",
              "id": "5d70a9af-8c2b-4aec-9e68-9acc6ddb93e4",
              "sr_id": "sr:team:35545",
              "reference": "1611661330",
              "players": [
                {
                  "full_name": "Cheyenne Parker-Tyus",
                  "jersey_number": "32",
                  "id": "4a97e708-71e5-4d58-b1e8-883adf027925",
                  "sr_id": "sr:player:1156878",
                  "reference": "204323"
                },
                {
                  "full_name": "Rhyne Howard",
                  "jersey_number": "10",
                  "id": "ab39141d-852e-4308-8b5d-8d06441ffbbd",
                  "sr_id": "sr:player:1618836",
                  "reference": "1631009"
                },
                {
                  "full_name": "Allisha Gray",
                  "jersey_number": "15",
                  "id": "293b5925-fd31-4640-8ada-bf6451a2c488",
                  "sr_id": "sr:player:1157078",
                  "reference": "1628277"
                },
                {
                  "full_name": "Haley Jones",
                  "jersey_number": "13",
                  "id": "7c97d5bc-1718-4284-9d85-87f2f1b23eec",
                  "sr_id": "sr:player:1947700",
                  "reference": "1641650"
                },
                {
                  "full_name": "Tina Charles",
                  "jersey_number": "31",
                  "id": "7797aa88-28c4-4a34-bb63-1af7f8d80ec0",
                  "sr_id": "sr:player:1156966",
                  "reference": "202250"
                }
              ]
            }
          },
          "statistics": [
            {
              "type": "fieldgoal",
              "made": false,
              "shot_type": "jump shot",
              "shot_type_desc": "stepback",
              "three_point_shot": true,
              "team": {
                "name": "Sparks",
                "market": "Los Angeles",
                "id": "0a5ad38d-2fe3-43ba-894b-1ba3d5042ea9",
                "sr_id": "sr:team:3447",
                "reference": "1611661320"
              },
              "player": {
                "full_name": "Kia Nurse",
                "jersey_number": "10",
                "id": "c0d2573a-fc13-405d-bb9e-cc37552806ed",
                "sr_id": "sr:player:1155250",
                "reference": "1628915"
              }
            }
          ]
        }
      ]
    }
  ]
}

In this play-by-play example, Kia Nurse of the Los Angeles Sparks misses a stepback three-point jump shot early in the first quarter. The game features a competitive start with the Sparks and Atlanta Dream tied at 26 after the opening period. Key moments include lineup changes for both teams and the opening tip, won by the Sparks' Layshia Clarendon. This sequence illustrates how real-time events like missed shots, substitutions, and possession changes are captured for game flow analysis and stat tracking.

Use Case:

In your basketball analytics application, you could track and display detailed play-by-play data like Kia Nurse’s missed stepback three-point attempt for the Los Angeles Sparks. This shot occurred early in the first quarter against the Atlanta Dream and is part of a sequence that also includes lineup changes and possession updates. Presenting these events in real time allows users to evaluate shooting tendencies, track in-game momentum, and analyze key shifts in gameplay. This level of detail is especially valuable for performance breakdowns, coaching insights, or enhancing fantasy basketball decision-making.

Option 2 - Using the Push Events and Play-by-Play Feeds

The Push Events feed delivers live play-by-play data with a single API call, optimizing real-time updates and reducing API calls.

👍

Tip - Compare Data Points

Compare the data points returned by the Play-by-Play feed with those from the Push Events feed to understand the specific information each provides.

Streamline your access to live game updates by combining the Push Events and Play-by-Play feeds:

  1. Open a connection with a single call to the Push Events feed to receive real-time updates.
  2. Push feeds automatically deliver JSON payloads through a push service, minimizing the number of calls required.
  3. Supplement this with the RESTful Play-by-Play feed to obtain detailed statistics and comprehensive game data when needed.

Note: You need to be a Realtime customer to make use of the Push feature.

How to Pull the Push Events Feed:

  • Add the match parameter with the specific game id. Without the match parameter the feed will return data for all live WNBA games.
  • The Push Events feed should not be used exclusively; supplement it with the Play-by-Play feed for comprehensive data coverage.
  • Certain statistics are only available through the RESTful API and not included in the Push Events Feed.
  • In the event of a disconnection from the Push Events Feed, it's not possible to resume where you left off. To ensure continuous coverage, use multiple Push Feeds and supplement with RESTful feeds as a fallback to retrieve any missed timeline information during live games.

👍

Tip - Open Simultaneous Push Connections

Opening multiple connections to the push events feed boosts your application's reliability and flexibility. It enables simultaneous monitoring of various games or data types and ensures continuous data flow, even if one connection fails. This method also enhances scalability and data management, vital for applications needing real-time updates.

Play-by-Play vs. Push Scenario:

In a live basketball tracking app, you might use the Push Events feed to receive real-time notifications of key moments like dunks, fouls, or three-pointers. However, for a user-requested feature that provides a detailed timeline of the game, including minor plays and player stats, you can supplement with the Play-by-Play feed to capture comprehensive game details beyond quick updates. This ensures your app delivers both instant highlights and in-depth analysis.

📘

Game Status Workflows

For more on what feeds look like throughout the duration of a game, see the Game Status Workflow page.

Bonus - Using the Push Clock Feed

In addition to live play-by-play data, you can utilize the Push Clock feed to fetch WNBA game clock updates, providing access to live game timing information.

How to Pull the Push Clock Feed:

  1. Open a connection with a single call to the Push Clock feed to receive real-time updates.
  2. Add the match parameter with the specific game id. Without the match parameter the feed will return data for all live WNBA games.
  3. In the event of a disconnection from the Push Clock feed, it's not possible to resume where you left off. To ensure continuous coverage, use multiple Push Feeds

Use Case:

You can use this real-time clock data to enhance your sports app by providing live game updates that keep users engaged. For instance, you can display the remaining game and shot clock times, show when the clock is running or paused, and highlight critical moments such as the final seconds of a quarter or overtime period.


Scoring Updates

If your main interest is live score updates, use the Game Boxscore feed. While the Play-by-Play and Push Events feeds also include scoring data, the Game Boxscore feed offers more detailed scoring information for each team.

How to Pull the Game Boxscore Feed:

  1. Ensure you have your game IDs and schedules.
  2. Call the Game Boxscore feed: Use your game ID to request the Game Boxscore feed for real-time scoring updates throughout the live game.

Recommended Pull Frequency:

  • Request this feed no sooner than 10 minutes before the scheduled start of the game (status = scheduled) based on your specific needs.
  • Once the game is in progress (status = inprogress), you may query the feed as necessary.
  • The endpoint offers real-time data updates and maintains a two-second TTL once the game status changes to inprogress.
  • Utilize the Daily Change Log to capture data changes after a game has ended.
🏀
Accessing WNBA Game Boxscore Data
Open Recipe

Game Boxscore Example:

{
  "id": "6a826d4d-592b-487d-9e1b-6df346ddab7c",
  "status": "closed",
  "coverage": "full",
  "scheduled": "2024-05-16T02:00:00+00:00",
  "duration": "2:00",
  "attendance": 3847,
  "lead_changes": 5,
  "times_tied": 7,
  "clock": "00:00",
  "quarter": 4,
  "track_on_court": true,
  "reference": "1022400006",
  "entry_mode": "WEBSOCKET",
  "sr_id": "sr:match:46601627",
  "clock_decimal": "00:00",
  "broadcasts": [
    {
      "type": "TV",
      "locale": "Home",
      "network": "SportsNet LA",
      "channel": "690"
    },
    {
      "type": "TV",
      "locale": "Away",
      "network": "Peachtree TV"
    }
  ],
  "time_zones": {
    "venue": "US/Pacific",
    "home": "US/Pacific",
    "away": "US/Eastern"
  },
  "season": {
    "id": "db004e22-7ed4-4316-8302-79454224f49d",
    "year": 2024,
    "type": "REG",
    "name": "Regular Season"
  },
  "home": {
    "name": "Sparks",
    "alias": "LAS",
    "market": "Los Angeles",
    "id": "0a5ad38d-2fe3-43ba-894b-1ba3d5042ea9",
    "points": 81,
    "bonus": true,
    "sr_id": "sr:team:3447",
    "remaining_timeouts": 0,
    "reference": "1611661320",
    "scoring": [
      {
        "type": "quarter",
        "number": 1,
        "sequence": 1,
        "points": 26
      },
      {
        "type": "quarter",
        "number": 2,
        "sequence": 2,
        "points": 22
      },
      {
        "type": "quarter",
        "number": 3,
        "sequence": 3,
        "points": 18
      },
      {
        "type": "quarter",
        "number": 4,
        "sequence": 4,
        "points": 15
      }
    ],
    "leaders": {
      "points": [
        {
          "full_name": "Kia Nurse",
          "jersey_number": "10",
          "id": "c0d2573a-fc13-405d-bb9e-cc37552806ed",
          "position": "F",
          "primary_position": "SF",
          "sr_id": "sr:player:1155250",
          "reference": "1628915",
          "statistics": {
            "minutes": "32:19",
            "field_goals_made": 8,
            "field_goals_att": 16,
            "field_goals_pct": 50,
            "three_points_made": 5,
            "three_points_att": 11,
            "three_points_pct": 45.5,
            "two_points_made": 3,
            "two_points_att": 5,
            "two_points_pct": 60,
            "blocked_att": 1,
            "free_throws_made": 2,
            "free_throws_att": 2,
            "free_throws_pct": 100,
            "offensive_rebounds": 1,
            "defensive_rebounds": 1,
            "rebounds": 2,
            "assists": 1,
            "turnovers": 2,
            "steals": 1,
            "blocks": 0,
            "assists_turnover_ratio": 0.5,
            "personal_fouls": 1,
            "tech_fouls": 0,
            "flagrant_fouls": 0,
            "pls_min": 3,
            "points": 23,
            "tech_fouls_non_unsportsmanlike": 0,
            "double_double": false,
            "triple_double": false,
            "effective_fg_pct": 65.6,
            "efficiency": 17,
            "efficiency_game_score": 15.3,
            "fouls_drawn": 2,
            "offensive_fouls": 0,
            "points_in_paint": 4,
            "points_in_paint_att": 4,
            "points_in_paint_made": 2,
            "points_in_paint_pct": 50,
            "points_off_turnovers": 4,
            "true_shooting_att": 16.88,
            "true_shooting_pct": 68.1,
            "coach_ejections": 0,
            "coach_tech_fouls": 0,
            "second_chance_pts": 3,
            "second_chance_pct": 50
          }
        }
      ],
      "rebounds": [
        {
          "full_name": "Dearica Hamby",
          "jersey_number": "5",
          "id": "693b6941-8999-40bb-a3a2-b77c34f1dc78",
          "position": "C",
          "primary_position": "C",
          "sr_id": "sr:player:1156992",
          "reference": "204324",
          "statistics": {
            "minutes": "37:42",
            "field_goals_made": 7,
            "field_goals_att": 15,
            "field_goals_pct": 46.7,
            "three_points_made": 2,
            "three_points_att": 4,
            "three_points_pct": 50,
            "two_points_made": 5,
            "two_points_att": 11,
            "two_points_pct": 45.5,
            "blocked_att": 4,
            "free_throws_made": 4,
            "free_throws_att": 8,
            "free_throws_pct": 50,
            "offensive_rebounds": 3,
            "defensive_rebounds": 11,
            "rebounds": 14,
            "assists": 3,
            "turnovers": 2,
            "steals": 2,
            "blocks": 0,
            "assists_turnover_ratio": 1.5,
            "personal_fouls": 3,
            "tech_fouls": 0,
            "flagrant_fouls": 0,
            "pls_min": -10,
            "points": 20,
            "tech_fouls_non_unsportsmanlike": 0,
            "double_double": true,
            "triple_double": false,
            "effective_fg_pct": 53.3,
            "efficiency": 23,
            "efficiency_game_score": 17,
            "fouls_drawn": 5,
            "offensive_fouls": 0,
            "points_in_paint": 10,
            "points_in_paint_att": 10,
            "points_in_paint_made": 5,
            "points_in_paint_pct": 50,
            "points_off_turnovers": 7,
            "true_shooting_att": 18.52,
            "true_shooting_pct": 54,
            "coach_ejections": 0,
            "coach_tech_fouls": 0,
            "second_chance_pts": 3,
            "second_chance_pct": 50
          }
        }
      ]
    }
  }
}

This Game Boxscore example showcases standout performances and scoring by quarter from a WNBA matchup between the Los Angeles Sparks and Atlanta Dream. Kia Nurse led the Sparks with 23 points on 50% shooting, including five made threes, while Dearica Hamby dominated the boards with 14 rebounds and added 20 points. The Sparks posted quarterly scores of 26, 22, 18, and 15, reflecting a strong start but declining output. This snapshot gives a clear view of player impact and game flow across all four quarters.

This example shows how to visually present boxscore data for a WNBA regular season matchup. The summary features team logos, the final score—92–81 in favor of the Atlanta Dream—and a quarter-by-quarter scoring breakdown. This clean format helps users quickly understand game flow and final outcomes at a glance.


📸

Accessing Headshots and Team Logos

To access team logos and player headshots, use the Images API.

Use Case:

You can use this player performance data to enhance your sports app by offering detailed breakdowns of key moments in the game. You can display individual player stats, such as scoring contributions, rebounds, and assists, allowing users to see how each player's efforts influenced the game's outcome. Additionally, you can provide insights into shooting efficiency, defensive plays, and player matchups, helping users understand how these factors shaped critical turning points.


Game Statistics

If you're looking for game statistics like points scored, rebounds, and assists, you can use the Game Summary feed. In addition to Boxscore information, this feed provides detailed game stats at the team and player levels, offering a comprehensive view of key performance metrics throughout the game.

Option 1 - Using the Game Summary Feed

The Game Summary feed provides comprehensive game-level statistics, including detailed team and player performance metrics for each team in an WNBA game.

How to Pull the Game Summary Feed:

  • Request this feed no sooner than 10 minutes before the scheduled start of the game (status = scheduled) based on your specific needs.
  • Once the game is in progress (status = inprogress), you may query the feed as necessary.
  • The endpoint offers real-time data updates and maintains a two-second TTL once the game status changes to inprogress.
  • Utilize the Daily Change Log to capture data changes after a game has ended.

Game Summary Example:

{
  "id": "6a826d4d-592b-487d-9e1b-6df346ddab7c",
  "status": "closed",
  "coverage": "full",
  "scheduled": "2024-05-16T02:00:00+00:00",
  "duration": "2:00",
  "attendance": 3847,
  "lead_changes": 5,
  "times_tied": 7,
  "clock": "00:00",
  "quarter": 4,
  "track_on_court": true,
  "reference": "1022400006",
  "entry_mode": "WEBSOCKET",
  "sr_id": "sr:match:46601627",
  "clock_decimal": "00:00",
  "broadcasts": [
    {
      "type": "TV",
      "locale": "Home",
      "network": "SportsNet LA",
      "channel": "690"
    },
    {
      "type": "TV",
      "locale": "Away",
      "network": "Peachtree TV"
    }
  ],
  "time_zones": {
    "venue": "US/Pacific",
    "home": "US/Pacific",
    "away": "US/Eastern"
  },
  "season": {
    "id": "db004e22-7ed4-4316-8302-79454224f49d",
    "year": 2024,
    "type": "REG",
    "name": "Regular Season"
  },
  "venue": {
    "id": "ee28a38d-1d9e-41db-8fbd-d1fa52e8a296",
    "name": "Walter Pyramid",
    "capacity": 4000,
    "address": "1250 Bellflower Boulevard",
    "city": "Long Beach",
    "state": "CA",
    "zip": "90840",
    "country": "USA",
    "sr_id": "sr:venue:7492",
    "location": {
      "lat": "33.787222",
      "lng": "-118.114167"
    }
  },
  "home": {
    "name": "Sparks",
    "alias": "LAS",
    "market": "Los Angeles",
    "id": "0a5ad38d-2fe3-43ba-894b-1ba3d5042ea9",
    "points": 81,
    "bonus": true,
    "sr_id": "sr:team:3447",
    "remaining_timeouts": 0,
    "reference": "1611661320",
    "scoring": [
      {
        "type": "quarter",
        "number": 1,
        "sequence": 1,
        "points": 26
      },
      {
        "type": "quarter",
        "number": 2,
        "sequence": 2,
        "points": 22
      },
      {
        "type": "quarter",
        "number": 3,
        "sequence": 3,
        "points": 18
      },
      {
        "type": "quarter",
        "number": 4,
        "sequence": 4,
        "points": 15
      }
    ],
    "statistics": {
      "minutes": "3:20:00",
      "field_goals_made": 28,
      "field_goals_att": 72,
      "field_goals_pct": 38.9,
      "three_points_made": 12,
      "three_points_att": 31,
      "three_points_pct": 38.7,
      "two_points_made": 16,
      "two_points_att": 41,
      "two_points_pct": 39,
      "blocked_att": 9,
      "free_throws_made": 13,
      "free_throws_att": 22,
      "free_throws_pct": 59.1,
      "offensive_rebounds": 8,
      "defensive_rebounds": 27,
      "assists": 24,
      "steals": 8,
      "blocks": 2,
      "assists_turnover_ratio": 2.18,
      "personal_fouls": 17,
      "ejections": 0,
      "foulouts": 0,
      "points": 81,
      "fast_break_pts": 10,
      "second_chance_pts": 10,
      "team_turnovers": 3,
      "points_off_turnovers": 20,
      "team_rebounds": 16,
      "flagrant_fouls": 0,
      "player_tech_fouls": 0,
      "team_tech_fouls": 0,
      "coach_tech_fouls": 0,
      "points_in_paint": 30,
      "team_offensive_rebounds": 16,
      "team_defensive_rebounds": 0,
      "total_rebounds": 51,
      "total_turnovers": 14,
      "personal_rebounds": 35,
      "player_turnovers": 11,
      "field_goals_at_rim_made": 5,
      "field_goals_at_rim_att": 9,
      "field_goals_at_rim_pct": 55.6,
      "field_goals_at_midrange_made": 1,
      "field_goals_at_midrange_att": 8,
      "field_goals_at_midrange_pct": 12.5,
      "bench_points": 8,
      "biggest_lead": 7,
      "effective_fg_pct": 47.2,
      "efficiency": 80,
      "efficiency_game_score": 60.3,
      "fouls_drawn": 20,
      "offensive_fouls": 2,
      "pls_min": -11,
      "points_in_paint_att": 33,
      "points_in_paint_made": 15,
      "points_in_paint_pct": 45.5,
      "total_fouls": 17,
      "true_shooting_att": 81.68,
      "true_shooting_pct": 49.6,
      "coach_ejections": 0,
      "offensive_rating": 92.3813868613139,
      "defensive_rating": 113.077679449361,
      "defensive_points_per_possession": 1.05,
      "offensive_points_per_possession": 0.92,
      "fast_break_att": 7,
      "fast_break_made": 4,
      "fast_break_pct": 57.1,
      "points_against": 92,
      "possessions": 87.68,
      "opponent_possessions": 81.36,
      "second_chance_att": 9,
      "second_chance_made": 3,
      "second_chance_pct": 33.3,
      "team_fouls": 0,
      "time_leading": "14:07",
      "most_unanswered": {
        "points": 6,
        "own_score": 9,
        "opp_score": 2
      },
      "periods": [
        {
          "type": "REG",
          "id": "393af329-f3cc-4fef-a115-42323b50b4c4",
          "number": 1,
          "sequence": 1,
          "minutes": "50:00",
          "field_goals_made": 10,
          "field_goals_att": 15,
          "field_goals_pct": 66.7,
          "three_points_made": 3,
          "three_points_att": 7,
          "three_points_pct": 42.9,
          "two_points_made": 7,
          "two_points_att": 8,
          "two_points_pct": 87.5,
          "blocked_att": 0,
          "free_throws_made": 3,
          "free_throws_att": 6,
          "free_throws_pct": 50,
          "offensive_rebounds": 1,
          "defensive_rebounds": 7,
          "rebounds": 8,
          "assists": 9,
          "turnovers": 3,
          "steals": 1,
          "blocks": 0,
          "assists_turnover_ratio": 3,
          "personal_fouls": 5,
          "offensive_fouls": 1,
          "ejections": 0,
          "points": 26,
          "fast_break_pts": 4,
          "second_chance_pts": 0,
          "team_turnovers": 1,
          "points_off_turnovers": 2,
          "team_rebounds": 5,
          "flagrant_fouls": 0,
          "player_tech_fouls": 0,
          "team_tech_fouls": 0,
          "coach_tech_fouls": 0,
          "pls_min": 0,
          "effective_fg_pct": 76.7,
          "bench_points": 0,
          "points_in_paint": 12,
          "points_in_paint_att": 7,
          "points_in_paint_made": 6,
          "points_in_paint_pct": 85.7,
          "true_shooting_att": 17.64,
          "true_shooting_pct": 73.7,
          "biggest_lead": 7,
          "fouls_drawn": 3,
          "total_turnovers": 4,
          "efficiency": 31,
          "efficiency_game_score": 23.4,
          "team_defensive_rebounds": 0,
          "team_offensive_rebounds": 5,
          "total_fouls": 5,
          "total_rebounds": 13
        },
        {
          "type": "REG",
          "id": "dfbbd858-923b-4b9a-be5f-a939b19e78f3",
          "number": 2,
          "sequence": 2,
          "minutes": "50:00",
          "field_goals_made": 7,
          "field_goals_att": 17,
          "field_goals_pct": 41.2,
          "three_points_made": 4,
          "three_points_att": 7,
          "three_points_pct": 57.1,
          "two_points_made": 3,
          "two_points_att": 10,
          "two_points_pct": 30,
          "blocked_att": 2,
          "free_throws_made": 4,
          "free_throws_att": 7,
          "free_throws_pct": 57.1,
          "offensive_rebounds": 2,
          "defensive_rebounds": 8,
          "rebounds": 10,
          "assists": 6,
          "turnovers": 5,
          "steals": 4,
          "blocks": 0,
          "assists_turnover_ratio": 1.2,
          "personal_fouls": 2,
          "offensive_fouls": 0,
          "ejections": 0,
          "points": 22,
          "fast_break_pts": 2,
          "second_chance_pts": 1,
          "team_turnovers": 1,
          "points_off_turnovers": 8,
          "team_rebounds": 4,
          "flagrant_fouls": 0,
          "player_tech_fouls": 0,
          "team_tech_fouls": 0,
          "coach_tech_fouls": 0,
          "pls_min": 0,
          "effective_fg_pct": 52.9,
          "bench_points": 3,
          "points_in_paint": 6,
          "points_in_paint_att": 7,
          "points_in_paint_made": 3,
          "points_in_paint_pct": 42.9,
          "true_shooting_att": 20.08,
          "true_shooting_pct": 54.8,
          "biggest_lead": 2,
          "fouls_drawn": 4,
          "total_turnovers": 6,
          "efficiency": 24,
          "efficiency_game_score": 17.9,
          "team_defensive_rebounds": 0,
          "team_offensive_rebounds": 4,
          "total_fouls": 2,
          "total_rebounds": 14
        },
        {
          "type": "REG",
          "id": "4a4fb43e-9af1-4a4e-a7bc-c6991d887ddd",
          "number": 3,
          "sequence": 3,
          "minutes": "50:00",
          "field_goals_made": 7,
          "field_goals_att": 19,
          "field_goals_pct": 36.8,
          "three_points_made": 2,
          "three_points_att": 8,
          "three_points_pct": 25,
          "two_points_made": 5,
          "two_points_att": 11,
          "two_points_pct": 45.5,
          "blocked_att": 1,
          "free_throws_made": 2,
          "free_throws_att": 3,
          "free_throws_pct": 66.7,
          "offensive_rebounds": 3,
          "defensive_rebounds": 6,
          "rebounds": 9,
          "assists": 5,
          "turnovers": 3,
          "steals": 3,
          "blocks": 1,
          "assists_turnover_ratio": 1.67,
          "personal_fouls": 4,
          "offensive_fouls": 1,
          "ejections": 0,
          "points": 18,
          "fast_break_pts": 3,
          "second_chance_pts": 2,
          "team_turnovers": 0,
          "points_off_turnovers": 8,
          "team_rebounds": 1,
          "flagrant_fouls": 0,
          "player_tech_fouls": 0,
          "team_tech_fouls": 0,
          "coach_tech_fouls": 0,
          "pls_min": 0,
          "effective_fg_pct": 42.1,
          "bench_points": 5,
          "points_in_paint": 10,
          "points_in_paint_att": 8,
          "points_in_paint_made": 5,
          "points_in_paint_pct": 62.5,
          "true_shooting_att": 20.32,
          "true_shooting_pct": 44.3,
          "biggest_lead": 5,
          "fouls_drawn": 6,
          "total_turnovers": 3,
          "efficiency": 21,
          "efficiency_game_score": 13.6,
          "team_defensive_rebounds": 0,
          "team_offensive_rebounds": 1,
          "total_fouls": 4,
          "total_rebounds": 10
        },
        {
          "type": "REG",
          "id": "4f54a09a-1f9c-4964-b73e-70f589f899b3",
          "number": 4,
          "sequence": 4,
          "minutes": "50:00",
          "field_goals_made": 4,
          "field_goals_att": 21,
          "field_goals_pct": 19,
          "three_points_made": 3,
          "three_points_att": 9,
          "three_points_pct": 33.3,
          "two_points_made": 1,
          "two_points_att": 12,
          "two_points_pct": 8.3,
          "blocked_att": 6,
          "free_throws_made": 4,
          "free_throws_att": 6,
          "free_throws_pct": 66.7,
          "offensive_rebounds": 2,
          "defensive_rebounds": 6,
          "rebounds": 8,
          "assists": 4,
          "turnovers": 0,
          "steals": 0,
          "blocks": 1,
          "assists_turnover_ratio": 0,
          "personal_fouls": 6,
          "offensive_fouls": 0,
          "ejections": 0,
          "points": 15,
          "fast_break_pts": 1,
          "second_chance_pts": 7,
          "team_turnovers": 1,
          "points_off_turnovers": 2,
          "team_rebounds": 6,
          "flagrant_fouls": 0,
          "player_tech_fouls": 0,
          "team_tech_fouls": 0,
          "coach_tech_fouls": 0,
          "pls_min": -11,
          "effective_fg_pct": 26.2,
          "bench_points": 0,
          "points_in_paint": 2,
          "points_in_paint_att": 11,
          "points_in_paint_made": 1,
          "points_in_paint_pct": 9.1,
          "true_shooting_att": 23.64,
          "true_shooting_pct": 31.7,
          "biggest_lead": 0,
          "fouls_drawn": 7,
          "total_turnovers": 1,
          "efficiency": 4,
          "efficiency_game_score": 5.4,
          "team_defensive_rebounds": 0,
          "team_offensive_rebounds": 6,
          "total_fouls": 6,
          "total_rebounds": 14
        }
      ]
    }
  }
}

This game summary for the Los Angeles Sparks delivers a full breakdown of team performance across four quarters in a regular season matchup. The Sparks scored a total of 81 points, with key stats including 38.9% shooting from the field, 12 made three-pointers, and 51 total rebounds. The data also highlights performance areas such as fast break points (10), second-chance points (10), and points in the paint (30). This level of detail supports in-depth analysis of the Sparks’ offensive and defensive execution, shooting efficiency, and momentum shifts throughout the game.

You can visually represent key game statistics in your applications, showcasing essential data like field goal percentages, rebounds, and fouls. This style of presentation is ideal for conveying game insights to users in a clear and engaging way.


Use Case

You can use game statistics in your app to allow coaches and sports analysts to evaluate team performance and efficiency. This data provides valuable insights into field goal percentages, time spent in the lead, and the largest scoring runs, offering a clear understanding of how the game unfolded. By analyzing metrics such as rebounding, fouls, and shooting efficiency, users can make informed decisions on player rotations and strategies.

Option 2 - Using the Push Statistics Feed

The Push Statistics feed offers the same live stat data as the Game Summary feed, with its main advantage being continuous real-time updates through a single API call, thereby reducing the total number of API calls required.

Streamline your access to live game updates by combining the Push Statistics feed:

  1. Open a connection with a single call to the Push Statistics feed to receive real-time updates.
  2. Push feeds automatically deliver JSON payloads through a push service, minimizing the number of calls required.

Note: To utilize the Push feature, you must be a Realtime customer. Additionally, using the Game Summary feed as a backup is recommended for uninterrupted coverage.

How to Pull the Push Statistics Feed:

  • Add the match parameter with the specific game id. Without the match parameter the feed will return data for all live WNBA games.
  • In the event of a disconnection from the Push Statistics Feed, it's not possible to resume where you left off.
    • To ensure continuous coverage, use multiple Push Feeds and supplement with RESTful feeds like the Game Summary feed as a fallback to retrieve any missed timeline information during live games.

All-Star Game FAQ

How do I locate the WNBA All-Star game?

The game can be found in the Daily Schedule feed on the date of the event. For example: wnba/trial/v8/en/games/2024/07/20/schedule

Every game-centric feed (e.g. Game Play-by-Play, Game Summary, Push Events, etc) can be accessed during the game.

Click here for for a Game Summary or Play-by-Play sample of the 2023 game.

What are the differences from a typical WNBA game?

WNBA announced that 2024 would feature a matchup between the WNBA All-Stars who comprise the US Women's National Team versus the remaining WNBA All-Stars.

Please note that these teams will not be included in the League Hierarchy endpoint.

Is the All-Star game covered in realtime?

Yes. The game is covered in realtime, including the same level of team and player statistics as a regular season game.

When are the All-Star rosters set?

All-Star game rosters will be available shortly prior to tipoff.

Please note that we only provide game rosters (not team rosters) for each game. Request the Game Summary endpoint prior to the game to receive rosters.

If you require rosters earlier, we suggest using the Team Profile endpoints of each WNBA team to pull in players manually.

Do you cover any of the other All-Star game events?

No. We currently only cover the WNBA All-Star game in the WNBA API.


Game Simulations

Our API simulations allow you to replay actual games at any time, on your own schedule.

With the replayer, you can:

  • Request a list of available recordings (by league)
  • Register a session (allows a game to be replayed in natural time, specific to the session)
  • Continually request an endpoint as a "live" game progresses
  • Open up a continuous Push simulation of a game

Failover Data

The WNBA API data is collected by an WNBA-trained stats team and processed by Sportradar. If the WNBA experiences an unexpected system failure, Sportradar's failover process seamlessly takes over, ensuring your client application continues to receive data. While this prevents a total loss of data, some coverage differences may occur.

Please note that when the game is over, all data entered by Sportradar is deleted and replaced with the official data provided by the WNBA.

Official Data Unavailable During Failover

Boxscore Information:

  • Only Head Coach attributes are available - All other team staff members will not be displayed.
  • Not playing reason.

Game Statistics - Team:

  • Defensive Points per Possession
  • Defensive Rating
  • Fast Break Attempts
  • Fast Break Made
  • Fast Break Percentage
  • Offensive Points per Possession
  • Offensive Rating
  • Opponent Possessions
  • Points Against
  • Possessions
  • Second Chance Attempts
  • Second Chance Made
  • Second Chance Percentage
  • Team Defensive Rebounds
  • Team Fouls
  • Team Offensive Rebounds
  • Time Leadings
  • Total Fouls
  • Total Rebounds

.

Game Statistics - Player:

  • Coach Ejections
  • Coach Technical Fouls
  • Defensive Rating
  • Defensive Rebounds Percentage
  • Fast Break Attempts
  • Fast Break Made
  • Fast Break Percentage
  • Minus
  • Offensive Rating
  • Offensive Rebounds Percentage
  • Plus
  • Rebounds Percentage
  • Second Chance Attempts
  • Second Chance Made
  • Second Chance Percentage
  • Turnovers Percentage

.

Failover Statistics Summary

See a summarized view of our failover statistics.


Daily Change Log

The Daily Change Log endpoint allows for efficient tracking of daily changes to the WNBA API without depleting your API call limits. It updates you on significant changes like schedule adjustments, game results, player profile updates, and team modifications.

The table below outlines scenarios and use cases for utilizing the Daily Change Log for applications that offer live game updates.

DataUse Case
Game Play-by-PlayTrack changes in play details such as new plays added or corrections to existing play records.
Game SummaryMonitor updates in player and team statistics or post-game corrections.
Game BoxscoreMonitor adjustments in game summary data, including final scores or statistical errors being rectified.

To use the Daily Change Log feed for monitoring changes to recent games:

  1. Identify Change Types: First, review the Daily Change Log to identify the types of changes reported. These could be related to games, players, or teams. Each entry in the log will list relevant IDs (game, player, or team ID), depending on the type of change.

  2. Use IDs to Retrieve Specifics:

    • Game Changes: If the ID is found within the "results" node, it typically indicates a change in game results. This ID is a game ID.
    • Player and Team Changes: Similarly, IDs associated with players or teams indicate changes relevant to these entities, such as updates to player information or team rosters.

  3. Pull Detailed Data: Use the identified IDs to pull detailed information from the relevant feed. For example:

    • Game Play-by-Play Feed: If a game ID is mentioned, you can pull this feed to check for any new plays added or modifications to existing plays.
    • Game Statistics Feed: Use the game ID to retrieve updated player statistics and team performance metrics to see what specific data was altered.
    • Game Boxscore Feed: Pull this feed using the game ID to review any updates to the game summary, including scores and other significant game statistics.

  4. Verify Changes: After pulling the detailed data from the relevant feeds, compare the newly retrieved data against previously stored data to verify the changes and update your records accordingly.

⏱️

Update Frequency

TTL / Cache: 300 seconds

Data Updates:

  • Entries populate live for changes to teams, players, game statistics, schedules, and standings.
  • Start time of the log is 05:00:00 UTC; end time is 04:59:59 UTC

For optimal results, set a regular schedule to pull every 10 minutes or less (depending on your use case) to access the feed.

Updated about 8 hours ago

© Sportradar AG, St. Gallen, Switzerland