General parameters for Integration of API and sports event results data

.

This page provides documentation for the integration of api sports matches that have already ended. Our company provides the results for sports events after the match, namely the data (score) with which a match was ended.

Previous information and prices for sports match results can be found on the link.

Sports results are available in 50 different languages. This way you can get almost any translation you need.

How do I get access to integrate results into sports?

The results of sporting events are not available in test mode.


General parameters integration sport results api

Parameter Description
{HOST_REZULT_API} personal url/domain for integrating results. You can get it from your .administrator.
v1 Version of API
{LANG} Language of outcome ( variants of supported language constant -> here)
getsports Parameter that indicates for taking the list of types of sports
{TIME} A day for which results are needed. By default 0, this data is taken for today. If we replace timestamp (format: 1571170323) - data is taken for a specific day.
getchamps Parameter, which indicates taking the championship list
getgames A parameter that indicates that a list of games with results is taken. This includes both the main game and the additional game.

I don't want to pay, but I want to try sports results

In this case, we provide 3 data files that you can download and work with. The format of the json object is no different from the final one. You can download them at the links below: Data on one championship from football for 12.04.2020

  • Sports list file on request: ({HOST_REZULT_API}/v1/rez/getsports/en/1586735224)
  • Championships list file to request: ({HOST_REZULT_API}/v1/rez/getchamps/en/1586735224/1)
  • Match list file to request: ({HOST_REZULT_API}/v1/rez/getsports/en/1586735224)
  • Specific match file on request: ({HOST_REZULT_API}/v1/rez/getgame/en/1586735224/232117552)

TAKING THE LIST OF SPORTS:
Description Parameter
Type of sending data GET
Url to which the request is sent {HOST_REZULT_API}v1/rez/getsports/{LANG}/{TIME}

Example of a link to send:

		
			Example: url for today’s data:

			https://url_host/v1/rez/getsports/ru/0
			
			
			Example: url for data for June 23, 2019:

			https://url_host/v1/rez/getsports/ru/1561238550
		
	

Answer of data:

Parameter Description
status Status of the answer. Successful if it is 1
error Description of a mistakeat return of data
body Data of the answer for types of sport
		
			{
				"status": 1,
				"error": "",
				"body": [{
						"Id": 5,
						"Name": "Baseball"
					},
					{
						"Id": 1,
						"Name": "Football"
					},
					{
						"Id": 3,
						"Name": "Basketball"
					},
					{
						"Id": 4,
						"Name": "Tennis"
					},
					{
						"Id": 7,
						"Name": "Rugby"
					},
					{
						"Id": 2,
						"Name": "Hockey"
					},
					{
						"Id": 6,
						"Name": "Volleyball"
					}
				]
			}


		
	

Description Parameter response data OK:

Parameter Description
Id sport id
Name Name of the sport
TAKING OF THE LIST OF THE CHAMPIONSHIPS:
Description Parameter
Type of sending data GET
Url to which the request is sent {HOST_REZULT_API}/v1/rez/getchamps/{LANG}/{TIME}/{SPORT_ID}
{SPORT_ID} sport id

Example of a link to send:

		
			Example: url for hockey championships today:
			https://url_host/v1/rez/getchamps/ru/0/2
			
			
			Example: url to display Hockey championships for June 23, 2019:
			https://url_host/v1/rez/getchamps/ru/1561238550/2
		
	

Answer of data:

Parameter Description
status Status of the answer. Successful if it is 1
error Description of a mistakewhen data is returned
body Data of the answer of types of sport
		
			{
				"status": 1,
				"error": "",
				"body": [{
						"Id": 09055,
						"Name": "KHL"
					},
					{
						"Id": 000619,
						"Name": "NHL"
					},
					{
						"Id": 19000152,
						"Name": "3HL League"
					},
					{
						"Id": 0006897,
						"Name": "3x3 Short league"
					},
					{
						"Id": 0006327,
						"Name": "Dream League. East"
					},
					{
						"Id": 00033,
						"Name": "Alpine Hockey League"
					},
					{
						"Id": 00902,
						"Name": "KHL. Duel of players. Points"
					},
					{
						"Id": 00103,
						"Name": "League Pro. Moscow"
					}

					{
						"Id": 000275,
						"Name": "German Championship. Oberliga North"
					},
					{
						"Id": 00219,
						"Name": "German Championship. Oberliga South"
					}

				]
			}


		
	

Description of OK response data parameters:

Parameter Description
Id Championship id
Name Name of the championship
TAKING THE SPORTS GAMES LIST:
Description Parameter
Type of sending data GET
Url to which the request is sent {HOST_REZULT_API}/v1/rez/getgames/{LANG}/{TIME}/{SPORT_ID}/{CHAMP_ID}
{SPORT_ID} Sport id
{CHAMP_ID} Championship id

Example of a link to send:

		
			Example: url to display the results of football games from the championship: Championship of England. Premier League, today:
			https://url_host/v1/rez/getgames/ru/0/1/88637
			
			
			Example: url to display the results of football games from the championship: Championship of England. Premier League, June 23, 2019:
			1561238550 - timestamp June 23rd, 2019
			
			
			https://url_host/v1/rez/getgames/ru/1561238550/1/88637
		
	

Answer of data:

Parameter Description
status Status of the answer. Successful if it is 1
error Description of a mistakewhen data is returned
body Data of the answer of types of sport
		
			{

			"status": 1,
			"error": "",
			"body": [{

					"Id": 211867509,
					"Name": "Southampton - Leicester City",
					"Start": 1572029100,
					"Score": "0: 9 (0: 5.0: 4)",
					"Ext": [{
							"Id": 211867523,
							"Name": "Southampton - Leicester City [Corner]",
							"Start": 1572029100,
							"Score": "2: 7 (0: 2.2: 5)"
						},{
							"Id": 211869750,
							"Name": "Southampton - Leicester City [Yellow cards]",
							"Start": 1572030000,
							"Score": "0: 0 (0: 0,0: 0)"
						},{
							"Id": 211867528,
							"Name": "Southampton - Leicester City [Shots on Goal]",
							"Start": 1572029100,
							"Score": "3:15 (1: 8.2: 7)"
						},{
							"Id": 211796748,
							"Name": "Southampton - Leicester City [Substitutions]",
							"Start": 1572030000,
							"Score": "3: 2 (0: 0.3: 2)"
						},{
							“Id”: 211689457,
							“Name”: “Southampton - Leicester City[Alternative outcomes”, “Start”: 1572030000, “Score”: “Total match: 147 points.\NPerformance team 1: -4 points.\NPerformance team 2: 116 points.\nCards team 1: 25 points.\nCards team 2: 0 points.\n Points, first 5 minutes: 0 points.\n Base: 0 points.\n Angle: 0 points.\n Cards: 0 points."
							},{
								"Id": 211869604,
								"Name": "Southampton - Leicester City [What's Before]",
								"Start": 1572030000,
								"Score": "0: 0 (0: 0,0: 0)"
							},{
								"Id": 211867529,
								"Name": "Southampton - Leicester City [Shots on goal]",
								"Start": 1572029100,
								"Score": "6:25 (2: 15.4: 10)"
							}
						]
					}
				]
			}


		
	

Description of parameters of data of answer OK

Parameter Description
Id game id
Name name of teams
Start match time
Score results of a match. Recording format:main score,additional times, periods
Ext Additional events.Massif from the list of additional games, according to this match (Angular, yellow, red, etc.)
Take one particular game:
Description Parameter
Type of data sending GET
Url to which the request is sent {HOST_REZULT_API}/v1/rez/getgame/{LANG}/{DATE}/{GAME_ID}

Example link for submission:

		
			Example: url for April 14, 2020 data:

			https://url_host/v1/rez/getgame/en/1586735224/232117552
		
	

Data response:

Parameter Description
status Answer status. Successful if it is 1.
error Error description when returning data
body Sports response data
		
			{
    "status": 1,
    "error": "",
    "body": {
        "Id": 232117552,
        "Name": "Lecce (SRL) - Lazio (SRL)",
        "Start": 1586687400,
        "Score": "1:2 (1:1,0:1)",
        "Ext": [
            {
                "Id": 232117550,
                "Name": "Lecce (SRL) - Lazio (SRL) [Corners]",
                "Start": 1586687400,
                "Score": "4:4 (1:2,3:2)"
            },
            {
                "Id": 232117546,
                "Name": "Lecce (SRL) - Lazio (SRL) [Yellow Cards]",
                "Start": 1586687400,
                "Score": "2:3 (1:0,1:3)"
            },
            {
                "Id": 232118231,
                "Name": "Lecce (SRL) - Lazio (SRL) [Shots On Target]",
                "Start": 1586687400,
                "Score": "4:4 (3:1,1:3)"
            },
            {
                "Id": 232118226,
                "Name": "Lecce (SRL) - Lazio (SRL) [Offsides]",
                "Start": 1586687400,
                "Score": "2:1 (1:0,1:1)"
            },
            {
                "Id": 232118233,
                "Name": "Lecce (SRL) - Lazio (SRL) [Goal kicks]",
                "Start": 1586687400,
                "Score": "13:10 (9:3,4:7)"
            },
            {
                "Id": 232118244,
                "Name": "Lecce (SRL) - Lazio (SRL) [Throw-ins]",
                "Start": 1586687400,
                "Score": "16:23 (5:14,11:9)"
            },
            {
                "Id": 232118080,
                "Name": "Lecce (SRL) - Lazio (SRL) [First To Happen]",
                "Start": 1586687400,
                "Score": "0:0 (0:0,0:0)"
            }
        ]
    }
}