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 Summary

Provides details like scores of the teams in the match, the stadium of the match, the referee of the match, the weather for the match date.

Soccer Match Summary 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: 1 Request / Hour   Daily Max API Call: 24 Requests per Match

IMPORTANT


  • This data can be retrieved for only ± 7 days.
  • Please, do not use to update your scores by this endpoint. You have to use always Match Lists endpoints to update your scores.

Request Headers

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

Request Parameters

DataTypeO / RExampleDescription
matchId
INTR{matchId}id of the match

Response Output

 sample - 1 
 sample - 2 

Response Output Definitions

match

DataTypeExampleDescription
dateDATE/STR17/04/2019 10:30:00The kick-off date of the match, includes also time
idINT1365551The id of the match
homeTeam/awayTeam
DataTypeExampleDescription
nameSTRGwangjuThe full name of the home/away team
shortNameSTRGWAThe short name of the home/away team
mediumNameSTRGwangjuThe medium name of the home/away team
idINT15622The id of the home/away team
score
DataTypeExampleDescription
regularINT2The regular score of the match for home/away team
halfTimeINT2The half-time score of the match for home/away team
currentINT6The current score of the match (live and post) for home/away team
penaltiesINT6The penalty score of the match for home/away team
extraTimeINT2The extra time score of the match for home/away team
status
DataTypeExampleDescription
nameSTRFinished A.P.The name of the status
shortNameSTRFPTThe short name of the status
idINT11The id of the status
times
DataTypeExampleDescription
currentMinuteINT67Current minute of the match
stoppageINT3Stoppage minute of the match
tournament
DataTypeExampleDescription
nameSTRSouth Korean Federation CupThe name of the tournament
shortNameSTRSKFCThe short name of the tournament
idINT260The id of the tournament
stage
DataTypeExampleDescription
nameSTR4th RoundThe name of the stage
shortNameSTR4th RThe short name of the stage
idINT39199The id of the stage
round
DataTypeExampleDescription
nameSTRSingle GameThe name of the round
shortNameSTRSGThe short name of the round
idINT209The id of the round
info
stadium
DataTypeExampleDescription
nameSTRGuus HiddinkThe name of the stadium
idINT3111The id of the stadium
referee
DataTypeExampleDescription
nameSTRAndre MarrinerThe name of the referee
mediumNameSTRA. MarrinerThe medium name of the referee
idINT295The id of the referee
weather
DataTypeExampleDescription
temperatureCDEC10Temperature in Celsius format
temperatureFDEC50Temperature in Fahrenheit format
status
DataTypeExampleDescription
nameSTRPartly CloudyThe name of the weather status
idINT3The id of the weather status




2019 - Broadage Sports All rights reserved