nascar statistics feeds - sportradar us · sportsdata nascar statistics feeds !! live race...

Updated 06.13.12

1 SPORTSDATA NASCAR STATISTICS FEEDS

NASCAR Statistics Feeds

2012 Season

Updated 06.13.12


Table of Contents

Overview ...................................................................................................................................... 3 Stats List – Event Information .................................................................................................... 4 Stats List – Driver Information ................................................................................................... 5 Stats List – Driver Race Information ......................................................................................... 6 Stats List – Driver Statistics ....................................................................................................... 7 Stats List – Team Information .................................................................................................... 8 Drivers Feed – Details ................................................................................................................. 9 Driver Standings Feed – Details .............................................................................................. 11 Live Race Leaderboard Feed – Details ................................................................................... 13 Qualifying Race Leaderboard Feed – Details ......................................................................... 17 Schedule Feed – Details ........................................................................................................... 20 Teams Feed – Details ............................................................................................................... 22

Updated 06.13.12


Overview The Gold Standard in Real-time Sports Stats SportsData’s team of data-entry experts crunch play-by-play information for packaging and delivery using new technology that results in the fastest updates in the industry. And because our clients demand depth, no statistic is too small. We are focused on:

Accuracy. From instant play-by-play to in-game clean up, official and final we maintain the highest standard in data accuracy.

Simplicity. We deliver your sports data feed to customer specifications, or in any industry-standard format; our flexibility makes your transition fast and seamless.

Speed. We offer true real-time delivery of data using highly-optimized publishing techniques.

Service. We approach every client relationship as an opportunity for a long-term partnership, and will work tirelessly for you from Day 1.

NASCAR Statistics Feeds

We package our comprehensive stats collection into six feeds, each focused on serving specific information needs.

Drivers – detailed driver information, including a set of season summary statistics

Driver Standings – provides driver level statistics including points, victories, and driver ranking

Live Race Leaderboard– detailed, near real-time race statistics per driver

Qualifying Race Leaderboard – detailed, near real-time qualifying statistics per driver

Schedule – provides the date, time, location and other event details for every race

Teams – provides information regarding the Sprint Cup teams

Updated 06.13.12


Stats List – Event Information

Stat Driver Live Qualifying Schedule Standings Team

Broadcast Network X Country X X X End Time X X X Event Name X X X Language X X Laps X X X Race Distance X X X Race Number (Week) X Race Series X X X X X X Race Status X X Season Year X Session X X X X Session Date X X X Start Time X X X Track State X Track City X Track Length X X X Track Name X Track Shape X Track Status X

Updated 06.13.12


Stats List – Driver Information


Car Number X X X X Car Owner X City of Birth X Crew Chief X Date of Birth X Driver Id X X X X First Name X X X X Last Name X X X X Name X X X X Nationality X X X X Sponsor X

Updated 06.13.12


Stats List – Driver Race Information


Bonus Points X Car Status X X Laps X X Laps Gap X Penalty Points X Pit Stops X X Position X X Race Points X Speed X X Time X X

Updated 06.13.12


Stats List – Driver Statistics


Did Not Finish X Money Won Last Race X Points X Points Behind Leader X Poles X Position Change from Last Wk X Qualifying Points X Ranking X Starts X Top 5 Finishes X Top 10 Finishes X Victories X Winnings This Season X Wins X

Updated 06.13.12


Stats List – Team Information


Crew Chief X Engine X X X X Manufacturer X X X X Name X X X X Owner X Team Id X X X X X

Updated 06.13.12


Drivers Feed – Details

This feed provides detailed driver information, including a set of season summary statistics.

Element/Attribute/Value Descriptions

File Breakdown – Drivers Feed Element Attribute Values Description

block N/A N/A Root element of feed Child Elements: param, driver

param name timestamp The time the feed is produced value yyyymmddhhmmss Year, month, day, hours, minutes, seconds name “event” Motor racing event

value

“NAS_SC” The information in the file is related to the Sprint Cup series

“NAS_NW” The information in the file is related to the Nationwide series

“NAS_CW” The information in the file is related to the Camping World Truck series

name “championship"

session “QUALI” The information in the file is related to the

qualifying race

“RACE” The information in the file is related to the main race

season_name Dynamic Sportsdata’s season name driver didx Dynamic The driver’s unique id

stn Dynamic The driver’s car number driver Dynamic The full name of the driver driver_first_name Dynamic The first name of the driver driver_last_name Dynamic The last name of the driver nat Dynamic The nationality country code driver_nationality Dynamic The driver’s nationality driver_date_of_birth Dynamic The driver’s date of birth driver_city_of_birth Dynamic The driver’s city of birth tid Dynamic The team’s unique id driver_sponsor Dynamic The driver’s sponsor driver_money_last_race Dynamic Driver’s winnings from the last race driver_starts Dynamic The number of starts for the season driver_poles Dynamic The number of poles for the season

driver_position_change Dynamic The driver’s position change from last week

driver_top5 Dynamic The number of Top 5 finishes for the season

driver_top10 Dynamic The number of Top 10 finishes for the season

driver_winnings Dynamic The driver’s winnings for the season driver_crew_chief Dynamic The driver’s crew chief driver_points_behind_leader Dynamic The driver’s points gap from the leader car_owner Dynamic The owner of the driver’s car

Updated 06.13.12


Drivers Feed - File Naming Convention Schema Syntax: http://api.sportsdatallc.org/nascar-[access_level][version]/schema/drivers-v1.0.xsd?api_key=[your_api_key] Feed Syntax: http://api.sportsdatallc.org/nascar-[access_level][version]/drivers/[nascar_series]?season_id=[year]&api_key=[your_api_key] Parameter Format Notes [access_level] = Real-Time (rt), Premium (p), Standard (s), Basic (b), Trial (t) [version] = whole number (sequential, starting with the number 1) [nascar_series] = sc (Sprint Cup), nw (Nationwide), cw (Camping World) [year] = yyyy Update Timing This feed will be updated as driver information changes. Copyright The contents of this document may not be distributed, duplicated or made public in any way in parts or as a whole without prior written consent of SportsData LLC. This does not apply to copies solely intended for internal purposes.

Updated 06.13.12


Driver Standings Feed – Details

This feed provides driver level statistics including points, victories, and driver ranking.


File Breakdown – Driver Standings Feed Element Attribute Values Description

block N/A N/A Root element of feed Child Elements: param, standings

param name timestamp The time the feed is produced value yyyymmddhhmmss Year, month, day, hours, minutes, second name “event” Motor racing event

value




name “championship”

value “driver” Indicates that the standings are driver based

standings didx Dynamic The driver’s unique id pos Dynamic The drivers race position stn Dynamic The driver’s car number driver Dynamic The full name of the driver driver_first_name Dynamic The first name of the driver driver_last_name Dynamic The last name of the driver nat Dynamic The nationality country code tid Dynamic The team’s unique id team Dynamic The team the driver’s associated with team_carbike Dynamic The car manufacturer team_engine Dynamic The engine manufacturer

points Dynamic The number of driver points accumulated at the completion of the race

victories Dynamic The number of driver victories accumulated at the completion of the reace

Updated 06.13.12


Driver Standings Feed - File Naming Convention Schema Syntax: http://api.sportsdatallc.org/nascar-[access_level][version]/schema/standings-v1.0.xsd?api_key=[your_api_key] Feed Syntax: http://api.sportsdatallc.org/nascar-[access_level][version]/standings/driver/[nascar_series]?season_id=[year]&api_key=[your_api_key] Parameter Format Notes [access_level] = Real-Time (rt), Premium (p), Standard (s), Basic (b), Trial (t) [version] = whole number (sequential, starting with the number 1) [nascar_series] = sc (Sprint Cup), nw (Nationwide), cw (Camping World) [year] = yyyy Update Timing This feed will be updated as upon completion of each race. Copyright The contents of this document may not be distributed, duplicated or made public in any way in parts or as a whole without prior written consent of SportsData LLC. This does not apply to copies solely intended for internal purposes.

Updated 06.13.12


Live Race Leaderboard Feed – Details

This feed provides detailed, near real-time race statistics per driver.


File Breakdown – Live Race Feed Element Attribute Values Description



value




name “gpno” The race number in the season value Dynamic 1-36 name session The race stage

value “QUALI” The information in the file is related to the

qualifying race


name date The date of the race value ddmmyyyy Day, month, year name start The start time of the session value hhmm Hour, minute name end The end time of the session value hhmm Hour, minute

name utc Universal coordinated time. This will be the time difference around the world compared to GMT.

value hh Hours name iso_country The country code value Dynamic 3 letter simplified country code name country Country name where the race is held value Dynamic United States name racetrack The name of the race track value Dynamic Daytona Motor Speedway, for example name track_length_miles Track length in miles value Dynamic 2.5 MI for example name laps Number of laps in the race value Dyanmic 200 for example name race_distance_miles Race distance in miles value Dynamic 500 MI for example

Updated 06.13.12


name track_status The status of the race

value

“ABORTED” The race has been aborted “CAUTION” The race is under caution “FINISHED” The race has finished “GREEN FLAG” The race is under GREEN “NOTSTARTED” The race has not started “ON TRACK” The race is in progress “RED FLAG” The race is under RED “SAFETY CAR” The safety car is on the track “SUSPENDED” The race has been suspended “YELLOW FLAG” The race is under Caution

name status_cause Additional information regarding the status of the race

value

NULL There is not additional information “ACCIDENT” There was an accident “SHORTENED” The race was shortened “TRACK CONDITIONS” Adverse track conditions are the reason “WEATHER” Weather is the reason

name lang The language of the race broadcast value Dynamic English for example

driver didx Dynamic The driver’s unique id pos Dynamic The drivers race position stn Dynamic The driver’s car number driver Dynamic The full name of the driver driver_first_name Dynamic The first name of the driver driver_last_name Dynamic The last name of the driver nat Dynamic The nationality country code tid Dynamic The team’s unique id team Dynamic The team the driver’s associated with team_carbike Dynamic The car manufacturer team_engine Dynamic The engine manufacturer laps Dynamic The number of laps completed laps_gap Dynamic The laps behind the leader laps_led Dynamic The number of laps led in the race time Dynamic The lap time for the driver speed Dynamic The lap speed for the driver

pitstops Dynamic The number of pit stops the driver has taken

status

“ACCIDENT” The driver was in an accident “DISQUALIFIED” The driver has been disqualified “ENGINE” The driver is experiencing engine trouble “GARAGE” The driver is in the garage “IN PIT” The driver is in the pits “ON TRACK” The driver is on the track “RETIRED” The driver has retired “RUNNING” The driver’s car is running

points race The number of points accumulated for

Updated 06.13.12


that race before penalty or bonus points are accounted for

Penalty The number of penalty points accumulated for the race

bonus The number of bonus points earned for the race

points The total number of points accumulated after penalty or bonus points have been accounted for

Updated 06.13.12


Live Race Leaderboard Feed - File Naming Convention Schema Syntax: http://api.sportsdatallc.org/nascar-[access_level][version]/schema/race-mr1-v1.0.xsd?api_key=[your_api_key] Feed Syntax: http://api.sportsdatallc.org/nascar-[access_level][version]/race?game_id=[race_id]&api_key=[your_api_key] Parameter Format Notes [access_level] = Real-Time (rt), Premium (p), Standard (s), Basic (b), Trial (t) [version] = whole number (sequential, starting with the number 1) [race_id] = id for the race Update Timing This feed will be updated as events occur. Copyright The contents of this document may not be distributed, duplicated or made public in any way in parts or as a whole without prior written consent of SportsData LLC. This does not apply to copies solely intended for internal purposes.

Updated 06.13.12


Qualifying Race Leaderboard Feed – Details

This feed provides detailed, near real-time qualifying statistics per driver.


File Breakdown – Qualifying Race Feed Element Attribute Values Description



value




name “gpno” The race number in the season value Dynamic 1-36 name session The race stage

value “QUALI” The information in the file is related to the

qualifying race


name date The date of the race value ddmmyyyy Day, month, year name start The start time of the session value hhmm Hour, minute name end The end time of the session value hhmm Hour, minute

name utc Universal coordinated time. This will be the time difference around the world compared to GMT.

value hh Hours name iso_country The country code value Dynamic 3 letter simplified country code name country Country name where the race is held value Dynamic United States name racetrack The name of the race track value Dynamic Daytona Motor Speedway, for example name track_length_miles Track length in miles value Dynamic 2.5 MI for example name laps Number of laps in the race value Dyanmic 200 for example name race_distance_miles Race distance in miles value Dynamic 500 MI for example

Updated 06.13.12


name track_status The status of the race

value

“ABORTED” The race has been aborted “CAUTION” The race is under caution “FINISHED” The race has finished “GREEN FLAG” The race is under GREEN “NOTSTARTED” The race has not started “ON TRACK” The race is in progress “RED FLAG” The race is under RED “SAFETY CAR” The safety car is on the track “SUSPENDED” The race has been suspended “YELLOW FLAG” The race is under Caution

name status_cause Additional information regarding the status of the race

value

NULL There is not additional information “ACCIDENT” There was an accident “SHORTENED” The race was shortened “TRACK CONDITIONS” Adverse track conditions are the reason “WEATHER” Weather is the reason

name lang The language of the race broadcast value Dynamic English for example

driver didx Dynamic The driver’s unique id pos Dynamic The drivers race position stn Dynamic The driver’s car number driver Dynamic The full name of the driver driver_first_name Dynamic The first name of the driver driver_last_name Dynamic The last name of the driver nat Dynamic The nationality country code tid Dynamic The team’s unique id team Dynamic The team the driver’s associated with team_carbike Dynamic The car manufacturer team_engine Dynamic The engine manufacturer laps Dynamic The number of laps completed time Dynamic The lap time for the driver speed Dynamic The lap speed for the driver

pitstops Dynamic The number of pit stops the driver has taken

status

“ACCIDENT” The driver was in an accident “DISQUALIFIED” The driver was disqualified “ENGINE” The driver is experiencing engine trouble “GARAGE” The driver is in the garage “IN PIT” The driver is in the pits “ON TRACK” The driver is on the track “RETIRED” The driver has retired “RUNNING” The driver’s car is running

Updated 06.13.12


Qualifying Race Leaderboard Feed - File Naming Convention Schema Syntax: http://api.sportsdatallc.org/nascar-[access_level][version]/schema/race-mr1-v1.0.xsd?api_key=[your_api_key] Feed Syntax: http://api.sportsdatallc.org/nascar-[access_level][version]/qual?game_id=[race_id]&api_key=[your_api_key] Parameter Format Notes [access_level] = Real-Time (rt), Premium (p), Standard (s), Basic (b), Trial (t) [version] = whole number (sequential, starting with the number 1) [race_id] = id for the race Update Timing This feed will be updated as events occur. Copyright The contents of this document may not be distributed, duplicated or made public in any way in parts or as a whole without prior written consent of SportsData LLC. This does not apply to copies solely intended for internal purposes.

Updated 06.13.12


Schedule Feed – Details

This feed provides date, time, location, and other event details for every race.


File Breakdown – Schedule Feed Element Attribute Values Description

block N/A N/A Root element of feed Child Elements: param, schedule

param name “event” Motor racing event

value




schedule id Dynamic The internal id for the race gpno Dynamic The race number in the season

session “QUALI” The information in the file is related to the

qualifying race


date Dynamic The official date of the session start Dynamic The start time of the race end Dynamic The end time of the race

utc Dynamic Universal coordinated time. This will be the time difference around the world compared to GMT.

iso_country Dynamic The country code country Dynamic Country name where the race is held

state Dynamic The state in which the race track is located

track_name Dynamic The name of the race track hosting the event

broadcast_network Dynamic The network broadcasting the race racetrack Dynamic The name of the event track_length_miles Dynamic Track length in miles track_shape Dynamic The shape of the track track_type Dynamic The type of race track track_city Dynamic The city in which the race track is located laps Dynamic Number of laps in the race race_distance_miles Dynamic Race distance in miles status Dynamic The status of the race

id

“1” “Everything is fine” “2” “event has been cancelled” “3” “event has to be announced” “4” “subject to circuit approval”

Updated 06.13.12


Schedule Feed - File Naming Convention Schema Syntax: http://api.sportsdatallc.org/nascar-[access_level][version]/schema/schedule-v1.0.xsd?api_key=[your_api_key] Feed Syntax: http://api.sportsdatallc.org/nascar-[access_level][version]/schedule/[nascar_series]?season_id=[year]&api_key=[your_api_key] Parameter Format Notes [access_level] = Real-Time (rt), Premium (p), Standard (s), Basic (b), Trial (t) [version] = whole number (sequential, starting with the number 1) [nascar_series] = sc (Sprint Cup), nw (Nationwide), cw (Camping World) [year] = yyyy Update Timing This feed will be updated as schedule information changes. Copyright The contents of this document may not be distributed, duplicated or made public in any way in parts or as a whole without prior written consent of SportsData LLC. This does not apply to copies solely intended for internal purposes.

Updated 06.13.12


Teams Feed – Details

This feed provides information regarding the Sprint Cup teams.


File Breakdown – Team Feed Element Attribute Values Description

block Child Elements: param, standings param name “event” Motor racing event

value




name “data” value 1 1 tid Dynamic The team’s unique id team Dynamic The team the driver’s associated with team_carbike Dynamic The car manufacturer team_engine Dynamic The engine manufacturer crew_chief Dynamic The crew chief associated with the team owner Dynamic The owner of the team

Updated 06.13.12


Teams Feed - File Naming Convention Schema Syntax: http://api.sportsdatallc.org/nascar-[access_level][version]/schema/teams-v1.0.xsd?api_key=[your_api_key] Feed Syntax: http://api.sportsdatallc.org/nascar-[access_level][version]/teams/[nascar_series]?season_id=[year]&api_key=[your_api_key] Parameter Format Notes [access_level] = Real-Time (rt), Premium (p), Standard (s), Basic (b), Trial (t) [version] = whole number (sequential, starting with the number 1) [nascar_series] = sc (Sprint Cup), nw (Nationwide), cw (Camping World) [year] = yyyy Update Timing This feed will be updated as information changes. Copyright The contents of this document may not be distributed, duplicated or made public in any way in parts or as a whole without prior written consent of SportsData LLC. This does not apply to copies solely intended for internal purposes.

nascar statistics feeds - sportradar us · sportsdata nascar statistics feeds !! live race...

Documents