Live Scores Feeds

Live scores feeds contain the state of the live competition. The time between data entry and the updated XML feed should be very small, so customers have access to updates almost immediately. Live scores feeds are arranged so that there is one file per competition. This competition file will then be updated every time there are changes. The file always contains the complete, up-to-date state of the competition. Old competition files remain on the server for two days before being automatically removed.

Live scores feeds will include Preseason (MLB, NHL and NFL), Regular Season (all leagues), Playoffs (all leagues) and All-Star (MLB, NFL, NHL and NBA).

Common Data

League Data

Item Notes
Sport Id

 

Sport Name
League Id
League Name
League Short Name

Game Data

Item Notes
Id
Start date/time
Status Scheduled, etc.
Name Custom name (optional)

Team Data

(Included for both the home and visitor teams)

Item Notes
Id
Display Name

Live Game Data

Item Description
Competition Status Status: scheduled, in-progress, complete, delay-rain, delay-other, suspended, postponed.
Competition Scope Period (1,2, 3...) inning...
Competition Scope Status Status of period/inning: in-progress, complete, delay-rain, delay-other, suspended, postponed.
Update Date Date and time of last update.

Scores

(For NBA, NCAAB, NFL, NHL)

Stat Description
Game Clock Example: 00:14:03
Score-total Total of game
Score-P1 Period 1 score
Score-P2 Period 2 score
Score-P3 Period 3 score
Score-P4 Period 4 score
Score-OT Overtimes
Score-SO Shootouts

MLB specific scores

Stat Description
Runs - total
Hits - total
Errors - total
Runs - innings 1-9
Hits - innings 1-9
Errors - innings 1-9
Runs - extra innings
Hits - extra innings
Errors - extra innings

Competition State

Baseball

Stat Description
Current Pitcher Person
Current Batter Person
Outs 0-2
Ball Count 0-3
Strike Count 0-2
Runner on First Yes|No
Runner on Second Yes|No
Runner on Third Yes|No

Football

Stat Description
Possession Home|Away
Yard Line
Down
Distance
Key Event (Home|Away) possible values: kickoff, touchdown, fieldgoal, safety, conversion, 2ptconversion
Stop in Play (Home|Away) possible values: timeout, twominutewarning, playunderreview, televisiontimeout, injuryonfield

Sample Response

 

<sport:content xmlns:sport="http://xml.sportsdirectinc.com/sport/v2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<team-sport-content>
<sport>
<id>/sport/football</id>
<name>football</name>
</sport>
<league-content>
<league>
<id>/sport/football/league:1</id>
<name>National Football League</name>
<name type="nick">NFL</name>
</league>
<competition>
<id>/sport/football/competition:46993</id>
<start-date>2015-10-05T20:30:00.000-04:00</start-date>
<result-scope>
<competition-status>complete</competition-status>
<scope type="period" num="4"/>
<scope-status>complete</scope-status>
<update-date>2015-10-05T23:21:44.000-04:00</update-date>
</result-scope>
<home-team-content>
<team>
<id>/sport/football/team:19</id>
<name>Seattle</name>
<name type="short">SEA</name>
</team>
<stat-group>
<scope type="competition"/>
<stat type="score" num="13"/>
</stat-group>
<stat-group>
<scope type="period" num="1"/>
<stat type="score" num="0"/>
</stat-group>
<stat-group>
<scope type="period" num="2"/>
<stat type="score" num="10"/>
</stat-group>
<stat-group>
<scope type="period" num="3"/>
<stat type="score" num="3"/>
</stat-group>
<stat-group>
<scope type="period" num="4"/>
<stat type="score" num="0"/>
</stat-group>
</home-team-content>
<away-team-content>
<team>
<id>/sport/football/team:1</id>
<name>Detroit</name>
<name type="short">DET</name>
</team>
<stat-group>
<scope type="competition"/>
<stat type="score" num="10"/>
</stat-group>
<stat-group>
<scope type="period" num="1"/>
<stat type="score" num="0"/>
</stat-group>
<stat-group>
<scope type="period" num="2"/>
<stat type="score" num="3"/>
</stat-group>
<stat-group>
<scope type="period" num="3"/>
<stat type="score" num="0"/>
</stat-group>
<stat-group>
<scope type="period" num="4"/>
<stat type="score" num="7"/>
</stat-group>
</away-team-content>
</competition>
</league-content>
</team-sport-content>
<head/>
</sport:content>