Soccer API Tech Docs

Search in tech docs

Soccer API Market Statistics: Goals

Provides the market goals statistics which are “Both Teams to Score”, “Under/Over” and also “Total Goals” for both two teams against the other teams in the tournament.

Soccer Market Statistics: Goals 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": "West Ham United", "shortName": "WHU", "mediumName": "West Ham", "id": 381 }, "status": { "name": "Scheduled", "shortName": "SCH", "id": 1 }, "h2h": { "marketStatistics": { "overall": { "halfTime": { "doubleChance": { "homeOrDraw": 8, "homeOrDrawPercentage": 80.0, "homeOrAway": 7, "homeOrAwayPercentage": 70.0, "drawOrAway": 5, "drawOrAwayPercentage": 50.0 }, "totalGoals": [ { "from": 0, "to": 1, "count": 5, "percentage": 50.0 }, { "from": 2, "to": 3, "count": 5, "percentage": 50.0 }, { "from": 4, "to": 5, "count": 0, "percentage": 0.0 }, { "from": 6, "count": 0, "percentage": 0.0 } ], "bothTeamsToScore": { "yes": 3, "yesPercentage": 30.0, "no": 7, "noPercentage": 70.0 }, "underOver": [ { "limit": 0.5, "under": 1, "underPercentage": 10.0, "over": 9, "overPercentage": 90.0 }, { "limit": 1.5, "under": 5, "underPercentage": 50.0, "over": 5, "overPercentage": 50.0 }, { "limit": 2.5, "under": 9, "underPercentage": 90.0, "over": 1, "overPercentage": 10.0 }, { "limit": 3.5, "under": 10, "underPercentage": 100.0, "over": 0, "overPercentage": 0.0 }, { "limit": 4.5, "under": 10, "underPercentage": 100.0, "over": 0, "overPercentage": 0.0 } ] }, "ordinaryTime": { "doubleChance": { "homeOrDraw": 10, "homeOrDrawPercentage": 100.0, "homeOrAway": 6, "homeOrAwayPercentage": 60.0, "drawOrAway": 4, "drawOrAwayPercentage": 40.0 }, "totalGoals": [ { "from": 0, "to": 1, "count": 1, "percentage": 10.0 }, { "from": 2, "to": 3, "count": 3, "percentage": 30.0 }, { "from": 4, "to": 5, "count": 6, "percentage": 60.0 }, { "from": 6, "count": 0, "percentage": 0.0 } ], "bothTeamsToScore": { "yes": 6, "yesPercentage": 60.0, "no": 4, "noPercentage": 40.0 }, "underOver": [ { "limit": 0.5, "under": 1, "underPercentage": 10.0, "over": 9, "overPercentage": 90.0 }, { "limit": 1.5, "under": 1, "underPercentage": 10.0, "over": 9, "overPercentage": 90.0 }, { "limit": 2.5, "under": 4, "underPercentage": 40.0, "over": 6, "overPercentage": 60.0 }, { "limit": 3.5, "under": 4, "underPercentage": 40.0, "over": 6, "overPercentage": 60.0 }, { "limit": 4.5, "under": 7, "underPercentage": 70.0, "over": 3, "overPercentage": 30.0 } ] }, "finalScore": { "doubleChance": { "homeOrDraw": 9, "homeOrDrawPercentage": 90.0, "homeOrAway": 7, "homeOrAwayPercentage": 70.0, "drawOrAway": 4, "drawOrAwayPercentage": 40.0 }, "totalGoals": [ { "from": 0, "to": 1, "count": 1, "percentage": 10.0 }, { "from": 2, "to": 3, "count": 3, "percentage": 30.0 }, { "from": 4, "to": 5, "count": 6, "percentage": 60.0 }, { "from": 6, "count": 0, "percentage": 0.0 } ], "bothTeamsToScore": { "yes": 6, "yesPercentage": 60.0, "no": 4, "noPercentage": 40.0 }, "underOver": [ { "limit": 0.5, "under": 1, "underPercentage": 10.0, "over": 9, "overPercentage": 90.0 }, { "limit": 1.5, "under": 1, "underPercentage": 10.0, "over": 9, "overPercentage": 90.0 }, { "limit": 2.5, "under": 3, "underPercentage": 30.0, "over": 7, "overPercentage": 70.0 }, { "limit": 3.5, "under": 4, "underPercentage": 40.0, "over": 6, "overPercentage": 60.0 }, { "limit": 4.5, "under": 7, "underPercentage": 70.0, "over": 3, "overPercentage": 30.0 } ] } }, "home": { "halfTime": { "doubleChance": { "homeOrDraw": 8, "homeOrDrawPercentage": 80.0, "homeOrAway": 6, "homeOrAwayPercentage": 60.0, "drawOrAway": 6, "drawOrAwayPercentage": 60.0 }, "totalGoals": [ { "from": 0, "to": 1, "count": 5, "percentage": 50.0 }, { "from": 2, "to": 3, "count": 5, "percentage": 50.0 }, { "from": 4, "to": 5, "count": 0, "percentage": 0.0 }, { "from": 6, "count": 0, "percentage": 0.0 } ], "bothTeamsToScore": { "yes": 2, "yesPercentage": 20.0, "no": 8, "noPercentage": 80.0 }, "underOver": [ { "limit": 0.5, "under": 3, "underPercentage": 30.0, "over": 7, "overPercentage": 70.0 }, { "limit": 1.5, "under": 5, "underPercentage": 50.0, "over": 5, "overPercentage": 50.0 }, { "limit": 2.5, "under": 8, "underPercentage": 80.0, "over": 2, "overPercentage": 20.0 }, { "limit": 3.5, "under": 10, "underPercentage": 100.0, "over": 0, "overPercentage": 0.0 }, { "limit": 4.5, "under": 10, "underPercentage": 100.0, "over": 0, "overPercentage": 0.0 } ] }, "ordinaryTime": { "doubleChance": { "homeOrDraw": 9, "homeOrDrawPercentage": 90.0, "homeOrAway": 7, "homeOrAwayPercentage": 70.0, "drawOrAway": 4, "drawOrAwayPercentage": 40.0 }, "totalGoals": [ { "from": 0, "to": 1, "count": 2, "percentage": 20.0 }, { "from": 2, "to": 3, "count": 3, "percentage": 30.0 }, { "from": 4, "to": 5, "count": 5, "percentage": 50.0 }, { "from": 6, "count": 0, "percentage": 0.0 } ], "bothTeamsToScore": { "yes": 4, "yesPercentage": 40.0, "no": 6, "noPercentage": 60.0 }, "underOver": [ { "limit": 0.5, "under": 2, "underPercentage": 20.0, "over": 8, "overPercentage": 80.0 }, { "limit": 1.5, "under": 2, "underPercentage": 20.0, "over": 8, "overPercentage": 80.0 }, { "limit": 2.5, "under": 3, "underPercentage": 30.0, "over": 7, "overPercentage": 70.0 }, { "limit": 3.5, "under": 5, "underPercentage": 50.0, "over": 5, "overPercentage": 50.0 }, { "limit": 4.5, "under": 7, "underPercentage": 70.0, "over": 3, "overPercentage": 30.0 } ] }, "finalScore": { "doubleChance": { "homeOrDraw": 9, "homeOrDrawPercentage": 90.0, "homeOrAway": 7, "homeOrAwayPercentage": 70.0, "drawOrAway": 4, "drawOrAwayPercentage": 40.0 }, "totalGoals": [ { "from": 0, "to": 1, "count": 2, "percentage": 20.0 }, { "from": 2, "to": 3, "count": 3, "percentage": 30.0 }, { "from": 4, "to": 5, "count": 5, "percentage": 50.0 }, { "from": 6, "count": 0, "percentage": 0.0 } ], "bothTeamsToScore": { "yes": 4, "yesPercentage": 40.0, "no": 6, "noPercentage": 60.0 }, "underOver": [ { "limit": 0.5, "under": 2, "underPercentage": 20.0, "over": 8, "overPercentage": 80.0 }, { "limit": 1.5, "under": 2, "underPercentage": 20.0, "over": 8, "overPercentage": 80.0 }, { "limit": 2.5, "under": 3, "underPercentage": 30.0, "over": 7, "overPercentage": 70.0 }, { "limit": 3.5, "under": 5, "underPercentage": 50.0, "over": 5, "overPercentage": 50.0 }, { "limit": 4.5, "under": 7, "underPercentage": 70.0, "over": 3, "overPercentage": 30.0 } ] } }, "away": { "halfTime": { "doubleChance": { "homeOrDraw": 5, "homeOrDrawPercentage": 50.0, "homeOrAway": 8, "homeOrAwayPercentage": 80.0, "drawOrAway": 7, "drawOrAwayPercentage": 70.0 }, "totalGoals": [ { "from": 0, "to": 1, "count": 4, "percentage": 40.0 }, { "from": 2, "to": 3, "count": 6, "percentage": 60.0 }, { "from": 4, "to": 5, "count": 0, "percentage": 0.0 }, { "from": 6, "count": 0, "percentage": 0.0 } ], "bothTeamsToScore": { "yes": 4, "yesPercentage": 40.0, "no": 6, "noPercentage": 60.0 }, "underOver": [ { "limit": 0.5, "under": 0, "underPercentage": 0.0, "over": 10, "overPercentage": 100.0 }, { "limit": 1.5, "under": 4, "underPercentage": 40.0, "over": 6, "overPercentage": 60.0 }, { "limit": 2.5, "under": 8, "underPercentage": 80.0, "over": 2, "overPercentage": 20.0 }, { "limit": 3.5, "under": 10, "underPercentage": 100.0, "over": 0, "overPercentage": 0.0 }, { "limit": 4.5, "under": 10, "underPercentage": 100.0, "over": 0, "overPercentage": 0.0 } ] }, "ordinaryTime": { "doubleChance": { "homeOrDraw": 7, "homeOrDrawPercentage": 70.0, "homeOrAway": 8, "homeOrAwayPercentage": 80.0, "drawOrAway": 5, "drawOrAwayPercentage": 50.0 }, "totalGoals": [ { "from": 0, "to": 1, "count": 0, "percentage": 0.0 }, { "from": 2, "to": 3, "count": 5, "percentage": 50.0 }, { "from": 4, "to": 5, "count": 5, "percentage": 50.0 }, { "from": 6, "count": 0, "percentage": 0.0 } ], "bothTeamsToScore": { "yes": 7, "yesPercentage": 70.0, "no": 3, "noPercentage": 30.0 }, "underOver": [ { "limit": 0.5, "under": 0, "underPercentage": 0.0, "over": 10, "overPercentage": 100.0 }, { "limit": 1.5, "under": 0, "underPercentage": 0.0, "over": 10, "overPercentage": 100.0 }, { "limit": 2.5, "under": 4, "underPercentage": 40.0, "over": 6, "overPercentage": 60.0 }, { "limit": 3.5, "under": 5, "underPercentage": 50.0, "over": 5, "overPercentage": 50.0 }, { "limit": 4.5, "under": 8, "underPercentage": 80.0, "over": 2, "overPercentage": 20.0 } ] }, "finalScore": { "doubleChance": { "homeOrDraw": 6, "homeOrDrawPercentage": 60.0, "homeOrAway": 9, "homeOrAwayPercentage": 90.0, "drawOrAway": 5, "drawOrAwayPercentage": 50.0 }, "totalGoals": [ { "from": 0, "to": 1, "count": 0, "percentage": 0.0 }, { "from": 2, "to": 3, "count": 5, "percentage": 50.0 }, { "from": 4, "to": 5, "count": 5, "percentage": 50.0 }, { "from": 6, "count": 0, "percentage": 0.0 } ], "bothTeamsToScore": { "yes": 7, "yesPercentage": 70.0, "no": 3, "noPercentage": 30.0 }, "underOver": [ { "limit": 0.5, "under": 0, "underPercentage": 0.0, "over": 10, "overPercentage": 100.0 }, { "limit": 1.5, "under": 0, "underPercentage": 0.0, "over": 10, "overPercentage": 100.0 }, { "limit": 2.5, "under": 3, "underPercentage": 30.0, "over": 7, "overPercentage": 70.0 }, { "limit": 3.5, "under": 5, "underPercentage": 50.0, "over": 5, "overPercentage": 50.0 }, { "limit": 4.5, "under": 8, "underPercentage": 80.0, "over": 2, "overPercentage": 20.0 } ] } } } }, "date": "31/10/2020 17:30:00", "id": 1456414, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Season 2020/2021", "shortName": "20/21", "id": 42532 }, "round": { "name": "Round 7", "shortName": "W7", "id": 7 } }

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	Liverpool	The full name of the homeTeam/awayTeam
shortName	STR	LIV	The short name of the homeTeam/awayTeam
mediumName	STR	Liverpool	The medium name of the homeTeam/awayTeam
id	INT	265	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

marketStatistics

overall/home/away

halfTime/ordinaryTime/finalScore

totalGoals

Data	Type	Example	Description
from	INT	2	The value of the Goal Count
to	INT	3	The value of the Goal Count
count	INT	5	The count of the goal interval
percentage	DEC	50.0	The percentage of the goal interval

bothTeamsToScore

Data	Type	Example	Description
yes	INT	3	The count of both teams score
yesPercentage	DEC	30.0	The percentage of the both teams score
no	INT	7	The count of both teams doesn't score
noPercentage	DEC	70.0	The percentage of both teams doesn't score

underOver

Data	Type	Example	Description
limit	STR	1.5	The value of the Under/Over
under	INT	5	The count of Under
underPercentage	DEC	50.0	The percetage of Under
over	INT	5	The count of Over
overPercentage	DEC	50.0	The percetage of Over

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+