The Gracenote Sports API site
On this website we present the complete Gracenote API. All API methods that have
been released are available here. The method calls are fully functional, with operational,
live data. The only limitation is that the data is confined to just a few sports
events. Please check out the tab pages to get a list of available methods per sport.
The method calls are secured using basic authentication. To use them, you will need
to have a key.
A key will be supplied to customers that have a contract with Gracenote Sports. If you are a client you can request a key by sending an e-mail to our Operations department at sportsoperations@gracenote.com. If you are interested in the costs and terms of use please contact our Sales department at sportssales@gracenote.com.
Languagecode determines the language of the data:
1 = dutch
2 = english
4 = french
8 = german
16 = spanish
32 = italian
64 = portuguese
128 = norwegian
256 = swedish
1024 = danish
262144 = russian
Football:
Default: today
Format: yyyymmdd
Examples: 20110731
Unique ID for a specific Sport.
For Example:
Hockey: 108
Rugby Union: 219
Unique ID for a specific Competition.
For Example:
Premier League: 52
Bundesliga: 56
Roland Garros: 14768
Unique ID to describe the type of multi-sports event.
1 = Olympic Summer Games
2 = Olympic Winter Games
6 = Commonwealth Games
9 = Asian Games
12 = Pan American Games
21 = Paralympic Summer Games
22 = Paralympic Winter Games
25 = European Games
Unique ID for specific Season. Value can be retrieved from the GetEditionList
Formula 1:
EventPhaseID, which is unique ID for specific GP. Value can be retrieved from the
GetGPList method
Tennis:
Retrieved from GetEditionList, default all
Teamsports:
Retrieved from GetEditionList
Football:
The PhaseID for which the table is requested. Use GetPhaseList to get the correct
phaseid.
Cycling:
Can be obtained using the GetRaceList method
Speed Skating:
Can be obtained using the GetPhaseList(results) or GetRankingList(rankings) method
Teamsports:
Can be obtained using the GetPhaseList
Football:
Unique ID for a specific Football Match. Value can be retrieved from the GetMatchList_Edition
method
Teamsports:
Unique ID for a specific Teamsports Match. Value can be retrieved from the GetMatchList_Eventphase
method
Tennis:
Unique ID for a specific Tennis Match. Value can be retrieved from the GetMatchList_EventPhase
method
Football:
Unique ID for a specific Football team. Value can be retrieved from the GetTeamList method
Teamsports:
Unique ID for a specific Teamsports team. Value can be retrieved from the GetTeamList_EventPhase method
Football:
Unique ID for specific player. Value can be retrieved from the GetSquad method
Tennis:
Unique ID for specific player. Value can be retrieved from the GetMatchList_EventPhase method
Summer/Winter Games:
Unique ID for specific NOC (National Olympic Committee).
Cycling:
Unique ID for a specific (stage/general/point/mountain/etc) Classification. Value
can be retrieved from GetRaceList or GetStageList
Football:
Specifies the type of the Person's career
Types: league, cup, internationalclub, international
Tennis:
Specifies the type of Tennis Edition
Types: ATP, WTA, GS (Grand Slam)
Golf:
Specifies the type of a ranking
Types: worldRanking,
ryderCupUS,
ryderCupEuro,
presidentsCupUS,
presidentsCupInternational,
fedexCup,
pgaMoney
Formula 1:
Specifies the type of Formula 1 ranking
Types: constructor, driver
Cycling:
Specifies the type of Cycling ranking
Types: rider, team, nation
Tennis:
Specifies the type of Tennis ranking
Types: ATP, WTA
Football:
Specifies the type of Football ranking
Types: ECI
Cycling:
Types: men (=default), women
Games:
Types: men, women.
If not passed, value is 'all'.
Cycling:
Type of Cyclingclass
Types: elite(=default), juniors, amateurs, youth, under23
Summer/Winter Games:
Specifies the type of schedule:
- all (requires date and sportId to be specified)
- finals
- important (determined by Gracenote; phases with more than 5 subphases are grouped into 1)
Football:
Type of Matchround
Types: day, week
Football:
n_WeekId is a numeric representation of the date of the first day of the match week, which is always on Tuesday.
Example: 11 March 2014 is represented as 20140311.
Football:
Filter on cards
Types: yellow, red
Football:
HeadToHeadType determines which matches are returned in the HeadToHead methods:
2 = all matches
Unique ID for specific Nationality (contact Gracenote Sports for specific values).
Golf:
Specifies a specific Golf tour.
Types: pga,
european,
lpga
Editorial Facts and Figures:
1 = Preview
2 = Review
Frequently Asked Questions (FAQ)
How to refresh my data?
Because the API is a pull based webservice, clients have to request the methods often to keep the data up to date.
It is impossible to know when data is changed, so this can result in a lot of unnecessary requests and traffic.
To solve this problem, a specific service method is developed that makes it able to maintain the data and can be used in the backoffice of the client: GetAPICallRefresh
This call returns methods that are changed since a specific timestamp. This timestamp is a parameter of the GetAPICallRefresh.
Below is an overview per module of the methods that are currently available in GetAPICallRefresh:
| Football |
| GetEditionInfo |
| GetEditionList |
| GetEditionList_Competition |
| GetEditionPersonStat |
| GetEditionTeamStatList |
| GetHeadToHeadMatchList |
| GetHeadToHeadSummary |
| GetMatchActionList_All |
| GetMatchActionList_Basic |
| GetMatchActionList_Card |
| GetMatchActionList_Goal |
| GetMatchActionPlayByPlay |
| GetMatchDayList |
| GetMatchInfo |
| GetMatchLineup |
| GetMatchList_Edition |
| GetMatchList_Phase |
| GetMatchLiveList_Date |
| GetMatchLiveList_Week |
| GetMatchPersonStat |
| GetMatchPersonStat_Extended |
| GetMatchRoundList |
| GetMatchTeamStatList |
| GetMatchTeamStatList_Extended |
| GetNationalTeamMatchList |
| GetPersonCareer |
| GetPersonInfo |
| GetPersonMatchList_Edition |
| GetPhaseList |
| GetSquad |
| GetStat15MinTeamList_Edition |
| GetTable |
| GetTableHomeAway |
| GetTableLive |
| GetTeamFormList |
| GetTeamInfo |
| GetTeamList |
| GetTeamMatchList_Season |
| GetTopCardList |
| GetTopScorerLiveList |
| GetTopStatPersonList_Edition |
| GetTopStatTeamList_Edition |
| Get7DayMatchList |
| |
| Tennis |
| GetEditionInfo |
| GetEditionList |
| GetMatchList_EventPhase |
| GetMatchLiveInfo |
| GetMatchLiveList_Date |
| GetPersonCompetitionResultList |
| GetPersonFinalsResultList |
| GetPersonInfo |
| GetPersonSeasonResultList |
| GetPhaseList_EventPhase |
| GetRanking |
| GetResult |
| GetTable |
| GetTeamMatchLiveList |
|
| Games_v2 |
| GetDateList |
| GetEventPhaseList_Event |
| GetEventPhaseList_Season |
| GetEventRecordList |
| GetMatchActionList_Basic |
| GetMatchActionList_Goal |
| GetMatchInfo |
| GetMatchLineup |
| GetMatchList_EventPhase |
| GetMatchResult_Extended |
| GetMatchTeamStatList |
| GetMedalList_Season |
| GetMedalTable_AllTime |
| GetMedalTable_Season |
| GetMedalTableNOCDetail_Season |
| GetMedalTableSportDetail_Season |
| GetNavigationPhaseList |
| GetNOCList |
| GetNOCParticipationList_Date |
| GetParticipantList_Phase |
| GetPersonInfo |
| GetPersonList_NOC |
| GetPersonList_Sport |
| GetPersonMajorResultList |
| GetPhaseInfo |
| GetPhaseIntermediateList |
| GetPhaseList |
| GetRecordList |
| GetRecordList_Person |
| GetResult |
| GetResult_Extended |
| GetResultAfter |
| GetScheduleDate |
| GetScheduleMatrix |
| GetScheduleMatrix_Extended |
| GetScheduleNOC |
| GetSchedulePerson |
| GetScheduleSport |
| GetScheduleTeam |
| GetSeasonList |
| GetSportList |
| GetSquad |
| GetTable |
|
| Formula1 |
| GetGPActionList |
| GetGPLapMatrix |
| GetGPList_Competition |
| GetGPList |
| GetGPParticipantList |
| GetGPPhaseInfo |
| GetGPResult |
| GetGPResultLive |
| GetGPWeekend |
| GetParticipantList |
| GetPersonGPSummary |
| GetPersonInfo |
| GetRanking |
| GetTeamGPSummary |
| GetTeamInfo |
| |
| Cycling |
| GetGroupMemberList |
| GetParticipantList |
| GetPersonInfo |
| GetPersonRaceResultList |
| GetPersonStageResultList |
| GetRaceInfo |
| GetRaceIntermediateList |
| GetRaceList |
| GetRanking |
| GetResult |
| GetStageList |
| |
| SpeedSkating |
| GetPhaseInfo |
| GetPhaseList |
| GetRanking |
| GetRankingPhaseList |
| GetResult |
| |
| Biography |
| GetCountryList |
| GetPersonBioPropertyList |
| GetPersonInfo |
| GetPersonList |
| GetPersonResultList |
| GetSportList |
| |
| Editorial |
| GetFactsAndFigures_Date |
| GetFactsAndFigures_Match |
| GetFactsAndFigures_Week |
| GetFlashList_Phase |
| GetNewsList |
|
| TimeJudgeSports |
| GetEditionList |
| GetGolfCourseList |
| GetGolfLeaderboard |
| GetGolfPlayoffResult |
| GetGolfSchedule |
| GetParticipantList_Phase |
| GetPersonInfo |
| GetPhaseInfo |
| GetPhaseIntermediateList |
| GetPhaseList_Edition |
| GetPhaseList_Phase |
| GetRanking |
| GetRankingPhaseList_Edition |
| GetResult |
| GetResultAfter |
| GetSportList |
| |
| TeamSports |
| GetEditionList_Competition |
| GetEditionList |
| GetHockeyMatchStatPersonList |
| GetHockeyPhaseStatPersonList |
| GetHockeyPhaseStatTeamList |
| GetMatchActionList_Basic |
| GetMatchActionList_Extended |
| GetMatchActionList_Goal |
| GetMatchLineup |
| GetMatchList_EventPhase |
| GetMatchLiveInfo |
| GetMatchLiveList_Date |
| GetMatchPeriodLiveList |
| GetMatchTeamStatList |
| GetPersonInfo |
| GetPhaseInfo |
| GetPhaseList |
| GetRanking |
| GetRankingEditionList |
| GetResult_EventPhase |
| GetRugbyUnionPhaseStatPersonList |
| GetSportList |
| GetSquad |
| GetTable |
| GetTeamList_EventPhase |
| |
| Head2HeadSports |
| GetEditionList |
| GetEventPhaseList |
| GetMatchList_EventPhase |
| GetMatchLiveInfo |
| GetMatchLiveList_Date |
| GetParticipantList_EventPhase |
| GetPhaseInfo |
| GetPhaseList |
| GetResult_EventPhase |
| GetSportList |
| GetTable |
|
Returns all calls (including module, method and parameters) of which the data have been updated since a specific date and time.
Return all calls (including module, method and parameters) of a specific module of which the data have been updated since a specific date and time.
Content / Description of fields
General (all modules):
Cycling:
Football:
Formula1:
Tennis:
Team Sports:
Winter Games:
Describes the weather condition:
0 = Unknown
1 = Dry
2 = Clear/Sunny
3 = Overcast
4 = Rain
5 = Snow
6 = Fog
7 = Hail
8 = Extreme
Describes the wind direction:
0 = Unknown
1 = North
2 = East
3 = North East
4 = South
6 = South East
8 = West
9 = North West
12 = South West
Code to describe the status of a race. Any other code than listed below can be ignored. The codes are stored bitwise which means that a code can be the sum of multiple codes. E.g. 384 (Result is official) actually means 128 (finished)+256 (official). Since 256 (official) cannot exist on its own it is not listed below.
0 = Not started
2 = Starting List is available
8 = In progress
16 = Suspended: temporarily stopped (e.g due to weather)
128 = Finished
384 = Result is official
4096 = Rescheduled for another date
8192 = Postponed: will not take place on the scheduled date, and might either be rescheduled or cancelled eventually.
12288 = Postponed and Rescheduled for another date
16384 = Delayed
32768 = Abandoned: stopped before regular end
36864 = Abandoned and Rescheduled for another date
262144 = Cancelled
ID to describe the type of race
10635 = Road race
10636 = Individual time trial
10637 = Team time trial
10638 = Duo time trial
12146 = Individual (Stage race)
Type to describe the profile of a race or stage.
1 = Flat
2 = Semi-mountain
3 = Mountain
Type to describe the type of finish of a race or stage.
1 = Flat finish
2 = Semi-mountain finish
3 = Mountain finish
Type to describe the type of finish of a race or stage.
1 = Flat finish
2 = Semi-mountain finish
3 = Mountain finish
Boolean which is true if the race or stage is covered live, including groups.
Boolean which is true if the intermediates passages (e.g. mountain passages) are covered live.
Number to describe the type of action
1 = Goals
2 = Penalty shootout
3 = Cards
4 = Line-up
5 = Substitutions
6 = Substitutes not used
7 = Players not selected / suspended
8 = Coaches
9 = Officials
10 = Missed penalties
11 = Captain
12 = Free kick / Foul / Corner / Offside / Shot / Save
13 = Possession
14 = Temporarily out
15 = Other
16 = Time
These fields describe an action in more detail than n_ActionSet. The document API_Football_ActionCodes.xls contains a list of all actioncodes. For most actions it is sufficient to just look at n_ActionCode to uniquely identify it.
Only for some n_ActionCodes you also have to take n_ActionCode2 and n_ActionCode3 into account. When n_ActionCodes 2 and/or 3 are irrelevant, they have NULL values in the sheet.
The Remark column in the sheet is not in the API data, it is just to clearify to distinction between Actions that have the same c_Action.
Describes the type of competition
1 = Domestic League (e.g. French Ligue 1)
2 = Domestic Cup (e.g. English FA Cup)
3 = International Club competition (e.g. Champions League)
4 = International Country competition (e.g. FIFA World Cup)
Unique number to describe the function of a person in a match.
1 = Keeper
2 = Defender
4 = Midfielder
8 = Forward
16 = Coach
64 = Referee
128 = Linesman
131072 = Suspended
1073741824 = 4th Official
Football - n_FunctionCode
can contain the same values as n_FunctionType but n_FunctionCode can also contain multiple codes (e.g. 20 = Midfielder + Trainer)
Whether the lineup is provisional or official can be determined from these fields in GetMatchInfo:
When the lineup has become official, b_LineupProvisional will be "false" and b_LineUpOfficial will have become "true"
Code that determines the status a match is in.
2 = Line-up
4 = Not Started
6 = Combination of 2 Line-up and 4 Not Started
8 = In Progress
16 = Interval
32 = Suspended
128 = Finished
192 = Unofficial result
256 = No Live Updates (ISS Internal code)
512 = Abandoned
1024 = Postponed
2048 = Delayed
If a match is stopped temporarily, n_MatchStatusCode is set to 32 (=Suspended).
If it becomes clear that the match, after being suspended, will not be restarted on the same day, n_MatchStatusCode is set to 512 (=Abandoned).
Unique number to describe the period the match is currently in.
1 = Not started
2 = 1st Half
3 = Halftime
4 = 2nd Half
5 = 90 mins
6 = 1st Extra Time
7 = 105 mins
8 = 2nd Extra Time
9 = 120 mins
10 = Penalty Shootout
11 = End
This codes describe the where a rank qualifies for (n_RankCode), what the least is where a team in a certain rank can qualify for (n_MinRankCode) or what the best is where a team in a certain rank can qualify for (n_MinRankCode).
2 = Championship play-off
4 = Relegation play-off
8 = Relegation
16 = Promotion
32 = Promotion play-off
64 = Champions League (main tournament) / EC I
128 = Champions League preliminary round
256 = Europa League preliminary round
512 = Europa League depending on domestic cup
1024 = Next round
2048 = Play-off
4096 = Final tournament
8192 = Champions League play-off
16384 = Europa League play-off
131072 = Copa Libertadores
262144 = Copa Sudamericana
524288 = Champions
1048576 = Europa League (main tournament)
2097152 = AFC Champions League
4194304 = AFC Cup
8388608 = CAF Champions League
16777216 = CAF Confederation Cup
33554432 = CONCACAF Champions League
67108864 = OFC Champions League
536870912 = Europa League through domestic cup
1073741824 = Period champion
If the new match date is known, after being abandoned, the Boolean b_RescheduledToBeResumed is set to true, and n_MatchStatusCode is set to 0.
Is part of the GetMatchListEdition method. Can be used to determine the matches in a particular round.
This column contains the roundnr within a phase and will be filled in phases like:
- regular phases in domestic leagues
- group phases in international competitions (e.g. WCh, ECh)
However, if one wishes to determine which matches are played in a particular week, it is better to use the GetMatchDayList call. That one shows the dates per weekly range. One might miss out on a match in case the match is played not in its regular week because of rescheduling.
This column describes the level or data depth of the live coverage of a match. Below is a table with the possible values:
90 = Live with all actions (including passes and duels)
70 = Live with extra actions (goal scorers, assists, yellow and red cards, substitutions, missed penalties, shots, saves, fouls, offsides, corners, free kicks)
61 = Live with main actions including assists
50 = Live with main actions (goal scorers, yellow and red cards, substitutions, missed penalties)
45 = Live with goal scorers, red cards and line-up.
40 = Live with goal scorers and red cards
30 = Live with goal scorers.
10 = Live only scores
This column describes properties of a match. Below is a table with the possible values. The values are stored bitwise which means that a value can be the sum of multiple values:
0 = No properties
1 = Home win
2 = Away win
4 = Postponed
8 = Regular
16 = Sudden death
32 = After extra time
64 = After penalty shootout
128 = Withdrawn
256 = Toss
512 = Unofficial match - home
1024 = Unofficial match - away
2048 = Abandoned
4096 = Awarded
8192 = Date unknown
16384 = Decider
32768 = Silver goal
65536 = Neutral ground
131072 = Do not count in edition
262144 = Do not count in phase
524288 = Do not count in phase - home
1048576 = Do not count in phase - away
2097152 = Rescheduled
4194304 = Time unknown
8388608 = Special Interest
16777216 = Known reason for delay of delivery
33554432 = All graphical positions correct
67108864 = Line-up provisional
134217728 = Do not count stats in edition
268435456 = Do not count stats in phase
536870912 = Provisional line-up required
1073741824 = Graphical positions required
This column describes for knockout matches the type and result of aggregate. Below is a table with the possible values, including the possible combinations:
0 = No aggregate
1 = Single Match Knock out
2 = First Leg - Double Knock out
4 = Second Leg - Double Knock out
8 = HomeTeam Qualified
9(1+8) = Single Match Knock out, HomeTeam Qualified
10(2+8)= First Leg - Double Knock out, HomeTeam Qualified
12(4+8) = Second Leg - Double Knock out, HomeTeam Qualified
16 = AwayTeam Qualified
17(1+16) = Single Match Knock out, AwayTeam Qualified
18(2+16) = First Leg - Double Knock out, AwayTeam Qualified
20(4+16) = Second Leg - Double Knock out, AwayTeam Qualified
This column describes the period that a match is in. Below is a table with the possible values:
0 = No period
1 = Start
2 = 1st half
4 = Half time
8 = 2nd half
16 = 90 minutes (int.)
32 = 1st extra time
64 = 2nd extra time
128 = Penalty shootout
256 = During
512 = End
544 = 1st extra time (s.d.)
576 = 2nd extra time (end/s.d.)
768 = Live
1024 = 105 minutes (int.)
2048 = Before start
4096 = After end
8192 = 120 minutes
Describes the current flag during a F1 race:
0 = No flag
1 = Yellow
2 = Green
3 = Red
4 = Finish
Describes the status of the safety car during a F1 race:
0 = No status
1 = Safety car standby
2 = Safety car on track
Code to describe the status of a race. Codes can be combined.
0 = Not specified
1 = Scheduled
2 = Starting list
4 = About to start
8 = In progress
128 = Finished
384 (128+256 combined) = Finished and result is official
4096 = Rescheduled for another date
8192 = Postponed (will not take place on the scheduled date)
32768 = Abandoned (stopped before regular end and will not be resumed on the same day)
262144 = Cancelled (will not take place)
Describes the track condition during a F1 race, qualifying session or free practice session:
0 = Unknown
1 = Track dry
2 = Track light wet
3 = Track wet
4 = Track very wet
c_ResultSuffix can contain the following abbreviations:
DNS = Did not start
DSQ = Disqualified
DNF = Did not finish
Pen = Penalty given
Inv. = Under investigation
On = On track
Off = Off track
NC = Not Classified
DNQ = Did not qualify
q = Qualified on time
Q = Qualified
They can however appear in combination with each other. Currently we have these combinations:
DNF/Inv.
DNF/NC
DNF/Off
DNF/On
DNF/Pen
DNQ/q
DNS/NC
DSQ/NC
DSQ/On
DSQ/q
Inv./Pen
Off/Q
Off/q
n_ActionType can have the following values:
n_ActionType = c_ActionType
1 = Change race status
2 = Change race condition
8 = Abandon
16 = Accident
64 = Virtual Leader
512 = Record set for race
4096 = Under investigation
16384 = Penalty
65536 = Offensive/Defensive
262144 = Technical Maintenance
524288 = Technical Failure
16777216 = Additional Race information
n_ActionTypeSpecific gives more detail on n_ActionType. The combination of n_ActionType and n_ActionTypeSpecific can have these values:
n_ActionType and n_ActionTypeSpecific = c_ActionTypeSpecific
1 and 1 = Green Flag
1 and 2 = Yellow Flag
1 and 8 = Safety Car Stand-by
1 and 16 = Safety Car on Track
1 and 64 = Red Flag
1 and 128 = Winner flagged
1 and 256 = All flagged
2 and 1 = Weather change: dry
2 and 2 = Weather change: sunny
2 and 4 = Weather change: overcast
2 and 8 = Weather change: rain
2 and 16 = Weather change: snow
2 and 32 = Weather change: fog
2 and 64 = Track condition change: dry
2 and 128 = Track condition change: light wet
2 and 256 = Track condition change: wet
2 and 512 = Track condition change: very wet
8 and 1 = Abandon - No Fuel
8 and 2 = Abandon - Technical
8 and 4 = Abandon - Crash
8 and 262144 = Undo Abandon
16 and 1 = Spin off
16 and 2 = Two car crash
16 and 4 = Three or more car crash
64 and 0 = Leader in Season standing
512 and 1 = Fastest Lap
4096 and 1 = Cause investigation
4096 and 2 = Clear investigation
16384 and 1 = Stop & Go
16384 and 2 = Drive through
16384 and 4 = Time Penalty
65536 and 1 = Overtakes
65536 and 2 = Is overtaken
262144 and 1 = Pit in
262144 and 2 = Pit out (unspecified)
262144 and 6 = Pit out (regular)
262144 and 10 = Pit out (penalty)
262144 and 32 = Tyre - Slicks
262144 and 32 = Tyre - Intermediate
262144 and 64 = Tyre - Rain
524288 and 1 = General
524288 and 2 = Engine
524288 and 4 = Not starting engine
16777216 and 1 = Parcours short cut
16777216 and 4 = Start from Pit
c_ActionReason can haven the following values:
n_ActionReasonID = c_ActionReason
104002 = Engine blow
104004 = Spin Off
104010 = Crossing line at pitstreet
104011 = Speeding in pitstreet
104012 = Missing Chicane
104015 = Brakes
104016 = Clutch
104017 = Crash
104018 = Electronics
104019 = Engine
104020 = Gearbox
104021 = Hydraulics
104022 = Mechanical Problem
104024 = Suspension
104025 = Transmission
104026 = New Tyres
104027 = Fuel
104028 = Chassis
104029 = New Tyres + Fuel
104030 = New Tyres + Chassis
104031 = Chassis + Fuel
104032 = New Tyres + Fuel + Chassis
104033 = Unspecified
104034 = Stop & Go
104035 = Drive Thru
104036 = Other
104037 = Ignoring blue flags
104040 = Out of Fuel
104041 = Investigation Cleared
104042 = Avoidable collission
c_AbandonReason can have the following values:
n_AbandonReasonID = c_AbandonReason
104002 = Engine blow
104004 = Spin Off
104015 = Brakes
104017 = Crash
104018 = Electronics
104019 = Engine
104020 = Gearbox
104021 = Hydraulics
104022 = Mechanical Problem
104024 = Suspension
Contains qualifying information:
0 = No information
1 = Qualified for next session
2 = Qualified for race (applicable for drivers who do not qualify for next session or when it concerns the last session)
3 = Did not qualify for race (available in overall qualifying phase)
Describes the type of surface:
0 = Unknown
1 = Hardcourt
2 = Clay
3 = Carpet
4 = Grass
Unique number to describe the function of a person in a squad.
0 = Player (function undefined)
1 = Keeper
2 = Defender
4 = Midfielder
8 = Forward
16 = Coach
NULL = undefined
Describes the type of a period:
1 = Regular period
2 = Overtime
3 = Shootout
9 = Basketball: End regular time,
Curling: End 10th End,
Other sports: Interval (inbetween periods)
10 = Ice Hockey: End overtime
Describes the type of a period:
1 = Regular period
2 = Overtime
3 = Shootout
9 = Interval (inbetween periods)
How to calculate the current minute of a Football match
The current minute of a football match can be calculated using several fields in GetMatchLiveList_Date, GetMatchLiveList_Week or GetMatchInfo.
The fields to be used are d_CurrentPeriodStartTime, n_CurrentPeriodTimePlayed, n_CurrentPeriodTimeNotPlayed, n_Periodsort, b_Suspended, b_Abandoned and n_MatchStatusCode.
In a normal situation the current minute is the difference between d_CurrentPeriodStartTime and the current time (in CET) added to the minutes of the previous periods. If a match is suspended or abandoned we fill n_CurrentPeriodTimePlayed with the time played in the current period until the moment the match was suspended or abandoned. If a match has been resumed and is in the same period as the match was suspended or abandoned, then n_CurrentPeriodTimeNotPlayed is filled with the amount of time there was not played.
This results in the following pseudo code:
CurrentTime=
If Match is suspended or abandoned (either b_Suspended=True or b_Abandoned=True, or bits 32 or 512 in n_MatchStatusCode are 'on') Then
(n_CurrentPeriodTimePlayed/60000)
Else
( (difference in ms between d_CurrentPeriodStartTime and current date/time) minus (time not played in current period:n_CurrentPeriodTimeNotPlayed) / 60000 )
End
+ minutes of previous period(s):
1 -- 1st half (PeriodSort=2)
46 -- 2nd half (PeriodSort=4)
91 -- 1st extra time (PeriodSort=6)
106 -- 2nd extra time (PeriodSort=8)
Returns all tournaments in a specific season, which are called editions. Editions can be filtered on editiontypes ATP, WTA or GS (=Grand Slams)
Returns all matches from an event of a specific tournament, which is called an eventphase. Eventphases are men's singles, women's singles, men's doubles, women's doubles or mixed doubles. The eventphaseId can be fetched from GetEditionList.
This method does not include live scores.
Returns matches of a specific date and event.
This method does include live scores.
Returns info and result of a match and does include live scores.
Return matches for team competitions like Davis Cup and Fed Cup. Does include live scores.
Returns singles and/or doubles matches of a team matchup in competitions like Davis Cup and Fed Cup. Does include live scores.
Returns all phases (rounds) from an event of a specific tournament. Eventphases are men's singles, women's singles, men's doubles, women's doubles or mixed doubles. The eventphaseId can be fetched from GetEditionList. The id of a phase can be used to get the table of a group phase, e.g. of the WTA Finals
Returns the table of a group phase.
Returns the participants or the final result of a tournament. Before and during a tournament it will return the participants ordered by seeding. After the tournament it will return the results ordered by final rank.
Returns the current ATP or WTA ranking
Returns general info of a person
Returns all Finals of a player
Returns tournament results of a player in a specific season. It includes the latest round (phase) which a player has reached per tournament.
Returns historical results of a player in a tournament, which is called competition. The method includes the latest round (phase) which a has player reached each year. CompetitionId can be fetched from GetEditionList
Returns the races of a season
Returns the stages of a race
Returns global (live) data of a Race or Stage.
Returns full results of a classification.
Returns UCI World Ranking
Returns list of Participants of a Race
Returns riders in breakaway groups during race. After a race it returns the top
3.
Returns list of intermediates of a race or stage. An intermediate can be a points (sprint) intermediate, a mountain passage or a timetrial intermediate. n_ClassificationID can be passed to GetResult to get the result of the intermediate.
Persons
Returns general info of a cyclist (personId)
Returns results history of a cyclist (personId) in a race (competitionId). For one day races it contains only the final result of all editions. For multiple stage races it contains the following (final) classifications: stage, general, points, mountain and youth (if available). In addition it contains the number of stage wins, stage top 10 finishes and leader jerseys.
Returns results of a cyclist (personId) in a specific edition of a multiple stage race (phaseId). It contains per stage the rank and result of the following classifications: stage, general, points, mountain and youth (if available).
Returns results of a cyclist person in a season
Returns wins of a single person.
Returns all relevant competitions in a season
Returns all phases in a particular edition.
EditionId can be retrieved using GetEditionList
Returns the result of a particular phase.
PhaseId can be retrieved using GetPhaseList
|
UriTemplate
|
|
http://demo.api.infostradasports.com/svc/SpeedSkating.svc/Xml/GetResult?phaseid={phaseid}&languageCode={languagecode}
|
|
Parameters:
|
Languagecode
PhaseId
|
|
JSON sample call
|
World Cup Berlin, 1500m, Women, 2011-2012:
http://demo.api.infostradasports.com/svc/SpeedSkating.svc/json/GetResult?phaseid=697807&languageCode=2
World Cup Hamar, Pursuit, Men, 2011-2012:
http://demo.api.infostradasports.com/svc/SpeedSkating.svc/json/GetResult?phaseid=697699&languageCode=2
European Championship Allround, 5000m, Men, 2012:
http://demo.api.infostradasports.com/svc/SpeedSkating.svc/json/GetResult?phaseid=698014&languageCode=2
World Championship Sprint, Overall result (current), Men, 2012:
http://demo.api.infostradasports.com/svc/SpeedSkating.svc/json/GetResult?phaseid=698028&languageCode=2
|
|
XML sample call
|
World Cup Berlin, 1500m, Women, 2011-2012:
http://demo.api.infostradasports.com/svc/SpeedSkating.svc/Xml/GetResult?phaseid=697807&languageCode=2
World Cup Hamar, Pursuit, Men, 2011-2012:
http://demo.api.infostradasports.com/svc/SpeedSkating.svc/Xml/GetResult?phaseid=697699&languageCode=2
European Championship Allround, 5000m, Men, 2012:
http://demo.api.infostradasports.com/svc/SpeedSkating.svc/Xml/GetResult?phaseid=698014&languageCode=2
World Championship Sprint, Overall result (current), Men, 2012:
http://demo.api.infostradasports.com/svc/SpeedSkating.svc/Xml/GetResult?phaseid=698028&languageCode=2
|
Returns the list of World Cup rankings in a season.
Returns the general ranking of a phase from GetRankingPhaseList.
Returns some general info of a phase. No results.
|
UriTemplate
|
|
http://demo.api.infostradasports.com/svc/SpeedSkating.svc/xml/GetPhaseInfo?phaseid={phaseid}&languageCode={languagecode}
|
|
Parameters:
|
Languagecode
phaseid
|
|
JSON sample call
|
World Cup Astana, 1500m, Women, 2011-2012:
http://demo.api.infostradasports.com/svc/SpeedSkating.svc/json/GetPhaseInfo?phaseid=697608&languageCode=2
World Championship Single Distances, Pursuit, Men, 2013:
http://demo.api.infostradasports.com/svc/SpeedSkating.svc/json/GetPhaseInfo?phaseid=802485&languageCode=2
|
|
XML sample call
|
World Cup Astana, 1500m, Women, 2011-2012:
http://demo.api.infostradasports.com/svc/SpeedSkating.svc/xml/GetPhaseInfo?phaseid=697608&languageCode=2
World Championship Single Distances, Pursuit, Men, 2013:
http://demo.api.infostradasports.com/svc/SpeedSkating.svc/xml/GetPhaseInfo?phaseid=802485&languageCode=2
|
Returns a list with all sports which are configured for your account.
Returns all current editions for a specific sport. Every edition contains the eventPhaseIds for the Men's and/or Women's event.
Returns a list of historical editions of a competition. Contains a men's and women's eventPhaseId to get the table or the matchlist of an edition.
Returns all phases from an EventPhase. EventPhaseID can be retrieved using GetEditionList
|
UriTemplate
|
|
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetPhaseList?sportId={sportId}&eventPhaseId={eventPhaseId}&languageCode={languageCode}
|
|
Parameters:
|
SportID
EventPhaseId
LanguageCode
|
|
JSON sample call
|
Handball - Champions League, Women, 2012/2013:
http://demo.api.infostradasports.com/svc/TeamSports.svc/json/GetPhaseList?sportId=125&eventPhaseId=65926&languageCode=2
Hockey - Champions Trophy, Men, 2012:
http://demo.api.infostradasports.com/svc/TeamSports.svc/json/GetPhaseList?sportId=108&eventPhaseId=67129&languageCode=2
Hockey - Hoofdklasse, Men, 2012/2013:
http://demo.api.infostradasports.com/svc/TeamSports.svc/json/GetPhaseList?sportId=108&eventPhaseId=66224&languageCode=1
Ice hockey - NHL, 2012/2013:
http://demo.api.infostradasports.com/svc/TeamSports.svc/json/GetPhaseList?sportId=113&eventPhaseId=66554&languageCode=2
Rugby Union - World Cup, Men, 2011:
http://demo.api.infostradasports.com/svc/TeamSports.svc/json/GetPhaseList?sportId=219&eventPhaseId=42883&languageCode=2
|
|
XML sample call
|
Handball - Champions League, Women, 2012/2013:
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetPhaseList?sportId=125&eventPhaseId=65926&languageCode=2
Hockey - Champions Trophy, Men, 2012:
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetPhaseList?sportId=108&eventPhaseId=67129&languageCode=2
Hockey - Hoofdklasse, Men, 2012/2013:
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetPhaseList?sportId=108&eventPhaseId=66224&languageCode=1
Ice Hockey - NHL, 2012/2013:
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetPhaseList?sportId=113&eventPhaseId=66554&languageCode=2
Rugby Union - World Cup, Men, 2011:
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetPhaseList?sportId=219&eventPhaseId=42883&languageCode=2
|
Returns general info for a phase.
|
UriTemplate
|
|
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetPhaseInfo?sportId={sportId}&phaseId={phaseId}&languageCode={languageCode}
|
|
Parameters:
|
SportID
PhaseId
LanguageCode
|
|
JSON sample call
|
Ice hockey - NHL, 2015/2016, Play-offs, Semifinal, Pittsburgh Penguins,Tampa Bay Lightning:
http://demo.api.infostradasports.com/svc/TeamSports.svc/json/GetPhaseInfo?sportId=113&phaseId=133516&languageCode=2
|
|
XML sample call
|
Ice hockey - NHL, 2015/2016, Play-offs, Semifinal, Pittsburgh Penguins,Tampa Bay Lightning:
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetPhase?sportId=113&phaseId=133516&languageCode=2
|
Returns the table (ranking) of a phase. PhaseId can be retrieved using GetPhaseList
|
UriTemplate
|
|
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetTable?sportId={sportId}&phaseId={phaseId}&languageCode={languageCode}
|
|
Parameters:
|
SportID
PhaseId
LanguageCode
|
|
JSON sample call
|
Basketball - NBA, Men, 2015/2016, Play-offs, Conference final, Cleveland-Toronto:
http://demo.api.infostradasports.com/svc/TeamSports.svc/json/GetTable?sportId=107&phaseId=134379&languageCode=2
Hockey - Champions Trophy, Women, 2012, 1st Round Pool A:
http://demo.api.infostradasports.com/svc/TeamSports.svc/json/GetTable?sportId=108&phaseId=62717&languageCode=2
Ice Hockey - NHL, 2012/2013, Eastern Conference:
http://demo.api.infostradasports.com/svc/TeamSports.svc/json/GetTable?sportId=113&phaseId=66557&languageCode=2
Rugby Union - World Cup, Men, 2011, 1st Round Pool C:
http://demo.api.infostradasports.com/svc/TeamSports.svc/json/GetTable?sportId=219&phaseId=42891&languageCode=2
|
|
XML sample call
|
Basketball - NBA, Men, 2015/2016, Play-offs, Conference final, Cleveland-Toronto:
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetTable?sportId=107&phaseId=134379&languageCode=2
Hockey - Champions Trophy, Women, 2012, 1st Round Pool A:
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetTable?sportId=108&phaseId=62717&languageCode=2
Ice Hockey - NHL, 2012/2013, Eastern Conference:
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetTable?sportId=113&phaseId=66557&languageCode=2
Rugby Union - World Cup, Men, 2011, 1st Round Pool C:
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetTable?sportId=219&phaseId=42891&languageCode=2
|
Returns all matches from an eventphase. Does NOT include live scores.
|
UriTemplate
|
|
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetMatchList_EventPhase?sportId={sportId}&eventPhaseId={eventPhaseId}&languagecode={languagecode}
|
|
Parameters:
|
SportID
EventPhaseId
LanguageCode
|
|
Output:
|
n_RoundNr: contains the roundnr within a phase and will be filled in phases like:
- regular phases in domestic leagues
- group phases in international competitions (e.g. WCh, ECh)
- best of series in e.g. NBA playoffs
It will not be filled for single knockout phases like semi-finals in WCh.
|
|
JSON sample call
|
Basketball - NBA, Men, 2012/2013:
http://demo.api.infostradasports.com/svc/TeamSports.svc/json/GetMatchList_EventPhase?sportid=107&eventPhaseId=66139&languageCode=2
Handball - Champions League, Women, 2012/2013:
http://demo.api.infostradasports.com/svc/TeamSports.svc/json/GetMatchList_EventPhase?sportId=125eventPhaseId=65926&languagecode=2
Ice Hockey - World Championships, Men, 2011/2012:
http://demo.api.infostradasports.com/svc/TeamSports.svc/json/GetMatchList_EventPhase?sportId=113&eventPhaseId=62548&languagecode=2
Rugby Union - World Cup, Men, 2011:
http://demo.api.infostradasports.com/svc/TeamSports.svc/json/GetMatchList_EventPhase?sportId=219&eventPhaseId=42883&languagecode=2
|
|
XML sample call
|
Basketball - NBA, Men, 2012/2013:
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetMatchList_EventPhase?sportid=107&eventPhaseId=66139&languageCode=2
Handball - Champions League, Women, 2012/2013:
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetMatchList_EventPhase?sportId=125&eventPhaseId=65926&languagecode=2
Ice Hockey - World Championships, Men, 2011/2012:
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetMatchList_EventPhase?sportId=113&eventPhaseId=62548&languagecode=2
Rugby Union - World Cup, Men, 2011:
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetMatchList_EventPhase?sportId=219&eventPhaseId=42883&languagecode=2
|
Returns matches of a given sport and date. This method does include live scores.
Returns info and result of a match and does include live scores.
Returns a list of periods in a match, including live scores.
|
UriTemplate
|
|
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetMatchPeriodLiveList?sportId={sportId}&matchId={matchId}&languageCode={languageCode}
|
|
Parameters:
|
sportId
matchId
languageCode
|
|
Output:
|
n_PeriodType: 1 = Regular period, 2 = Overtime, 3 = Shootout, 9 = Interval (inbetween periods)
|
|
JSON sample call
|
Ice Hockey - World Championships, Men, 2016, Semifinal CAN-USA:
http://demo.api.infostradasports.com/svc/TeamSports.svc/json/GetMatchPeriodLiveList?sportId=113&matchId=503004&languageCode=2
Volleyball - European Championship, Women, 2015, Semifinal Russia-Serbia:
http://demo.api.infostradasports.com/svc/TeamSports.svc/json/GetMatchPeriodLiveList?sportId=109&matchId=443807&languageCode=2
|
|
XML sample call
|
Ice Hockey - World Championships, Men, 2016, Semifinal CAN-USA:
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetMatchPeriodLiveList?sportId=113&matchId=503004&languageCode=2
Volleyball - European Championship, Women, 2015, Semifinal Russia-Serbia:
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetMatchPeriodLiveList?sportId=109&matchId=443807&languageCode=2
|
Returns all teams in a Teamsports event
|
UriTemplate
|
|
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetTeamList_EventPhase?sportId={sportId}&eventPhaseId={eventPhaseId}&languageCode={languageCode}
|
|
Parameters:
|
SportID
EventPhaseId
LanguageCode
|
|
JSON sample call
|
Ice Hockey - World Championships, Men 2012:
http://demo.api.infostradasports.com/svc/TeamSports.svc/json/GetTeamList_EventPhase?sportId=113&eventPhaseId=62548&languageCode=2
|
Basketball, NBA, Men, 2011/2012:
http://demo.api.infostradasports.com/svc/TeamSports.svc/json/GetTeamList_EventPhase?sportId=107&eventPhaseId=58934&languageCode=2
|
Hockey, Champions Trophy, Women, 2012:
http://demo.api.infostradasports.com/svc/TeamSports.svc/json/GetTeamList_EventPhase?sportId=108&eventPhaseId=58850&languageCode=2
|
Rugby Union, Six Nations Cup, Men, 2015:
http://demo.api.infostradasports.com/svc/TeamSports.svc/json/GetTeamList_EventPhase?sportId=219&eventPhaseId=123189&languageCode=2
|
|
XML sample call
|
Ice Hockey - World Championships, Men 2012:
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetTeamList_EventPhase?sportId=113&eventPhaseId=62548&languageCode=2
|
Basketball, NBA, Men, 2011/2012:
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetTeamList_EventPhase?sportId=107&eventPhaseId=58934&languageCode=2
|
Hockey, Champions Trophy, Women, 2012:
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetTeamList_EventPhase?sportId=108&eventPhaseId=58850&languageCode=2
|
Rugby Union, Six Nations Cup, Men, 2015:
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetTeamList_EventPhase?sportId=219&eventPhaseId=123189&languageCode=2
|
Returns the final result of an event, including medals when applicable.
Returns all persons of a team in a teamsports event
|
UriTemplate
|
|
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetSquad?sportId={sportId}&eventPhaseId={eventPhaseId}&teamID={TeamID}&languageCode={languageCode}
|
|
Parameters:
|
SportID
EventPhaseId
TeamId
LanguageCode
|
|
JSON sample call
|
Ice Hockey - World Championships, Men 2012, Team Canada Squad:
http://demo.api.infostradasports.com/svc/TeamSports.svc/json/GetSquad?sportId=113&eventPhaseId=62548&teamId=107&languageCode=2
|
Hockey - Champions Trophy, Women 2012, Squad of Argentina:
http://demo.api.infostradasports.com/svc/TeamSports.svc/json/GetSquad?sportId=108&eventPhaseId=58850&teamId=415&languageCode=2
|
Rugby Union - Six Nations Cup, Men, 2015, Squad of Wales:
http://demo.api.infostradasports.com/svc/TeamSports.svc/json/GetSquad?sportId=219&eventPhaseId=129189&teamId=686&languageCode=2
|
|
XML sample call
|
Ice Hockey - World Championships, Men 2012, Team Canada Squad:
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetSquad?sportId=113&eventPhaseId=62548&teamId=107&languageCode=2
|
Hockey - Champions Trophy, Women 2012, Squad of Argentina:
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetSquad?sportId=108&eventPhaseId=58850&teamId=415&languageCode=2
|
Rugby Union - Six Nations Cup, Men, 2015, Squad of Wales:
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetSquad?sportId=219&eventPhaseId=129189&teamId=686&languageCode=2
|
Returns line-up of a specific teamsports match
|
UriTemplate
|
|
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetMatchLineup?sportId={sportId}&matchID={MatchID}&languageCode={languageCode}
|
|
Parameters:
|
SportID
MatchId
LanguageCode
|
|
JSON sample call
|
Ice Hockey - World Championships, Men 2012, Line-up Group A, match USA-SVK:
http://demo.api.infostradasports.com/svc/TeamSports.svc/json/GetMatchLineup?sportId=113&matchId=316605&languageCode=2
|
Handball - World Championships, Men, 2013, Line-up Semifinal, Denmark-Croatia:
http://demo.api.infostradasports.com/svc/TeamSports.svc/json/GetMatchLineup?sportId=125&matchId=356716&languageCode=2
|
Rugby Union - Six Nations Cup, Men, 2015, Line-up Wales-England:
http://demo.api.infostradasports.com/svc/TeamSports.svc/json/GetMatchLineup?sportId=219&matchId=443491&languageCode=2
|
|
XML sample call
|
Ice Hockey - World Championships, Men 2012, Line-up Group A, match USA-SVK:
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetMatchLineup?sportId=113&matchId=316605&languageCode=2
|
Handball - World Championships, Men, 2013, Line-up Semifinal, Denmark-Croatia:
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetMatchLineup?sportId=125&matchId=356716&languageCode=2
|
Rugby Union - Six Nations Cup, Men, 2015, Line-up Wales-England:
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetMatchLineup?sportId=219&matchId=443491&languageCode=2
|
Returns goals of a specific teamsports match
|
UriTemplate
|
|
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetMatchActionList_Goal?sportId={sportId}&matchID={matchID}&languageCode={languageCode}
|
|
Parameters:
|
SportID
MatchId
LanguageCode
|
|
JSON sample call
|
Ice Hockey - World Championships, Men 2012, Goals in Group A, match USA-SVK:
http://demo.api.infostradasports.com/svc/TeamSports.svc/json/GetMatchActionList_Goal?sportId=113&matchId=316605&languageCode=2
|
Handball - World Championships, Men, 2013, Goals in Semifinal, Denmark-Croatia:
http://demo.api.infostradasports.com/svc/TeamSports.svc/json/GetMatchActionList_Goal?sportId=125&matchId=356716&languageCode=2
|
Rugby Union - Six Nations Cup, Men, 2015, Goals in Wales-England:
http://demo.api.infostradasports.com/svc/TeamSports.svc/json/GetMatchActionList_Goal?sportId=219&matchId=443491&languageCode=2
|
|
XML sample call
|
Ice Hockey - World Championships, Men 2012, Goals in Group A, match USA-SVK:
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetMatchActionList_Goal?sportId=113&matchId=316605&languageCode=2
|
Handball - World Championships, Men, 2013, Goals in Semifinal, Denmark-Croatia:
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetMatchActionList_Goal?sportId=125&matchId=356716&languageCode=2
|
Rugby Union - Six Nations Cup, Men, 2015, Goals in Wales-England:
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetMatchActionList_Goal?sportId=219&matchId=443491&languageCode=2
|
Return basic actions (goals+warnings) of specific teamsports match
|
UriTemplate
|
|
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetMatchActionList_Basic?sportId={sportId}&matchID={matchID}&languageCode={languageCode}
|
|
Parameters:
|
SportID
MatchId
LanguageCode
|
|
JSON sample call
|
Ice Hockey - World Championships, Men 2012, basic actions in match USA-SVK:
http://demo.api.infostradasports.com/svc/TeamSports.svc/json/GetMatchActionList_Basic?sportId=113&matchId=316605&languageCode=2
|
Handball - World Championships, Men, 2013, basic actions in Semifinal, Denmark-Croatia:
http://demo.api.infostradasports.com/svc/TeamSports.svc/json/GetMatchActionList_Basic?sportId=125&matchId=356716&languageCode=2
|
Rugby Union - Six Nations Cup, Men, 2015, basic actions in Wales-England:
http://demo.api.infostradasports.com/svc/TeamSports.svc/json/GetMatchActionList_Basic?sportId=219&matchId=443491&languageCode=2
|
|
XML sample call
|
Ice Hockey - World Championships, Men 2012, basic actions in match USA-SVK:
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetMatchActionList_Basic?sportId=113&matchId=316605&languageCode=2
|
Handball - World Championships, Men, 2013, basic actions in Semifinal, Denmark-Croatia:
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetMatchActionList_Basic?sportId=125&matchId=356716&languageCode=2
|
Rugby Union - Six Nations Cup, Men, 2015, basic actions in Wales-England:
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetMatchActionList_Basic?sportId=219&matchId=443491&languageCode=2
|
Return list of Team Stats of a specific teamsports match
|
UriTemplate
|
|
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetMatchTeamStatList?sportId={sportId}&matchId={matchId}&languageCode={languageCode}
|
|
Parameters:
|
SportID
MatchId
LanguageCode
|
|
JSON sample call
|
Hockey - Olympic Games, 2008, Men, Pool A, team stats in match GER-ESP:
http://demo.api.infostradasports.com/svc/TeamSports.svc/json/GetMatchTeamStatList?sportId=108&matchId=356825&languageCode=2
|
Rugby Union - Six Nations Cup, Men, 2015, team stats in Wales-England:
http://demo.api.infostradasports.com/svc/TeamSports.svc/json/GetMatchTeamStatList?sportId=219&matchId=443491&languageCode=2
|
|
XML sample call
|
Hockey - Olympic Games, 2008, Men, Pool A, team stats in match GER-ESP:
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetMatchTeamStatList?sportId=108&matchId=356825&languageCode=2
|
Rugby Union - Six Nations Cup, Men, 2015, team stats in Wales-England:
http://demo.api.infostradasports.com/svc/TeamSports.svc/Xml/GetMatchTeamStatList?sportId=219&matchId=443491&languageCode=2
|
Returns general info of a single person.
Returns a person list with stats of an event.
Returns a person list with stats of an event.
Returns a team list with stats of an event.
Returns a person list with stats of a match.
Returns a person list with stats of an event.
Returns a person list with stats of a match.
Returns a list with all sports which are configured for your account.
Returns all editions of a sport of the current season.
Returns all EventPhases of an Edition.
Returns all Phases in an EventPhase, a discipline in a certain Edition (for example Wch 2011 Athletics, 100m Men)
Returns the participants of a phase
Returns general info from a phase
Returns a list of intermediate points of a phase (laps or splits). The results of an intermediate point can be obtained with GetResult.
Returns the result of a phase
Returns the cumulative results after a specific phase.
Returns all ranking editions of a sport of a specific season (e.g. 2012 or 20122013).
Returns eventphases of a ranking edition.
Returns the ranking from a phase from GetRankingPhaseList.
Returns general info of a person.
Golf
GetGolfSchedule
Returns the full schedule of a specific tour and season.
Returns the (live) leaderboard of a specific tournament. PhaseId can be retrieved from GetGolfSchedule
Returns the playoff result of a specific tournament, if applicable.
List of courses of a specific tour and season.
Returns a list of courses of a specific tournament.
List of courses of a specific tour and season.
Returns overall statistics within a specific tour and season.
Returns statistics of a person within a specific tour and season.
Returns results of a person within a specific tour and season.
Returns the current ranking of a specific type.
Returns a list with all sports which are configured for your account.
Returns all editions of a sport of the current season.
Returns all disciplines (eventphases) in an edition.
Returns all phases from an EventPhase. EventPhaseID can be retrieved using GetEditionList
Returns general info from a phase
Returns the table of a phase.
Returns all matches from an eventphase. Does NOT include live scores.
Returns all matches of a specific date and sport, including live scores.
Returns info for a match, including live scores.
Returns all participants from an eventphase.
Returns final result of an event, including medals where applicable.
Returns general info of a person
Games
For coverage of the upcoming Olympic Winter Games in 2018 we refer to the Games_v2 module.
This module offers coverage of multi-sports events like Olympic Games, Paralympics and Commonwealth Games. Some methods require the parameter competitionSetId, which indicates the kind of Games (the competitionSetID for the Summer Games is 1). Methods where you should pass sportId in combination with matchId, phaseId or eventphaseId do not require competitionSetId.
Medals
Live
- GetResultsOfTheDay - scheduled, live and finished matches, events and phases of a specific day
Schedule
Results
NOCs
Persons
Returns medal table of a specific season of a specific Games competition. Also possible per sport.
Returns general info of the medal table: as of date, total number of events and number of finished and scheduled events.
Returns all time medal table. Also possible per sport.
Returns medal count of a NOC of a specific season of a specific Games competition. Also possible per sport.
Returns alltime medal count of a NOC of a specific Games competition. Also possible per sport.
Returns medal count of a person of a specific season of a specific Games competition.
Returns alltime medal count of a person of a specific Games competition.
Returns medal winners of specific day, grouped by sport and event. Also possible per sport.
Returns medal winners of a specific nocId, grouped by sport and event. Also possible per sport.
Returns of a specific day: scheduled, live and finished matches, events and phases.
The following data will be included:
- Team sports: all matches
- H2H sports: all matches from the quarter finals until the finals. For the phases before the quarter finals only the phase itself will be included. We show for example for Table Tennis Men's Singles only the status (scheduled, live or finished) of the preliminary round until the 4th round.
- TimeJudge sports: if there are are no phases for an event, the event itself is included. Furthermore, if there are phases, only the phase on the first level (=Phase1) will be included. For example, the Athletics Marathon will be included. But for the 100m only the phases Preliminary round, 1st Round, Semifinal and Final will be included, not the separate Heats or three semi finals (=Phase2). For the Decathlon, all the 5 phases on one day will be included.
|
UriTemplate
|
|
http://demo.api.infostradasports.com/svc/Games.svc/xml/GetResultsOfTheDay?date={date}&languageCode={languageCode}&competitionSetId={competitionSetId}
|
|
Parameters:
|
date
competitionSetId
languageCode
|
|
Output:
|
b_GetMatchList: if true this phase contains matches which can be retrieved with the method GetMatchList or GetMatchLiveList.
b_GetTable: if true this phase has a table which can be retrieved with the method GetTable.
b_GetResult if true the result of this phase can be retrieved with the method GetResult.
b_GetResultAfter if true the general result after this phase (e.g. the standings after a Sailing race) can be retrieved with the method GetResultAfter.
c_Opponent columns: describe the opponents of a match, these can be persons or teams.
c_PhaseMatchName: describes a phase or match and contains event, gender, phase and match information. E.g. 'Women, 1st Round, Pool B, New Zealand - United States'
Ranked[1][2][3]Phase columns: describe the result top 3 of a specific phase, e.g. Race 2 of a Sailing event.
Ranked[1][2][3]Overall columns: describe the standings top 3 after a specific phase, e.g. the standings after Race 2 of a Sailing event.
n_PhaseOrOverall: = 1 when there is no Overall ranking linked to the Phase, so you should show Ranked[1][2][3]Phase.
= 2 when there is an Overall ranking linked to the Phase, so you should show Ranked[1][2][3]Overall.
Ranked[1][2][3] columns: contains the value of Ranked[1][2][3]Overall if applicable, else Ranked[1][2][3]Phase. With these columns you don't have to use n_PhaseOrOverall to determine which columns you should show.
b_Medal[Gold][Silver][Bronze]: indicate which medals can be earned in this event, phase or match.
n_MatchWinner: = 1 when match is won by Opponent1, = 2 when won by Opponent2
c_MatchResult: basic match result, e.g '0-2' for Tennis, or '64-83' for Basketball
c_MatchScore: detailed match result (period scores), e.g. '3-6 6-7(3)' for Tennis, or '12-19, 16-25, 22-21, 14-18' for Basketball
|
|
JSON sample call
|
Olympic Summer Games 2012, 29 July 2012:
http://demo.api.infostradasports.com/svc/Games.svc/json/GetResultsOfTheDay?date=20120729&languageCode=2&competitionSetId=1
Asian Games 2010, 20 November 2010:
http://demo.api.infostradasports.com/svc/Games.svc/json/GetResultsOfTheDay?date=20101120&languageCode=2&competitionSetId=9
|
|
XML sample call
|
Olympic Summer Games 2012, 29 July 2012:
http://demo.api.infostradasports.com/svc/Games.svc/Xml/GetResultsOfTheDay?date=20120729&languageCode=2&competitionSetId=1
Asian Games 2010, 20 November 2010:
http://demo.api.infostradasports.com/svc/Games.svc/xml/GetResultsOfTheDay?date=20101120&languageCode=2&competitionSetId=9
|
Schedule
Returns events, phases and matches of a specific date.
Returns events, phases and matches of a specific sport.
Returns events, phases and matches of a specific date and sport.
Results
Return list of seasons. Also possible in combination with sportId.
Returns list of sports of specific season.
Returns all events of a specific sport and season.
Returns list of (historical) events of specific event within a sport
|
UriTemplate
|
|
http://demo.api.infostradasports.com/svc/Games.svc/Xml/GetEventPhaseList_Event?competitionSetId={competitionSetId}&sportid={sportId}&eventId={eventId}&languageCode={Languagecode}
|
|
Parameters:
|
competitionSetId
sportId
eventId
languageCode
|
|
JSON sample call
|
Olympic Summer Games, Athletics, 100m:
http://demo.api.infostradasports.com/svc/Games.svc/json/GetEventPhaseList_Event?competitionSetId=1&sportId=106&eventId=9561&languageCode=2
Olympic Summer Games, Basketball, Team:
http://demo.api.infostradasports.com/svc/Games.svc/json/GetEventPhaseList_Event?competitionSetId=1&sportId=107&eventId=0&languageCode=2
Asian Games 2010, Sepaktakraw, Team events:
http://demo.api.infostradasports.com/svc/Games.svc/json/GetEventPhaseList_Event?competitionSetId=9&sportId=504&eventId=0&languageCode=2
|
|
XML sample call
|
Olympic Summer Games, Athletics, 100m:
http://demo.api.infostradasports.com/svc/Games.svc/Xml/GetEventPhaseList_Event?competitionSetId=1&sportId=106&eventId=9561&languageCode=2
Olympic Summer Games, Basketball, Team:
http://demo.api.infostradasports.com/svc/Games.svc/Xml/GetEventPhaseList_Event?competitionSetId=1&sportId=107&eventId=0&languageCode=2
Asian Games 2010, Sepaktakraw, Team events:
http://demo.api.infostradasports.com/svc/Games.svc/Xml/GetEventPhaseList_Event?competitionSetId=9&sportId=504&eventId=11293&languageCode=2
|
Returns list of phases of specific sport and event.
Returns list of participants of specific phase.
Returns general info of specific phase.
Returns a list of intermediate points of a phase (laps or splits). The result of an intermediate point can be obtained with GetResult.
Returns results of specific phase or event
Returns standings of an event after a specific phase.
Method returns table of specific group phase.
Return all persons of a team in a teamsports event
Returns list of matches of specific phase. This method does not include live scores, only final results.
Returns list of matches of specific phase, including live scores.
Returns info of specific match, including live scores
|
UriTemplate
|
|
http://demo.api.infostradasports.com/svc/Games.svc/Xml/GetMatchInfo?sportId={sportId}&matchId={matchId}&languageCode={languageCode}
|
|
Parameters:
|
sportId
matchId
languageCode
|
|
Output:
|
n_PeriodType: 1 = Regular period, 2 = Overtime, 3 = Shootout, 9 = Interval (inbetween periods)
|
|
JSON sample call
|
Olympic Summer Games 2012, Basketball, Men Quarterfinal AUS-USA:
http://demo.api.infostradasports.com/svc/Games.svc/json/GetMatchInfo?sportId=107&matchId=323983&languageCode=2
Olympic Summer Games 2012, Judo, Men 60kg final:
http://demo.api.infostradasports.com/svc/Games.svc/json/GetMatchInfo?sportId=126&matchId=474581&languageCode=2
Asian Games Sepaktakraw, 2010, Men, 1st Round Pool A KOR-INA:
http://demo.api.infostradasports.com/svc/Games.svc/json/GetMatchInfo?sportId=504&matchId=403899&languageCode=2
|
|
XML sample call
|
Olympic Summer Games 2012, Basketball, Men Quarterfinal AUS-USA:
http://demo.api.infostradasports.com/svc/Games.svc/Xml/GetMatchInfo?sportId=107&matchId=323983&languageCode=2
Olympic Summer Games 2012, Judo, Men 60kg final:
http://demo.api.infostradasports.com/svc/Games.svc/Xml/GetMatchInfo?sportId=126&matchId=474581&languageCode=2
Asian Games Sepaktakraw, 2010, Men, 1st Round Pool A KOR-INA:
http://demo.api.infostradasports.com/svc/Games.svc/Xml/GetMatchInfo?sportId=504&matchId=403899&languageCode=2
|
Return line-up of a specific teamsports match
|
UriTemplate
|
|
http://demo.api.infostradasports.com/svc/Games.svc/Xml/GetMatchLineup?sportId={sportId}&matchId={matchId}&languageCode={languageCode}
|
|
Parameters:
|
sportId
matchid
languageCode
|
|
JSON sample call
|
Olympic Summer Games, Hockey, 2012, Men, final, GER-NED:
http://demo.api.infostradasports.com/svc/Games.svc/json/GetMatchLineup?sportId=108&matchId=324129&languageCode=2
|
|
XML sample call
|
Olympic Summer Games, Hockey, 2012, Men, final, GER-NED:
http://demo.api.infostradasports.com/svc/Games.svc/Xml/GetMatchLineup?sportId=108&matchId=324129&languageCode=2
|
Returns goals of a specific teamsports match
|
UriTemplate
|
|
http://demo.api.infostradasports.com/svc/Games.svc/Xml/GetMatchActionList_Goal?sportId={sportId}&matchId={matchId}&languageCode={languageCode}
|
|
Parameters:
|
sportId
matchId
languageCode
|
|
JSON sample call
|
Olympic Summer Games, Hockey, 2012, Men, final, GER-NED:
http://demo.api.infostradasports.com/svc/Games.svc/json/GetMatchActionList_Goal?sportId=108&matchId=324129&languageCode=2
|
|
XML sample call
|
Olympic Summer Games, Hockey, 2012, Men, final, GER-NED:
http://demo.api.infostradasports.com/svc/Games.svc/Xml/GetMatchActionList_Goal?sportId=108&matchId=324129&languageCode=2
|
Returns basic actions (goals+warnings) of specific teamsports match
|
UriTemplate
|
|
http://demo.api.infostradasports.com/svc/Games.svc/Xml/GetMatchActionList_Basic?sportId={sportId}&matchId={matchId}&languageCode={languageCode}
|
|
Parameters:
|
sportId
matchid
languageCode
|
|
JSON sample call
|
Olympic Summer Games, Hockey, 2012, Men, final, GER-NED:
http://demo.api.infostradasports.com/svc/Games.svc/json/GetMatchActionList_Basic?sportId=108&matchId=324129&languageCode=2
|
|
XML sample call
|
Olympic Summer Games, Hockey, 2012, Men, final, GER-NED:
http://demo.api.infostradasports.com/svc/Games.svc/Xml/GetMatchActionList_Basic?sportId=108&matchId=324129&languageCode=2
|
Return list of olympic or world records of current Olympic events of a specific sport and/or gender.
Return list of olympic and world records of a specific current Olympic event.
Returns participating NOCs
Return schedule and results of a specific day and country (nocId). The persons and teams are included. One row per person, event, phase, match combination.
Returns all participating persons of specific NOC and season
Return general info of a person.
Returns all events of a person.
Returns schedule and results of a person in a specific season: matches, events and/or phases.
Games
The Games module offers coverage of the Olympic Summer and Winter Games.
There are example calls available for the 2020 Summer Games.
Some important concepts:
- competitionSetId: indicates the kind of Games (Summer Games=1, Winter Games=2). Methods to retrieve medal and schedule data mostly need the input parameter competitionSetId. Methods to retrieve specific match or phase data mostly require only a sportId and (event)phaseId or matchId.
-
season: the editions of Summer and Winter Games are linked to seasons. Summer Games are linked to a season which cover one year, e.g. 2016 2021 (Note that the 2020 Olympic Games were scheduled in the season 2021 due to Covid-19) and is called in our terminology a 'summer season'. Winter Games are linked to a season which covers parts of two years, e.g. 2017/2018 2021/2022, and is called a 'winter season'. The season parameter for summer seasons should be in the format like 2016 2021 and for winter seasons like 20142018 20212022.
- event: every contest is of a specific event type. Both the 2014 2018 and 2018 2022 editions of the Alpine Skiing Slalom contest are of the event type 'Slalom' and will have the same eventid.
- eventphase: every main contest (e.g. 2020 Athletics Men's 100m) is called an eventphase and has a specific id (eventphaseid). So both Athletics Men's 100m events in 2016 and 2020 will have a different eventphaseid. They have however the same eventid.
- phase: a main contest can consist of different stages. We call that 'phases' and they have a unique id (phaseid). An Alpine Skiing Slalom eventphase consists of two phases: Run 1 and Run 2. An Alpine Skiing Downhill event has no phases because it consists of a single run.
- NOC: a NOC is a participating country and stands for National Olympic Committee. Every NOC has a unique is (NOCID) and has an associated country which is represented by n_NOCGeoID. With n_NOCGeoID you can show the flag of a specific NOC.
Medals
Live / Schedule
- GetDateList - a list of all dates within an Olympic Games season
- GetScheduleDate - events, phases, and matches on a date, grouped by sport
- GetScheduleDateByTime - events, phases, and matches on a date, grouped by status (live, upcoming, finished)
- GetScheduleSport - events, phases, and matches of a sport, grouped by date
- GetScheduleSportByTime- events, phases, and matches of a sport, grouped by status (live, upcoming, finished)
- GetScheduleNOC - events, phases, and matches of a NOC, grouped by sport
- GetScheduleMatrix - Matrix indicating the medals and number of events of a date and sport
- GetNOCParticipationList_Date schedule and results of persons and teams on a specific date for specific NOC
Results
Records
- GetRecordList - olympic or world records of current Olympic events of a sport and/or gender
NOCs
Person / Team
Medals
Returns medal table of a specific season of a specific Games competition. Also possible per sport.
Returns medal winners of a specific Season, grouped by sport and event.
Returns medal table detail for a specific NOC in a specific season. It includes the overall medal count and a list of sports including the medal winners.
Returns medal table detail for a specific sport in a specific season. It includes the overall medal count and a list of NOCs including the medal winners.
Live / Schedule
Returns a list of all dates within an Olympic Games season.
Returns events, phases and matches of a specific date grouped by sport.
Returns events, phases and matches of a specific date grouped by status (live, upcoming, finished).
Returns events, phases and matches of a specific sport grouped by date.
Returns events, phases and matches of a specific sport grouped by status (live, upcoming, finished).
Returns events, phases, and matches of specific NOC grouped by sport.
Returns number of events, phase, matches and medals of a specific day per sport.
Returns schedule and results of persons and teams on a specific date for specific NOC.
Results
Return list of seasons. Also possible in combination with sportId.
Returns list of sports of specific season.
Returns all events of a specific sport and season.
Returns list of (historical) events of specific event within a sport
Return all persons of a team in a teamsports event
All group standings within an event phase
Returns list of phases within an eventphase.
Returns results, startinglist, standings of a phase.
Returns list of matches of specific eventphase.
Returns list of matches of specific Phase.
Preview, score, lineups, play-by-play and statistics of a match.
Records
Return list of olympic or world records of current Olympic events of a specific sport and/or gender.
NOCs
Returns participating NOCs
Person / Team
Persons
Return general info of a person.
Return detailed results of a person of a specific Games in a specific season.
Returns all participating persons of specific NOC and season
Returns all participating persons of specific Sport and season
Returns a list containing major results of a person.
Return detailed results of a team of a specific Games in a specific season.
Returns all participating teams of specific Sport and season
Returns all participating teams of specific NOC and season
Returns list of sports for which persons with biography information is available. This is the starting point of the Biography module. You can use sportId as input parameter for GetPersonList.
Returns list of persons of a specific sport for whom biography information is available. SportId can be obtained from GetSportList.
Returns general information of a Person. PersonId can be obtained from GetPersonList.
Returns list of biography information of a person. PersonId can be obtained from GetPersonList.
Returns list of major achievements of a person. PersonId can be obtained from GetPersonList.
Returns list of clients who get the bio frame/widgets
Returns list of clients who get widgets.
Returns list of widget modules, sports and competitions for a specific client
Editorial
Live flashes
Facts & Figures
Returns editorial flashes from a specific phase. These are only available in Dutch for Cycling Grand Tours and Danish for Cycling Tour de France)
Returns editorial flashes from a specific match.
|
UriTemplate
|
|
http://demo.api.infostradasports.com/svc/Editorial.svc/json/GetFlashList_Match?sportId={sportId}&matchId={matchId}&languageCode={languageCode}
|
|
Parameters:
|
sportId
matchId
languageCode
|
Returns facts and figures for a specific match, previews or reviews.
Returns facts and figures for a specific date in an edition, previews or reviews.
Returns facts and figures of a specific week (Tuesday till Monday) in an edition, previews or reviews.
|
|
|
|
|