GuidesRelease Log
Coverage MatrixDocumentationChange LogLog InContact Us
Release Log

NCAA Women's Basketball API – Push Feeds

We've added two Push feeds to our NCAA Women's Basketball API. These feeds match the structure and workflow of the existing Push feeds in our US Basketball APIs (NBA, WNBA, NCAA Men's Basketball, G League).

  • Push Events: Provides detailed, real-time information on every game event.
  • Push Statistics: Provides detailed, real-time game stats at the team and player level for all live full coverage games.
🗝️

Push Access

Push feeds are available to Realtime customers only, and are not included in the self-issued trial within your account. Reach out to a sales representative for trial access.

These feeds have already been added to the accounts of our Realtime customers — no action is required to gain access.


Benefit

With our RESTful endpoints, you make an API request each time you want new data. Push feeds instead open a single connection that streams continuous live updates, and that connection remains open indefinitely.

This makes Push a more efficient option for live NCAA Women's Basketball data:

  • No polling logic. Rather than managing pull frequency and repeatedly requesting endpoints during a game, your application listens for updates as they happen.
  • Faster updates. Payloads are delivered as changes occur, rather than on your polling interval.
  • Filter to what you need. By default, a connection streams all games in progress. Add optional query strings to restrict a connection to a single game, and open as many connections as you need — there is no limit on concurrent connections.
  • Metadata for routing. Each payload includes a metadata header describing the payload type and available filtering values, reducing processing and integration time on your side.
  • Familiar payload structure. Each Push update is a JSON payload that mirrors its RESTful counterpart — Push Events maps to Game Play-by-Play, and Push Statistics maps to Game Summary.
⚠️

Push Complements RESTful — It Does Not Replace It

Push does not provide a stateful session. There is no memory of previously sent data, and Push feeds do not deliver game status updates.

If you are disconnected from a Push session, use the corresponding RESTful endpoint to catch up. For example, after a Push Events disconnection, request Game Play-by-Play to capture the plays missed during the disconnection.


📐 Technical Requirements

To accept data from our Push feeds, ensure that your application can:

  • Follow an HTTP redirect, or use the location provided in the feed's header within one minute of your initial request.
  • Accept HTTP data transfer encoded as chunked.

When no new information is available on a feed, a heartbeat message is sent every 5 seconds to keep the connection active. If you stop receiving heartbeats, re-connect using your same initial request.


📋 Recommended Actions

  • Realtime customers already have access — you can begin integrating immediately. If you use the self-issued trial, contact your sales representative for Push trial access.
  • Verify your application can follow an HTTP redirect and accept chunked transfer encoding before integrating.
  • Open a Push Events or Push Statistics connection, using optional query strings to filter to specific games if needed.
  • Pair Push with the corresponding RESTful endpoints (Game Play-by-Play, Game Summary) to recover data after any disconnection, and continue using RESTful feeds for game status.
  • Test your integration against our NCAA Men's Basketball simulations before the season begins.

☑️ Sample Requests:

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://api.sportradar.com/ncaawb/trial/stream/en/events/subscribe")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Get.new(url)
request["x-api-key"] = "{your_api_key}"  # Replace with your actual key

response = http.request(request)
puts response.read_body
import requests
import json

headers = {
    'x-api-key': 'your_api_key'  # Replace with your actual key
}

r = requests.get("https://api.sportradar.com/ncaawb/trial/stream/en/statistics/subscribe",
    headers = headers,
    params = {'status': 'inprogress', 'match': 'sd:match:76b2e680-7da7-461f-95ad-e7c34dbc4c56'},
    allow_redirects=False)

redirect_url = r.headers['Location']
r = requests.get(redirect_url, headers=headers, stream=True)

for line in r.iter_lines():
    # filter out keep-alive new lines
    if line:
        decoded_line = line.decode('utf-8')
        print(json.loads(decoded_line))

🔢 Products

SportProductVersion(s)
BasketballNCAA Women's Basketball APIv8

🔁 Endpoints Affected


⚙️ Return Samples

The samples below are from our NCAA Men's Basketball API. NCAA Women's Basketball Push payloads follow an identical structure.

  • Push Events will return JSON like this.
  • Push Statistics will return JSON like this.

You can also test out NCAA Women's Basketball Push integration against our NCAA Men's Basketball simulations.