logologo
WIDGETSAPIPRICINGCOVERAGESUPPORT

Soccer API Tech Docs

Tech Docs Index

  • Documentation+
  • Widgets+
  • Lookups+
  • Global API+
  • Soccer API+
  • Basketball API+
  • Football API+
  • Baseball API+
  • Ice Hockey API+
  • Volleyball API+
  • Handball API+
  • Table Tennis API+
  • Tennis API+

Soccer API Match Events All

Provides all the live events of the match.

Soccer Match Events All Request URL

GET

References / Dependencies

 Tournament ID  The id of the tournament. You can find list of the tournament from Tournament List endpoint 
 Stage / Round Structure  Stage / Round structures change tournament by tournament. You can find the structures with Tournament Id from Tournament Info endpoint 
 Matches from Fixture  Match Ids can be retrieved from The fixture of the tournament. You can find all matches of the tournament from Tournament Fixture endpoint 
 Matches from Match List  Match Ids can be retrieved from The Daily Match List. You can find all matches in 7-days period from Match List endpoint 

Call Rate / Interval

Recommended API Call Interval at live: 15 Request / Minute  Recommended API Call Interval at 1 hour after game end: 2 Request / Minute Recommended API Call Interval at more than 1 hour after game end: 6 Request / Hour 

IMPORTANT


  • This data can be retrieved for only ± 7 days.
  • Please, start your requesting when the match is started. The data will be served when the match is started.
  • Always compare your event id by id on your side when you retrieved the data from endpoints.
    • If you can not find the same event id on your side, please delete the event on your side.
    • If you find the event id on your side, please always update your event. Because due to some reasons, player name and minute of the event can be changed.

Request Headers

DataTypeO / RExampleDescription
languageIdINTR{languageId}The id of the language that you select.
Ocp-Apim-Subscription-KeySTR
R{yourOcp-Apim-Subscription-Key}Your account key.
AcceptSTROapplication/xmlSelection of data presentation type as XML/JSON.
 *O= Optional, R= Required

Request Parameters

DataTypeO / RExampleDescription
matchIdINTR{matchId}The id of the match

Response Output

Response Output Definitions

match

DataTypeExampleDescription
idINT1352564The id of the match
dateDATE/STR20/07/2019 02:00:00The date of the match
tournament
DataTypeExampleDescription
nameSTRAmerican Major LeagueThe name of the tournament for the match
shortNameSTRMLSThe short name of the tournament for the match
idINT44The id of the tournament for the match
stage
DataTypeExampleDescription
nameSTRLeague SeasonThe name of the stage for the match
shortNameSTRREGThe short name of the stage for the match
idINT39050The id of the stage for the match
round
DataTypeExampleDescription
nameSTRRound 26The name of the round for the match
shortNameSTRW26The short name of the round for the match
idINT26The id of the round for the match
homeTeam/awayTeam
DataTypeExampleDescription
nameSTRLos Angeles GalaxyThe name of the home/away team for the match
mediumNameSTRLA GalaxyThe short name of the home/away team for the match
shortNameSTRLAGThe short name of the home/away for the match
idINT1864The id of the home/away for the match
events
event
DataTypeExampleDescription
teamIdINT1864The team id of the event
combineIdSTR
It means the combination of the two events. Like Goal-Assist and SubsOut-SubIn. You can show combined event by using CombineId
minuteINT6The minute of the event
orderNoINT1The priority number of the event, if its occured in same minute
homeTeamScoreINT
0The score of the home team at that moment
awayTeamScoreINT
1The score of the away team at that moment
idINT11336939the id of the event
type
DataTypeExampleDescription
nameSTRShot on TargetThe name of the event type
shortNameSTR
The short name of the event type
idINT15The id of the event type

player
DataTypeExampleDescription
knownNameSTRZlatan IbrahimovicThe known name of the player
knownNameMediumSTRZ.IbrahimovicThe medium known name of the player
knownNameShortSTRIbrahimovicThe short known name of the player
shirtNumberSTR9The shirt (jersey) number of the player
idINT904The id of the player
country
DataTypeExampleDescription
nameSTRSwedenThe name of the player's country
shortNameSTRSWEThe short name of the player's country
idINT11the id of the player's country
2019 - Broadage Sports All rights reserved