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. Each match also includes pointbypoint, scores and statistics inline (empty arrays when not yet available) — no separate call is needed for a match's set scores or per-player statistics (aces, serve percentages, break points, etc.).

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)
tournament_season	Tournament Season - if set only matches from specific tennis tournament season 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": [],
            "statistics": []
        },
        {
            "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"
                }
              ],
              "statistics": [
                {
                    "player_key": "7102",
                    "stat_period": "match",
                    "stat_type": "Service",
                    "stat_name": "Aces",
                    "stat_value": "4",
                    "stat_won": null,
                    "stat_total": null
                },
                {
                    "player_key": "7102",
                    "stat_period": "match",
                    "stat_type": "Service",
                    "stat_name": "1st serve points won",
                    "stat_value": "64%",
                    "stat_won": 31,
                    "stat_total": 48
                },
                ...........
              ]
          }
      }
  ]
}

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. Like Fixtures, each match includes pointbypoint, scores and statistics inline.

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"
                }
            ],
            "statistics": [
                {
                    "player_key": "9393",
                    "stat_period": "match",
                    "stat_type": "Service",
                    "stat_name": "Double Faults",
                    "stat_value": "2",
                    "stat_won": null,
                    "stat_total": null
                },
                ...........
            ]
        }
    ]
    .......
}

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
method	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
method	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
method	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);

Live Odds

Method

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

Returns tennis live odds for live matches.

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_live_odds&APIkey=!_your_account_APIkey_!

JSON Response

{
    "success": 1,
    "result": {
        "11976653": {
            "event_key": 11976653,
            "event_date": "2024-08-22",
            "event_time": "08:45",
            "first_player_key": 69252,
            "second_player_key": 73380,
            "event_game_result": "30 - 30",
            "event_serve": "First Player",
            "event_winner": null,
            "event_status": "Set 2",
            "event_type_type": "Itf Women Doubles",
            "tournament_name": "ITF W35 Kunshan Women",
            "tournament_key": 11556,
            "tournament_round": "ITF W35 Kunshan Women - Quarter-finals",
            "tournament_season": "2024",
            "event_live": "08:45",
            "event_first_player_logo": null,
            "event_second_player_logo": null,
            "event_qualification": "False",
            "live_odds": [
                {
                    "odd_name": "Set 1 to Break Serve",
                    "suspended": "Yes",
                    "type": "1/Yes",
                    "value": "1.125",
                    "handicap": null,
                    "upd": "2024-08-22 09:15:10"
                },
                {
                    "odd_name": "Set 1 to Break Serve",
                    "suspended": "Yes",
                    "type": "2/Yes",
                    "value": "1.111",
                    "handicap": null,
                    "upd": "2024-08-22 09:15:10"
                },
                ...........
              ]
          },
          .........
      }
}

PHP call example

$APIkey=!_your_account_APIkey_!;

 $curl_options = array(
   CURLOPT_URL => "https://api.api-tennis.com/tennis/?method=get_live_odds&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);

News

Method

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

Returns AI-synthesized tennis news articles about players, tournaments and matches. Available on the Ultra plan only.

An article is linked to every entity it's actually about — a single article can carry a player_key, a tournament_key and an event_key all at once (e.g. a match report is tied to the match itself, the tournament it's part of, and the featured player). Any of these three can independently be null if that dimension wasn't identified for the article. entity_type / entity_key are kept for backwards compatibility and just mirror the single most specific match reflected (priority: match > tournament > player).

Parameters

Parameter	Description
method	API method name
APIkey	Authorization code generated from your api tennis account
player_key	Player Key - returns news about this player, including match reports the player is involved in (Optional)
tournament_key	Tournament Key - returns news about this tournament, including match reports from it (Optional)
match_key	Match Key - returns the news article about this specific match, if one exists (Optional)
date_start	Only return articles published on or after this date, format YYYY-MM-DD (Required)
date_stop	Only return articles published on or before this date, format YYYY-MM-DD (Required)

Request URL

https://api.api-tennis.com/tennis/?method=get_news&player_key=1905&date_start=2026-07-01&date_stop=2026-07-14&APIkey=!_your_account_APIkey_!

JSON Response

{
	"success": 1,
	"result": [
		{
			"news_key": "142",
			"title": "Sinner Defends Wimbledon Crown in Five-Set Thriller",
			"content": "Jannik Sinner successfully defended his Wimbledon title...",
			"published_at": "2026-07-13 09:41:12.000",
			"entity_type": "match",
			"entity_key": "12145144",
			"player_key": "1905",
			"player_name": "J. Sinner",
			"tournament_key": "1234",
			"tournament_name": "Wimbledon",
			"event_key": "12145144",
			"event_result": "3 - 1",
			"event_round": "ATP Wimbledon - Final",
			"sources": ["tennis-majors", "bbc-sport-tennis"]
		},
		.....
	]
}

PHP call example

$APIkey=!_your_account_APIkey_!;
     $player_key = 1905;
     $date_start = '2026-07-01';
     $date_stop = '2026-07-14';

     $curl_options = array(
       CURLOPT_URL => "https://api.api-tennis.com/tennis/?method=get_news&APIkey=$APIkey&player_key=$player_key&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);