get_surface_splits

3 creditsMulti-tablePOST /v1/get_surface_splits

A player's record by surface: sets, games, tiebreaks, deciding sets

Use it when you want how a player does on hard, clay and grass: wins, sets, games, tiebreaks and deciding sets.

Parameters

player_idstringrequired: Player id from search_players.
seasonstring | numberoptional: Year (default the whole career).
by_seasonbooleanoptional: Split each surface by season.

Notes

Over MCP, ask for it in plain English and the client calls get_surface_splits itself. Point any MCP client at https://mcp.tiebreakapi.com/mcp?key=YOUR_API_KEY.
Each call costs 3 credits, taken before it runs and refunded if the server errors.
Not the call you need? Find the right call by what you are trying to answer.

Request

curl -X POST https://mcp.tiebreakapi.com/v1/get_surface_splits \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "player_id": "3782"
}'

Response

json

{
  "tour": "ATP",
  "player_id": "3782",
  "name": "Carlos Alcaraz",
  "season": null,
  "overall": {
    "wins": 306,
    "losses": 69,
    "win_pct": 0.816,
    "sets_won": 736,
    "sets_lost": 257,
    "games_won": 5611,
    "games_lost": 4060,
    "games_won_pct": 0.58,
    "tiebreaks_won": 101,
    "tiebreaks_lost": 64,
    "deciding_sets": 99,
    "deciding_sets_won": 70,
    "sets_won_6_0": 24,
    "sets_lost_0_6": 2,
    "wins_by_retirement": 9,
    "retired_or_lost_to_ret": 3
  },
  "splits": [
    {
      "surface": "hard",
      "wins": 167,
      "losses": 46,
      "win_pct": 0.784,
      "sets_won": 398,
      "sets_lost": 145,
      "games_won": 3081,
      "games_lost": 2247,
      "games_won_pct": 0.578,
      "tiebreaks_won": 53,
      "tiebreaks_lost": 39,
      "deciding_sets": 53,
      "deciding_sets_won": 32,
      "sets_won_6_0": 12,
      "sets_lost_0_6": 2,
      "wins_by_retirement": 8,
      "retired_or_lost_to_ret": 2
    },
    {
      "surface": "clay",
      "wins": 104,
      "losses": 19,
      "win_pct": 0.846,
      "sets_won": 242,
      "sets_lost": 80,
      "games_won": 1804,
      "games_lost": 1262,
      "games_won_pct": 0.588,
      "tiebreaks_won": 35,
      "tiebreaks_lost": 17,
      "deciding_sets": 38,
      "deciding_sets_won": 30,
      "sets_won_6_0": 11,
      "sets_lost_0_6": 0,
      "wins_by_retirement": 1,
      "retired_or_lost_to_ret": 1
    },
    {
      "surface": "grass",
      "wins": 35,
      "losses": 4,
      "win_pct": 0.897,
      "sets_won": 96,
      "sets_lost": 32,
      "games_won": 726,
      "games_lost": 551,
      "games_won_pct": 0.569,
      "tiebreaks_won": 13,
      "tiebreaks_lost": 8,
      "deciding_sets": 8,
      "deciding_sets_won": 8,
      "sets_won_6_0": 1,
      "sets_lost_0_6": 0,
      "wins_by_retirement": 0,
      "retired_or_lost_to_ret": 0
    }
  ],
  "ratings": {
    "clay": {
      "rating": 2247,
      "matches": 121
    },
    "grass": {
      "rating": 2135,
      "matches": 39
    },
    "hard": {
      "rating": 2215,
      "matches": 203
    }
  }
}