Soccer API Tech Docs

Search in tech docs

Soccer API Match Commentary

Provides the live commentary of the match.

Soccer Match Commentary 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: 12 Request / Minute Recommended API Call Interval at 1 hour after game end: 1 Request / Minute Recommended API Call Interval at more than 1 hour after game end: 4 Request / Hour

IMPORTANT

This data can be retrieved for only ± 7 days.
Please, start your requesting 45 or 60 mins before the match is started. Because the lineup is served 45 or 60 mins before the match.
Always compare your comments id by id on your side when you retrieved the data from endpoints.
- If you can not find the same commentId on your side, please delete the event on your side.
- If you find the CommentId on your side, please always update your event objects such as player name and minute on your side.

Request Headers

Data	Type	O / R	Example	Description
languageId	INT	R	{languageId}	The id of the language that you select.
Ocp-Apim-Subscription-Key	STR	R	{yourOcp-Apim-Subscription-Key}	Your account key.
Accept	STR	O	application/xml	Selection of data presentation type as XML/JSON.

^*O= Optional, R= Required

Request Parameters

Data	Type	O / R	Example	Description
matchId	INT	R	{matchId}	The id of the match

Response Output

{ "homeTeam": { "name": "Manchester City", "shortName": "MCFC", "mediumName": "Man City", "id": 269 }, "awayTeam": { "name": "Manchester United", "shortName": "MANU", "mediumName": "Man United", "id": 4 }, "comments": [ { "type": { "name": "Full Time", "shortName": "", "id": 49 }, "minute": 90, "orderNo": 5, "text": "The referee blows the final whistle. Manchester City 3-1 Manchester United. ", "id": 6546044 }, { "type": { "name": "Assist", "shortName": "", "id": 23 }, "teamId": 269, "minute": 86, "orderNo": 4, "text": "Bernardo Silva makes an assist. ", "id": 6545913 }, { "type": { "name": "Goal", "shortName": "", "id": 6 }, "teamId": 269, "minute": 86, "orderNo": 3, "text": "GOAL! İlkay Gündoğan makes the score of his team +2.", "id": 6545891 }, { "type": { "name": "Start of 2nd Half", "shortName": "", "id": 41 }, "minute": 46, "orderNo": 0, "text": "Referee blows the whistle to start the second half.", "id": 6544880 }, { "type": { "name": "Half Time", "shortName": "", "id": 40 }, "minute": 45, "orderNo": 0, "text": "Halftime. Score 1-0.", "id": 6544538 }, { "type": { "name": "Kick Off", "shortName": "", "id": 39 }, "minute": 1, "orderNo": 0, "text": "The referee blows the whistle for the game to start. ", "id": 6543531 } ], "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "2018/2019 Season", "shortName": "18/19", "id": 37295 }, "round": { "name": "Round 12", "shortName": "W12", "id": 12 }, "date": "11/11/2018 16:30:00", "id": 1307540 }

Response Output Definitions

match

Data

Type

Example

Description

INT

1363598

The id of the match

date

DATE/STR

03/04/2019 19:00:00

The date of the match

tournament

Data	Type	Example	Description
name	STR	English Premier League	The name of the tournament for the match
shortName	STR	EPL	The short name of the tournament for the match
id	INT	2	The id of the tournament for the match

stage

Data	Type	Example	Description
name	STR	2018/2019 Season	The name of the stage for the match
shortName	STR	18/19	The short name of the stage for the match
id	INT	37295	The id of the stage for the match

round

Data	Type	Example	Description
name	STR	Round 12	The name of the round for the match
shortName	STR	W12	The short name of the round for the match
id	INT	12	The id of the round for the match

homeTeam/awayTeam

Data	Type	Example	Description
name	STR	Manchester City	The name of the home/away team for the match
mediumName	STR	Man. City	The short name of the home/away team for the match
shortName	STR	MCFC	The short name of the home/away for the match
id	INT	269	The id of the home/away for the match

comments

comment

Data

Type

Example

Description

teamId

INT

269

The team id of the comment

minute

INT

The minute of the comment

orderNo

INT

The priority number of the comment, if its occured in same minute

homeTeamScore

STR

The score of the home team at that moment

awayTeamScore

STR

The score of the away team at that moment

INT

10609835

the id of the comment

text

STR

GOAL! İlkay Gündoğan makes the score of his team +2.

the editorial text of the comment

type

Data	Type	Example	Description
name	STR	Goal	The name of the comment's event type
shortName	STR	G	The short name of the comment's event type
id	INT	6	the id of the comment's event type

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+