Tennis

Retrieve live tennis match summaries aggregated from multiple data providers. The API automatically merges identical matches from different providers and supports filtering by player names.

Credit Consumption: 5 API call credits per request

Endpoint: GET /v2/sport/tennis/live-summaries

Request

Query Parameters

• date (string) - Optional. Date in YYYY-MM-DD format in UTC timezone. Example: 2025-01-20. If not provided, the current UTC date is used. The minimum date is 5 years before the current UTC date.

• home_player_name (string) - Optional. Filter by home player name. Supports partial matching with normalized names. Example: Nadal

• away_player_name (string) - Optional. Filter by away player name. Supports partial matching with normalized names. Example: Federer

• player_names (string) - Optional. Filter by multiple player names. Supports comma-separated values or repeated parameters. Matches if any name varies from home or away player matches any name in the set. Example: Nadal,Federer,Djokovic or ?player_names=Nadal&player_names=Federer

Filter Logic:

• If both home_player_name and away_player_name are provided, both must match (supports reversed player order)

• If only one is provided, either a home or away player's match is sufficient

• When player_names is used together with home_player_name/away_player_name, OR logic is applied (any condition satisfied)

• Player names are automatically normalized for matching (case-insensitive, punctuation removed, supports different formats like "Lastname, Firstname" and "Firstname Lastname")

• Matching checks all name variants in the names field, including main name and abbreviations

Sample Request

Example 1: Filter by date and home/away player names

curl -X GET "https://api-ai-oracle.apro.com/v2/sport/tennis/live-summaries?date=2025-01-20&home_player_name=Nadal&away_player_name=Federer" \
  -H "accept: application/json"

Example 2: Filter by date and multiple player names

curl -X GET "https://api-ai-oracle.apro.com/v2/sport/tennis/live-summaries?date=2025-01-20&player_names=Nadal,Federer,Djokovic" \
  -H "accept: application/json"

Example 3: Get all matches for a specific date (no filters)

curl -X GET "https://api-ai-oracle.apro.com/v2/sport/tennis/live-summaries?date=2025-01-20" \
  -H "accept: application/json"

Example 4: Get all matches for current date (no date parameter)

curl -X GET "https://api-ai-oracle.apro.com/v2/sport/tennis/live-summaries" \
  -H "accept: application/json"

Sample Response

{
  "status": {
    "timestamp": 1742456976497,
    "code": 200,
    "message": ""
  },
  "data": {
    "live_summaries": [
      {
        "competition_name": "Next Gen ATP Finals Men Singles",
        "start_time": "2025-01-20T14:30:00Z",
        "is_live": true,
        "tournament": {
          "name": "ATP Finals",
          "type": "ATP"
        },
        "season": "2025",
        "round": {
          "name": "Final",
          "number": 7
        },
        "home_player": {
          "name": "Nadal, Rafael",
          "names": ["Nadal, Rafael", "R. Nadal", "Rafael Nadal"],
          "country": "Spain",
          "country_code": "ES",
          "seed": 1,
          "ranking": 2
        },
        "away_player": {
          "name": "Federer, Roger",
          "names": ["Federer, Roger", "R. Federer", "Roger Federer"],
          "country": "Switzerland",
          "country_code": "CH",
          "seed": 2,
          "ranking": 3
        },
        "match_status": "2nd_set",
        "match_type": "singles",
        "winner": "",
        "score": {
          "set_score": {
            "home": 1,
            "away": 0
          },
          "set_scores": [
            {
              "set_number": 1,
              "home_score": 6,
              "away_score": 4,
              "home_tiebreak_score": null,
              "away_tiebreak_score": null
            },
            {
              "set_number": 2,
              "home_score": 3,
              "away_score": 2,
              "home_tiebreak_score": null,
              "away_tiebreak_score": null
            }
          ],
          "current_game": {
            "home_score": 40,
            "away_score": 30,
            "serving": "home",
            "is_tie_break": false
          }
        },
        "provider_ids": {
          "sportradar": "sr:match:123456",
          "rapidapi": "987654",
          "apitennis": "match_key_789"
        }
      }
    ],
    "provider_live_summaries": [
      {
        "provider_name": "sportradar",
        "live_summaries": [
          {
            "competition_name": "Next Gen ATP Finals Men Singles",
            "start_time": "2025-01-20T14:30:00Z",
            "is_live": true,
            "home_player": {
              "name": "Nadal, Rafael",
              "names": ["Nadal, Rafael", "R. Nadal"],
              "country": "Spain",
              "country_code": "ES"
            },
            "away_player": {
              "name": "Federer, Roger",
              "names": ["Federer, Roger", "R. Federer"],
              "country": "Switzerland",
              "country_code": "CH"
            },
            "match_status": "2nd_set",
            "score": {
              "set_score": {
                "home": 1,
                "away": 0
              },
              "set_scores": [
                {
                  "set_number": 1,
                  "home_score": 6,
                  "away_score": 4
                },
                {
                  "set_number": 2,
                  "home_score": 3,
                  "away_score": 2
                }
              ],
              "current_game": {
                "home_score": 40,
                "away_score": 30,
                "serving": "home",
                "is_tie_break": false
              }
            }
          }
        ],
        "count": 1
      }
    ],
    "total_live_summaries": 1,
    "timestamp": "2025-01-20T14:30:00Z",
    "signatures": [
        {
            "signer": "0xf3xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
            "hash": "0xabxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
            "signature": "0xeexxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
            "timestamp": 1767157946010
        }
    ]
  }
}

Response Fields

• live_summaries (array) - Aggregated match summaries from multiple providers. Only matches confirmed by at least 2 providers are included. Data is prioritized by provider order: sportradar > rapidapi > apitennis.

• provider_live_summaries (array) - Raw data from each provider, filtered to only include matches present in live_summaries.

• total_live_summaries (integer) - Total number of aggregated match summaries.

• timestamp (string) - UTC timestamp when the data was generated.

• signatures (array) - Data signatures for blockchain verification. Empty array if no matches are found.

Match Status Values:

• not_started - Match has not started

• 1st_set - First set in progress

• 2nd_set - Second set in progress

• 3rd_set - Third set in progress

• 4th_set - Fourth set in progress (if applicable)

• 5th_set - Fifth set in progress (if applicable)

• finished - Match has finished

• suspended - Match is suspended

• cancelled - Match is cancelled

• postponed - Match is postponed

• delayed - Match is delayed

• interrupted - Match is interrupted

• abandoned - Match is abandoned

• unknown - Match status is unknown

Notes:

• All times are in UTC timezone

• The current_game field in score is only populated when is_live is true, otherwise it is null

• Player name matching is case-insensitive and supports various name formats

• Data aggregation uses a voting mechanism: at least 2 providers must agree on a match for it to be included

• Provider priority ensures consistent results: sportradar data takes precedence over rapidapi, which takes precedence over apitennis