Tennis API Version - 2.9.4

Welcome to the Tennis API service documentation page. Please see the whole list of techniques listed below for real-time tennis data that will help you create fantastic applications.

Events Types

Method

GET/POST api.api-tennis.com/tennis/?method=get_events

Returns list of supported tournaments types included in your current subscription plan.

Parameters

Parameter	Description
method	API method name
APIkey	Authorization code generated from your api tennis account

Request URL

https://api.api-tennis.com/tennis/?method=get_events&APIkey=!_your_account_APIkey_!

JSON Response

{
	"success": 1,
	"result": [
		{
			"event_type_key": "267",
			"event_type_type": "Atp Doubles"
		},
		{
			"event_type_key": "265",
			"event_type_type": "Atp Singles"
		},
		{
			"event_type_key": "279",
			"event_type_type": "Boys Doubles"
		},
		{
			"event_type_key": "277",
			"event_type_type": "Boys Singles"
		},
		{
			"event_type_key": "282",
			"event_type_type": "Challenger Men Doubles"
		},
		{
			"event_type_key": "281",
			"event_type_type": "Challenger Men Singles"
		},
		{
			"event_type_key": "275",
			"event_type_type": "Challenger Women Doubles"
		},
        ............
   ]
}

PHP call example

$APIkey=!_your_account_APIkey_!;

   $curl_options = array(
     CURLOPT_URL => "https://api.api-tennis.com/tennis/?method=get_events&APIkey=$APIkey",
     CURLOPT_RETURNTRANSFER => true,
     CURLOPT_HEADER => false,
     CURLOPT_TIMEOUT => 30,
     CURLOPT_CONNECTTIMEOUT => 5
   );

   $curl = curl_init();
   curl_setopt_array( $curl, $curl_options );
   $result = curl_exec( $curl );

   $result = (array) json_decode($result);

   var_dump($result);

Tournaments

Method

GET/POST api.api-tennis.com/tennis/?method=get_tournaments

Returns list of supported tournaments included in your current subscription plan.

Parameters

Parameter	Description
method	API method name
APIkey	Authorization code generated from your api tennis account

Request URL

https://api.api-tennis.com/tennis/?method=get_tournaments&APIkey=!_your_account_APIkey_!

JSON Response

{
	"success": 1,
	"result": [
		{
			"tournament_key": "2833",
			"tournament_name": "Aachen",
			"event_type_key": "281",
			"event_type_type": "Challenger Men Singles"
		},
		{
			"tournament_key": "3872",
			"tournament_name": "Abu Dhabi",
			"event_type_key": "266",
			"event_type_type": "Wta Singles"
		},
		{
			"tournament_key": "2801",
			"tournament_name": "Abu Dhabi",
			"event_type_key": "276",
			"event_type_type": "Exhibition Women"
		},
		{
			"tournament_key": "2655",
			"tournament_name": "Abu Dhabi",
			"event_type_key": "283",
			"event_type_type": "Exhibition Men"
		},
		{
			"tournament_key": "2130",
			"tournament_name": "Acapulco",
			"event_type_key": "266",
			"event_type_type": "Wta Singles"
		},
		{
			"tournament_key": "2131",
			"tournament_name": "Acapulco",
			"event_type_key": "265",
			"event_type_type": "Atp Singles"
		},
        ............
   ]
}

PHP call example

$APIkey=!_your_account_APIkey_!;

   $curl_options = array(
     CURLOPT_URL => "https://api.api-tennis.com/tennis/?method=get_tournaments&APIkey=$APIkey",
     CURLOPT_RETURNTRANSFER => true,
     CURLOPT_HEADER => false,
     CURLOPT_TIMEOUT => 30,
     CURLOPT_CONNECTTIMEOUT => 5
   );

   $curl = curl_init();
   curl_setopt_array( $curl, $curl_options );
   $result = curl_exec( $curl );

   $result = (array) json_decode($result);

   var_dump($result);

Fixtures

Method

GET/POST api.api-tennis.com/tennis/?method=get_fixtures

Returns tennis fixtures included in your current subscription plan

Parameters

Parameter	Description
method	API method name
APIkey	Authorization code generated from your api tennis account
date_start	Start date (yyyy-mm-dd)
date_stop	Stop date (yyyy-mm-dd)
event_type_key	Event Type Key - if set only matches from specific tennis event type will be returned (Optional)
tournament_key	Tournament Key - if set only matches from specific tennis tournament will be returned (Optional)
match_key	Match Key - if set only details from specific tennis match will be returned (Optional)
player_key	Player Key - if set only details from specific tennis player will be returned (Optional)
timezone	The timezone where you want to receive the data in tz format (exemple: America/New_York). Default timezone: Europe/Berlin (Optional)

Request URL

https://api.api-tennis.com/tennis/?method=get_fixtures&APIkey=!_your_account_APIkey_!&date_start=2019-07-24&date_stop=2019-07-24

JSON Response

       {
    "success": 1,
    "result": [
        {
            "event_key": "143104",
            "event_date": "2022-06-17",
            "event_time": "18:00",
            "event_first_player": "M. Navone",
            "first_player_key": "949",
            "event_second_player": "C. Gomez-Herrera",
            "second_player_key": "3474",
            "event_final_result": "-",
            "event_game_result": "-",
            "event_serve": null,
            "event_winner": null,
            "event_status": "",
            "event_type_type": "Challenger Men Singles",
            "tournament_name": "Corrientes Challenger Men",
            "tournament_key": "2646",
            "tournament_round": "",
            "tournament_season": "2022",
            "event_live": "0",
            "event_qualification": "False",
            "event_first_player_logo": null,
            "event_second_player_logo": "https://api.api-tennis.com/logo-tennis/3474_c-gomez-herrera.jpg",
            "pointbypoint": [],
            "scores": []
        },
        {
            "event_key": "143113",
            "event_date": "2022-06-17",
            "event_time": "01:05",
            "event_first_player": "C. Chidekh",
            "first_player_key": "7102",
            "event_second_player": "M. Cassone",
            "second_player_key": "12744",
            "event_final_result": "2 - 0",
            "event_game_result": "-",
            "event_serve": null,
            "event_winner": "First Player",
            "event_status": "Finished",
            "event_type_type": "Itf Men Singles",
            "tournament_name": "ITF M25 Wichita, KS Men",
            "tournament_key": "4195",
            "tournament_round": "",
            "tournament_season": "2022",
            "event_live": "0",
            "event_first_player_logo": null,
            "event_second_player_logo": null,
            "pointbypoint": [
                {
                    "set_number": "Set 1",
                    "number_game": "1",
                    "player_served": "First Player",
                    "serve_winner": "First Player",
                    "serve_lost": null,
                    "score": "1 - 0",
                    "points": [
                        {
                            "number_point": "1",
                            "score": "15 - 0",
                            "break_point": null,
                            "set_point": null,
                            "match_point": null
                        },
                      .........
                    ],
                },
                ...........
              ],
              "scores": [
                {
                    "score_first": "6",
                    "score_second": "4",
                    "score_set": "1"
                },
                {
                    "score_first": "6",
                    "score_second": "2",
                    "score_set": "2"
                }
              ]
          }
      }
  ]
}

PHP call example

$APIkey=!_your_account_APIkey_!;
    $date_start = '2022-03-15';
    $date_stop = '2022-03-15';

    $curl_options = array(
      CURLOPT_URL => "https://api.api-tennis.com/tennis/?method=get_fixtures&APIkey=$APIkey&date_start=$date_start&date_stop=$date_stop",
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_HEADER => false,
      CURLOPT_TIMEOUT => 30,
      CURLOPT_CONNECTTIMEOUT => 5
    );

    $curl = curl_init();
    curl_setopt_array( $curl, $curl_options );
    $result = curl_exec( $curl );

    $result = (array) json_decode($result);

    var_dump($result);

Livescore

Method

GET/POST api.api-tennis.com/tennis/?method=get_livescore

Returns tennis now playing events included in your current subscription plan.

Parameters

Parameter	Description
method	API method name
APIkey	Authorization code generated from your api tennis account
event_type_key	Event Type Key - if set only matches from specific tennis event type will be returned (Optional)
tournament_key	Tournament Key - if set only matches from specific tennis tournament will be returned (Optional)
match_key	Match Key - if set only details from specific tennis match will be returned (Optional)
player_key	Player Key - if set only details from specific tennis player will be returned (Optional)
timezone	The timezone where you want to receive the data in tz format (exemple: America/New_York). Default timezone: Europe/Berlin (Optional)

Request URL

https://api.api-tennis.com/tennis/?method=get_livescore&APIkey=!_your_account_APIkey_!

JSON Response

{
    "success": 1,
    "result": [
        {
            "event_key": "143192",
            "event_date": "2022-06-17",
            "event_time": "10:10",
            "event_first_player": "S. Bejlek",
            "first_player_key": "9393",
            "event_second_player": "R. Zarazua",
            "second_player_key": "1805",
            "event_final_result": "0 - 0",
            "event_game_result": "0 - 0",
            "event_serve": "First Player",
            "event_winner": null,
            "event_status": "Set 1",
            "event_type_type": "Itf Women Singles",
            "tournament_name": "ITF W60 Ceska Lipa Women",
            "tournament_key": "4210",
            "tournament_round": "",
            "tournament_season": "2022",
            "event_live": "1",
            "event_first_player_logo": null,
            "event_second_player_logo": "https://api.tennis.com/logo-tennis/1805_r-zarazua.jpg",
            "event_qualification": "False",
            "pointbypoint": [
                {
                    "set_number": "Set 1",
                    "number_game": "1",
                    "player_served": "First Player",
                    "serve_winner": "First Player",
                    "serve_lost": null,
                    "score": "1 - 0",
                    "points": [
                        {
                            "number_point": "1",
                            "score": "15 - 0",
                            "break_point": null,
                            "set_point": null,
                            "match_point": null
                        },
                        .............
                    ],
                },
                .............
            ],
            "scores": [
                {
                    "score_first": "5",
                    "score_second": "5",
                    "score_set": "1"
                }
            ]
        }
    ]
    .......
}

PHP call example

$APIkey=!_your_account_APIkey_!;

 $curl_options = array(
   CURLOPT_URL => "https://api.api-tennis.com/tennis/?method=get_livescore&APIkey=$APIkey",
   CURLOPT_RETURNTRANSFER => true,
   CURLOPT_HEADER => false,
   CURLOPT_TIMEOUT => 30,
   CURLOPT_CONNECTTIMEOUT => 5
 );

 $curl = curl_init();
 curl_setopt_array( $curl, $curl_options );
 $result = curl_exec( $curl );

 $result = (array) json_decode($result);

 var_dump($result);

H2H (Head to Head)

Method

GET/POST api.api-tennis.com/tennis/?method=get_H2H

Returns the last games between submiteted players and the last games of each player

Parameters

Parameter	Description
action	API method name
APIkey	Authorization code generated from your api tennis account
first_player_key	First player Key
second_player_key	Second player Key

Request URL

https://api.api-tennis.com/tennis/?method=get_H2H&APIkey=!_your_account_APIkey_!&first_player_key=30&second_player_key=5

JSON Response

{
	"success": 1,
	"result": {
		"H2H": [],
		"firstPlayerResults": [
			{
				"event_key": "112163",
				"event_date": "2022-05-11",
				"event_time": "15:00",
				"event_first_player": "Cervantes Tomas/ Ferrer Adria",
				"first_player_key": "2616",
				"event_second_player": "Kravchenko/ Reymond",
				"second_player_key": "2316",
				"event_final_result": "0 - 2",
				"event_game_result": "-",
				"event_serve": null,
				"event_winner": "Second Player",
				"event_status": "Finished",
				"event_type_type": "Itf Men Doubles",
				"tournament_name": "ITF M15 Ulcinj Men",
				"tournament_key": "4561",
				"tournament_round": "ITF M15 Ulcinj Men - 1/8-finals",
				"tournament_season": "2022",
				"event_live": "0",
				"event_first_player_logo": null,
				"event_second_player_logo": null
			},
			....
			secondPlayerResults": [
			{
				"event_key": "94804",
				"event_date": "2022-05-11",
				"event_time": "15:10",
				"event_first_player": "Lopez San Martin/ Rincon",
				"first_player_key": "2139",
				"event_second_player": "Regas/ Vasershtein",
				"second_player_key": "2617",
				"event_final_result": "2 - 0",
				"event_game_result": "-",
				"event_serve": null,
				"event_winner": "First Player",
				"event_status": "Finished",
				"event_type_type": "Itf Men Doubles",
				"tournament_name": "ITF M15 Valldoreix Men",
				"tournament_key": "3855",
				"tournament_round": "ITF M15 Valldoreix Men - Quarter-finals",
				"tournament_season": "2022",
				"event_live": "0",
				"event_first_player_logo": null,
				"event_second_player_logo": null
			},
			....
  }

PHP call example

$APIkey=!_your_account_APIkey_!;
    $first_player_key=23;
    $second_player_key=28;

    $curl_options = array(
      CURLOPT_URL => "https://api.api-tennis.com/tennis/?method=get_H2H&APIkey=$APIkey&first_player_key=$firstPlayerKey&second_player_key=$secondPlayerKey",
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_HEADER => false,
      CURLOPT_TIMEOUT => 30,
      CURLOPT_CONNECTTIMEOUT => 5
    );

    $curl = curl_init();
    curl_setopt_array( $curl, $curl_options );
    $result = curl_exec( $curl );

    $result = (array) json_decode($result);

    var_dump($result);

Standings

Method

GET/POST api.api-tennis.com/tennis/?method=get_standings

Returns standings for tennis tournaments included in your current subscription plan.

Parameters

Parameter	Description
action	API method name
APIkey	Authorization code generated from your api tennis account
event_type	'ATP' or 'WTA'

Request URL

https://api.api-tennis.com/tennis/?method=get_standings&event_type=WTA&APIkey=!_your_account_APIkey_!

JSON Response

{
	"success": 1,
	"result": [
		{
			"place": "1",
			"player": "Iga Swiatek",
			"player_key": "1910",
			"league": "WTA",
			"movement": "same",
			"country": "Poland",
			"points": "8501"
		},
		{
			"place": "2",
			"player": "Anett Kontaveit",
			"player_key": "2388",
			"league": "WTA",
			"movement": "same",
			"country": "Estonia",
			"points": "4476"
		},
		{
			"place": "3",
			"player": "Maria Sakkari",
			"player_key": "2076",
			"league": "WTA",
			"movement": "down",
			"country": "Greece",
			"points": "4190"
		},
		.....
}

PHP call example

$APIkey=!_your_account_APIkey_!;
     $event_type = 'ATP';

     $curl_options = array(
       CURLOPT_URL => "https://api.api-tennis.com/tennis/?method=get_standings&APIkey=$APIkey&event_type=$league_key",
       CURLOPT_RETURNTRANSFER => true,
       CURLOPT_HEADER => false,
       CURLOPT_TIMEOUT => 30,
       CURLOPT_CONNECTTIMEOUT => 5
     );

     $curl = curl_init();
     curl_setopt_array( $curl, $curl_options );
     $result = curl_exec( $curl );

     $result = (array) json_decode($result);

     var_dump($result);

Players

Method

GET/POST api.api-tennis.com/tennis/?method=get_players

Returns tennis players profile.

Parameters

Parameter	Description
action	API method name
APIkey	Authorization code generated from your api tennis account
player_key	Player internal code
tournament_key	Tournament internal code

Request URL

https://api.api-tennis.com/tennis/?method=get_players&player_key=137&APIkey=!_your_account_APIkey_!

JSON Response

{
	"success": 1,
	"result": [
		{
			"player_key": "1905",
			"player_name": "N. Djokovic",
			"player_country": "Serbia",
			"player_bday": "22.05.1987",
			"player_logo": "https://api.api-tennis.com/logo-tennis/1905_n-djokovic.jpg",
			"stats": [
				{
					"season": "2021",
					"type": "doubles",
					"rank": "255",
					"titles": "0",
					"matches_won": "6",
					"matches_lost": "4",
					"hard_won": "2",
					"hard_lost": "2",
					"clay_won": "",
					"clay_lost": "",
					"grass_won": "3",
					"grass_lost": "0"
				},
				{
					"season": "2020",
					"type": "doubles",
					"rank": "158",
					"titles": "0",
					"matches_won": "2",
					"matches_lost": "1",
					"hard_won": "2",
					"hard_lost": "1",
					"clay_won": "",
					"clay_lost": "",
					"grass_won": "",
					"grass_lost": ""
				},
        ........
     ]
 }

PHP call example

$APIkey=!_your_account_APIkey_!;
    $player_key = 728;

    $curl_options = array(
     CURLOPT_URL => "https://api.api-tennis.com/tennis?method=get_players&APIkey=$APIkey&player_key=$player_key",
     CURLOPT_RETURNTRANSFER => true,
     CURLOPT_HEADER => false,
     CURLOPT_TIMEOUT => 30,
     CURLOPT_CONNECTTIMEOUT => 5
    );

    $curl = curl_init();
    curl_setopt_array( $curl, $curl_options );
    $result = curl_exec( $curl );

    $result = (array) json_decode($result);

    var_dump($result);

Odds

Method

GET/POST api.api-tennis.com/tennis?method=get_odds

Returns odds for tennis matches included in your current subscription plan.

Parameters

Parameter	Description
method	API method name
APIkey	Authorization code generated from your api tennis account
date_start	Start date (yyyy-mm-dd)
date_stop	Stop date (yyyy-mm-dd)
event_type_key	Event Type Key - if set only matches from specific tennis event type will be returned (Optional)
tournament_key	Tournament Key - if set only matches from specific tennis tournament will be returned (Optional)
match_key	Match Key - if set only details from specific tennis match will be returned (Optional)

Request URL

https://api.api-tennis.com/tennis/?method=get_odds&match_key=159923&APIkey=!_your_account_APIkey_!

JSON Response

{
	"success": 1,
	"result": {
		"159923": {
			"Home/Away": {
				"Home": {
					"bwin": "2.40",
					"bet365": "2.50",
					"Betsson": "2.45",
					"1xbet": "2.50",
					"Sportingbet": "2.40",
					"Betcris": "2.43"
				},
				"Away": {
					"bwin": "1.48",
					"bet365": "1.50",
					"Betsson": "1.48",
					"1xbet": "1.51",
					"Sportingbet": "1.48",
					"Betcris": "1.48"
				}
			},
			"Correct Score 1st Half": {
				"6:0": {
					"bet365": "51.00",
					"1xbet": "51.00"
				},
				"6:1": {
					"bet365": "19.00",
					"1xbet": "19.00"
				},
				"6:2": {
					"bet365": "15.00",
					"1xbet": "15.00"
				},
				"0:6": {
					"bet365": "26.00",
					"1xbet": "26.00"
				},
				"1:6": {
					"bet365": "12.00",
					"1xbet": "12.00"
				},
				"2:6": {
					"bet365": "7.00",
					"1xbet": "7.00"
				},
				"4:6": {
					"bet365": "5.50",
					"1xbet": "5.50"
				},
				"3:6": {
					"bet365": "7.00",
					"1xbet": "7.00"
				},
				"6:3": {
					"bet365": "8.00",
					"1xbet": "8.00"
				},
				"6:4": {
					"bet365": "9.50",
					"1xbet": "9.50"
				},
				"7:5": {
					"bet365": "19.00",
					"1xbet": "19.00"
				},
				"7:6": {
					"bet365": "12.00",
					"1xbet": "12.00"
				},
				"5:7": {
					"bet365": "15.00",
					"1xbet": "15.00"
				},
				"6:7": {
					"bet365": "10.00",
					"1xbet": "10.00"
				}
			},
			"Home/Away (1st Set)": {
				"Home": {
					"bet365": "2.37",
					"1xbet": "2.36"
				},
				"Away": {
					"bet365": "1.53",
					"1xbet": "1.55"
				}
			},
			"Set Betting": {
				"2:0": {
					"bwin": "3.90",
					"bet365": "3.75",
					"1xbet": "3.74",
					"Sportingbet": "3.90",
					"Betcris": "3.80"
				},
				"2:1": {
					"bwin": "5.50",
					"bet365": "6.00",
					"1xbet": "6.00",
					"Sportingbet": "5.50",
					"Betcris": "5.20"
				},
				"0:2": {
					"bwin": "2.10",
					"bet365": "2.10",
					"1xbet": "2.10",
					"Sportingbet": "2.10",
					"Betcris": "2.00"
				},
				"1:2": {
					"bwin": "4.20",
					"bet365": "4.75",
					"1xbet": "4.74",
					"Sportingbet": "4.20",
					"Betcris": "4.10"
				}
			},
			"Win In Straigh Sets (Player 1)": {
				"Yes": {
					"bet365": "3.75"
				},
				"No": {
					"bet365": "1.25"
				}
			},
			"Win In Straigh Sets (Player 2)": {
				"Yes": {
					"bet365": "2.10"
				},
				"No": {
					"bet365": "1.66"
				}
			}
		}
	}

PHP call example

$APIkey=!_your_account_APIkey_!;
 $match_key = 159923;

 $curl_options = array(
   CURLOPT_URL => "https://api.api-tennis.com/tennis/?method=get_odds&&APIkey=$APIkey&match_key=$match_key",
   CURLOPT_RETURNTRANSFER => true,
   CURLOPT_HEADER => false,
   CURLOPT_TIMEOUT => 30,
   CURLOPT_CONNECTTIMEOUT => 5
 );

 $curl = curl_init();
 curl_setopt_array( $curl, $curl_options );
 $result = curl_exec( $curl );

 $result = (array) json_decode($result);

 var_dump($result);