Follow us :
expectedscore.com

Method for retrieving data of the match

Content:

Retrieving the detailed information of the match

The method is used to get the main parameters of the match (excluding xG parameters). URL: https://offvariance.com/api/public/{format}/match/{id}

An example of a request:
json:
https://offvariance.com/api/public/json/match/15170/?key=demokey
xml:
https://offvariance.com/api/public/xml/match/15170/?key=demokey

Parameters of a request:
Parameter
Description
format
Format of server response data
key
Your API key
id
The identifier of a match
Parameters of a response:
Parameter
Description
id
The identifier of a match in the database
status
Match status:
  • finished - match has ended
  • prepare - match included in the database but not processed yet 
  • preview - preview of the upcoming match 
updateTime
Time and date of the update of a match on the website in Timestamp
startTime
Time and date of the match in Timestamp
homeTeam
Dataset which includes the id and the name of the home team
awayTeam
Dataset which includes the id and the name of the away team
duration
Dataset which sets the data about the duration of the match:
  • total - duration of the whole match
  • firstHalf - duration of the first half
  • secondHalf - duration of the second half
homeScore
Dataset which includes the number of goals scored by the home team during the whole match and during the first half:
  • final - number of goals scored during the whole match
  • firstHalf - number of goals scored during the first half
awayScore
Dataset which includes the number of goals scored by the away team during the whole match and during the first half:
  • final -  number of goals scored during the whole match
  • firstHalf - number of goals scored during the first half
country
Dataset which includes id and the name of the country (id, value)
tournament
Dataset which includes id and the name of the league (division) (id, value)
season
Dataset which includes id and the name of the season (id, value)
round
Dataset which includes id and the name of the round (id, value)
application/json
text/xml 
	{
		"result":{
			"id":15170,
			"status":"finished",
			"startTime":1583161333,
			"updateTime":1583161333,
			"homeTeam":{
				"id":6725,
				"name":"Brighton"
			},
			"awayTeam":{
				"id":6712,
				"name":"Manchester Utd"
			},
			"duration":{
				"total":95,
				"firstHalf":49,
				"secondHalf":46
			},
			"homeScore":{
				"final":3,
				"firstHalf":2
			},
			"awayScore":{
				"final":1,
				"firstHalf":1
			},
			"country":{
				"id":291,
				"value":"Англия"
			},
			"tournament":{
				"id":325,
				"value":"Premier League"
			},
			"season":{
				"id":326,
				"value":"2018/2019"
			},
			"round":{
				"id":522,
				"value":2
			}
		}
	}
				
	 <root>
	     <result>
	        <id>15170</id>
	        <status>finished</status>
	        <updateTime>1583161333</updateTime>
	        <startTime>1583161333</startTime>
	        <homeTeam>
	            <id>6725</id>
	            <name>Brighton</name>
	        </homeTeam>
	        <awayTeam>
	            <id>6712</id>
	            <name>Manchester Utd</name>
	        </awayTeam>
	        <duration>
	            <total>95</total>
	            <firstHalf>49</firstHalf>
	            <secondHalf>46</secondHalf>
	        </duration>
	        <homeScore>
	            <final>3</final>
	            <firstHalf>2</firstHalf>
	        </homeScore>
	        <awayScore>
	            <final>1</final>
	            <firstHalf>1</firstHalf>
	        </awayScore>
	        <country>
	            <id>291</id>
	            <value>Англия</value>
	        </country>
	        <tournament>
	            <id>325</id>
	            <value>Premier League</value>
	        </tournament>
	        <season>
	            <id>326</id>
	            <value>2018/2019</value>
	        </season>
	        <round>
	        <id>522</id>
	        <value>2</value>
	        </round>
	     </result>
	 </root>


Retrieving the list of events of the match

The method is used to get the list of the events of the match. URL: https://offvariance.com/api/public/{format}/match/{id}/events/

An example of a request:
json:
https://offvariance.com/api/public/json/match/15170/events/?key=demokey
xml:
https://offvariance.com/api/public/xml/match/15170/events/?key=demokey

Parameters of a request:
Parameter
Description
format
Format of server response data
key
Your API key
id
The identifier of a match
Parameters of a response:
Parameter
Description
score
Score on the moment of the event
minute
Minute of the event
author
Player who performed the event; dataset with his id and name
idteam
Team which performed the event
type
Type of a shot:
  • not - not specified
  • blocked - block
  • missing - miss
  • goal - goal
  • penal - penalty scored
  • save - save
  • nopenal - penalty missed
  • redcard - red card
  • owngoal - own goal
xg
scored xG
application/json
text/xml 
	{
		"result":[
			{
				"score":"0-0",
				"minute":"7",
				"author":{
					"id":"6787",
					"name":"A. MARTIAL"
				},
				"idcommand":"6712",
				"type":"penal",
				"xg":0.21,
			},
			...
		]
	}
				
	 <root>
	     <result>
	        <element-9>
	            <score>2-1</score>
	            <minute>44</minute>
	            <author>
	                <id>7142</id>
	                <name>P. GROSS</name>
	            </author>
	            <idteam>6725</idteam>
	            <type>penal</type>
	            <xg>0.73</xg>
	        </element-9>
	     </result>
	 </root>