Soccer API Tech Docs

Search in tech docs

Soccer API Result Statistics

Provides the result list of the last 20 matches between the two teams in overall, with home and away filters.

Soccer Result Statistics 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

Teams Informations The informations of teams in the tournament. You can find list of the teams from Tournament Teams endpoint

Call Rate / Interval

Recommended API Call Interval: 2 Requests / Day Daily Max API Call: 4 Requests

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": "Liverpool", "shortName": "LIV", "mediumName": "Liverpool", "id": 265 }, "awayTeam": { "name": "Chelsea", "shortName": "CHE", "mediumName": "Chelsea", "id": 200 }, "status": { "name": "Scheduled", "shortName": "SCH", "id": 1 }, "h2h": { "resultStatistics": { "overall": { "halfTime": { "homeTeam": { "win": 3, "winningPercentage": 15.00, "draw": 11, "drawPercentage": 55.00, "lose": 6, "losingPercentage": 30.00, "totalGoalsScored": 11, "averageGoalsScored": 0.55 }, "awayTeam": { "win": 6, "winningPercentage": 30.00, "draw": 11, "drawPercentage": 55.00, "lose": 3, "losingPercentage": 15.00, "totalGoalsScored": 11, "averageGoalsScored": 0.55 } }, "ordinaryTime": { "homeTeam": { "win": 5, "winningPercentage": 25.00, "draw": 11, "drawPercentage": 55.00, "lose": 4, "losingPercentage": 20.00, "totalGoalsScored": 22, "averageGoalsScored": 1.1 }, "awayTeam": { "win": 4, "winningPercentage": 20.00, "draw": 11, "drawPercentage": 55.00, "lose": 5, "losingPercentage": 25.00, "totalGoalsScored": 19, "averageGoalsScored": 0.95 } }, "finalScore": { "homeTeam": { "win": 8, "winningPercentage": 40.00, "draw": 8, "drawPercentage": 40.00, "lose": 4, "losingPercentage": 20.00, "totalGoalsScored": 45, "averageGoalsScored": 2.25 }, "awayTeam": { "win": 4, "winningPercentage": 20.00, "draw": 8, "drawPercentage": 40.00, "lose": 8, "losingPercentage": 40.00, "totalGoalsScored": 39, "averageGoalsScored": 1.95 } } }, "home": { "halfTime": { "homeTeam": { "win": 4, "winningPercentage": 20.00, "draw": 8, "drawPercentage": 40.00, "lose": 8, "losingPercentage": 40.00, "totalGoalsScored": 12, "averageGoalsScored": 0.6 }, "awayTeam": { "win": 8, "winningPercentage": 40.00, "draw": 8, "drawPercentage": 40.00, "lose": 4, "losingPercentage": 20.00, "totalGoalsScored": 12, "averageGoalsScored": 0.6 } }, "ordinaryTime": { "homeTeam": { "win": 5, "winningPercentage": 25.00, "draw": 9, "drawPercentage": 45.00, "lose": 6, "losingPercentage": 30.00, "totalGoalsScored": 27, "averageGoalsScored": 1.35 }, "awayTeam": { "win": 6, "winningPercentage": 30.00, "draw": 9, "drawPercentage": 45.00, "lose": 5, "losingPercentage": 25.00, "totalGoalsScored": 25, "averageGoalsScored": 1.25 } }, "finalScore": { "homeTeam": { "win": 6, "winningPercentage": 30.00, "draw": 8, "drawPercentage": 40.00, "lose": 6, "losingPercentage": 30.00, "totalGoalsScored": 33, "averageGoalsScored": 1.65 }, "awayTeam": { "win": 6, "winningPercentage": 30.00, "draw": 8, "drawPercentage": 40.00, "lose": 6, "losingPercentage": 30.00, "totalGoalsScored": 30, "averageGoalsScored": 1.5 } } }, "away": { "halfTime": { "homeTeam": { "win": 3, "winningPercentage": 15.00, "draw": 10, "drawPercentage": 50.00, "lose": 7, "losingPercentage": 35.00, "totalGoalsScored": 11, "averageGoalsScored": 0.55 }, "awayTeam": { "win": 7, "winningPercentage": 35.00, "draw": 10, "drawPercentage": 50.00, "lose": 3, "losingPercentage": 15.00, "totalGoalsScored": 13, "averageGoalsScored": 0.65 } }, "ordinaryTime": { "homeTeam": { "win": 6, "winningPercentage": 30.00, "draw": 9, "drawPercentage": 45.00, "lose": 5, "losingPercentage": 25.00, "totalGoalsScored": 21, "averageGoalsScored": 1.05 }, "awayTeam": { "win": 5, "winningPercentage": 25.00, "draw": 9, "drawPercentage": 45.00, "lose": 6, "losingPercentage": 30.00, "totalGoalsScored": 18, "averageGoalsScored": 0.9 } }, "finalScore": { "homeTeam": { "win": 8, "winningPercentage": 40.00, "draw": 6, "drawPercentage": 30.00, "lose": 6, "losingPercentage": 30.00, "totalGoalsScored": 38, "averageGoalsScored": 1.9 }, "awayTeam": { "win": 6, "winningPercentage": 30.00, "draw": 6, "drawPercentage": 30.00, "lose": 8, "losingPercentage": 40.00, "totalGoalsScored": 34, "averageGoalsScored": 1.7 } } } } }, "date": "31/01/2024 20:15:00", "id": 1683239, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "2023/2024 Season", "shortName": "23/24", "id": 50277 }, "round": { "name": "Round 22", "shortName": "R22", "id": 22 } }

Response Output Definitions

match

Data

Type

Example

Description

INT

1456414

The id of the match

date

DATE/STR

31/10/2020 17:30:00

The kick-off date of the match, also includes the time

tournament

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

homeTeam/awayTeam

Data	Type	Example	Description
name	STR	West Ham United	The full name of the homeTeam/awayTeam
shortName	STR	WHU	The short name of the homeTeam/awayTeam
mediumName	STR	West Ham	The medium name of the homeTeam/awayTeam
id	INT	381	The id of the homeTeam/awayTeam

status

Data	Type	Example	Description
name	STR	Scheduled	The name of the status
shortName	STR	SCH	The short name of the status
id	INT	1	The id of the status

h2h

resultStatistics

overall/home/away

halfTime/ordinaryTime/finalScore

homeTeam/awayTeam

Data	Type	Example	Description
win	INT	7	Total win count of the home/away team
winningPercentage	INT	35.00	The winning percentage of the homeTeam/awayTeam
draw	INT	6	Total draw count of the homeTeam/awayTeam
drawPercentage	INT	30.00	The draw percentage of the homeTeam/awayTeam
lose	INT	7	Total lose count of the homeTeam/awayTeam
losingPercentage	INT	35.00	The lose percentage of the homeTeam/awayTeam
totalGoalsScored	INT	17	Total goals scored of the homeTeam/awayTeam
averageGoalsScored	INT	0.85	The average goals scored of the homeTeam/awayTeam

stage

Data	Type	Example	Description
name	STR	Season 2020/2021	The name of the stage
shortName	STR	20/21	The short name of the stage
id	INT	42532	The id of the stage

round

Data	Type	Example	Description
name	STR	Round 7	The name of the round
shortName	STR	W7	The short name of the round
id	INT	7	The id of the round

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 Result Statistics

Soccer Result Statistics Request URL

References / Dependencies

Call Rate / Interval

Request Headers

Request Parameters

Response Output

Response Output Definitions

match

tournament

homeTeam/awayTeam

status

h2h

resultStatistics

overall/home/away

halfTime/ordinaryTime/finalScore

homeTeam/awayTeam

stage

round