NASCAR API Basics

Intro

Sportradar’s NASCAR data is delivered via a RESTful API. Requests are authenticated using the API authentication credentials configured in your account.

Data is available in JSON or XML format.

Technical Requirements

To integrate with Sportradar API feeds, your application must meet the following requirements:

Support TLS 1.2 or higher for all inbound and outbound connections
Support API key–based authentication for RESTful requests
Be capable of consuming and parsing JSON or XML responses
Support standard HTTP methods and status codes used by RESTful APIs

API Style

The NASCAR API is a Sportradar League-Based API designed specifically for NASCAR. It provides official data for all three NASCAR series: Cup Series, O’Reilly Auto Parts Series, and Truck Series. Data is collected at the track and made available via NASCAR’s API. Sportradar ingests and transforms this data into a consistent US API format aligned with other League-Based APIs.

Note: While the NASCAR API follows the same league-based structure as other US sports APIs, it does not align with Sportradar’s motorsports or other racing series APIs, which may use different models and conventions.

The API includes primary and additional feeds that provide race and driver identifiers, schedules, standings, results, and update monitoring. These feeds are not real-time and are updated as new information becomes available. Race-centric weekend feeds deliver real-time data for individual races, including entry lists, practice and qualifying leaderboards, starting grids, race leaderboards, and comprehensive driver statistics at both race and seasonal levels.

Key Features

Key features of the NASCAR API include:

Official NASCAR data normalized into Sportradar’s US API format
Primary feeds for schedules, standings, and race results
Race-centric feeds with real-time practice, qualifying, and race updates
Driver statistics generated during events, with season statistics finalized post-race
XML and JSON data delivery via RESTful endpoints

Related Racing APIs

Sportradar also offers additional racing data APIs:

Data Collection

Data is collected on site by NASCAR and made available via NASCAR’s official API. Sportradar ingests this data directly from NASCAR and transforms it into the US API format, ensuring a consistent structure, naming conventions, and usability aligned with other Major American Sports APIs, while preserving sport-specific attributes where required.

Versioning

The NASCAR API is currently available in version v3, which is the only supported version at this time. While Sportradar may support multiple concurrent versions for some APIs in accordance with the Versioning Policy, no prior NASCAR API versions are currently available.

To access the NASCAR API, include v3 in the version parameter for each request. No additional configuration or adjustments are required.

Data Flow and Retrieval

The NASCAR API organizes its data into logical endpoints, or feeds. For example, to access a series schedule you will want to access the Schedule feed; to access live or completed race data, you will want to retrieve race-centric feeds such as Race Leaderboard, Practice Leaderboard, or Qualifying Leaderboard.

The API is separated into multiple distinct feeds, each with a focused purpose to allow for efficient data retrieval. Depending on your specific needs, different feeds and pull frequencies will be required. Use the NASCAR Endpoints section for feed documentation and an interactive sandbox.

Most feeds require the inclusion of a unique ID or parameter. Parameters can include season year, series, race ID, driver ID, or track ID. To retrieve these unique IDs, you may need to iterate through feeds with broader data sets, such as Seasons, Schedule, or Drivers. See the ID Handling page for more information on Sportradar IDs.

Here is an example retrieval path for race leaderboard data:

Step 1

First, make a request to the Schedule or Playoff Schedule endpoint.
See the Endpoint Descriptions section for data to be found in each feed.
Locate the unique Id of the race you are interested in.

Step 2

Finally, make a request to the Race Leaderboard feed using your found race Id.

All NASCAR API feeds will follow this pulling logic. Visit our Integration Scenarios section for specific retrieval scenarios.

Change Log

The NASCAR API includes a Daily Change Log feed, which is used to catch updates for drivers, race stats, schedules, and standings.

A request is made for a specific date, which then returns a list of unique Ids and timestamps of updates on that day. You can then use these Ids to retrieve stat updates from other endpoints. This allows for quick and efficient data retrieval, and will be a common concept across all integration scenarios.

See our Monitoring Data Changes guide for detail on how to efficiently leverage this feed.

Pagination

The NASCAR API does not currently make use of pagination for any endpoint. Each return will provide all data available.

Additional Integration Options

Postman Workspace

Our entire Media APIs are available on Postman. Click the link above to be taken directly to our NASCAR API collection.

Feel free to follow and/or fork any collections to receive updates.

Schema Download

Open the zip file below to access our entire NASCAR API XSD schema.

NASCAR v3 Schema

🏎️
More Questions?
Check our NASCAR API FAQ or reach out to our support team at [email protected]