Skip to content

get_player

5 creditsStats + aggregationPOST /v1/get_player

Profile, per-season averages and shooting splits, last 10 games

Use it when you are profiling a player: per-season averages and shooting splits, regular season and playoffs, and the last 10 games.

Parameters

player_idstringrequired
ESPN athlete id, from search_players.

Notes

  • Over MCP, ask for it in plain English and the client calls get_player itself. Point any MCP client at https://mcp.dunkapi.com/mcp?key=YOUR_API_KEY.
  • Each call costs 5 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.dunkapi.com/v1/get_player \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "player_id": "4065648"
}'

Response

json
{
  "player": {
    "player_id": "4065648",
    "name": "Jayson Tatum",
    "position": "F",
    "jersey": "0",
    "team_id": "2",
    "team": "BOS",
    "team_name": "Boston Celtics"
  },
  "seasons": [
    {
      "season": 2026,
      "season_type": "regular",
      "teams": "BOS",
      "games": 16,
      "starts": 16,
      "min": 32.6,
      "pts": 21.8,
      "reb": 10,
      "ast": 5.3,
      "stl": 1.4,
      "blk": 0.2,
      "tov": 2.4,
      "oreb": 0.5,
      "dreb": 9.5,
      "pf": 1.6,
      "plus_minus": 7.4,
      "total_pts": 348,
      "fgm": 118,
      "fga": 287,
      "tpm": 47,
      "tpa": 143,
      "ftm": 65,
      "fta": 79,
      "fg_pct": 0.411,
      "tp_pct": 0.329,
      "ft_pct": 0.823,
      "efg_pct": 0.493,
      "ts_pct": 0.541
    },
    {
      "season": 2026,
      "season_type": "postseason",
      "teams": "BOS",
      "games": 6,
      "starts": 6,
      "min": 36.3,
      "pts": 23.3,
      "reb": 10.7,
      "ast": 6.8,
      "stl": 1.2,
      "blk": 0,
      "tov": 2.8,
      "oreb": 1,
      "dreb": 9.7,
      "pf": 1.8,
      "plus_minus": 4.7,
      "total_pts": 140,
      "fgm": 48,
      "fga": 101,
      "tpm": 19,
      "tpa": 52,
      "ftm": 25,
      "fta": 32,
      "fg_pct": 0.475,
      "tp_pct": 0.365,
      "ft_pct": 0.781,
      "efg_pct": 0.569,
      "ts_pct": 0.608
    },
    {
      "season": 2025,
      "season_type": "regular",
      "teams": "BOS",
      "games": 72,
      "starts": 72,
      "min": 36.4,
      "pts": 26.8,
      "reb": 8.7,
      "ast": 6,
      "stl": 1.1,
      "blk": 0.5,
      "tov": 2.9,
      "oreb": 0.7,
      "dreb": 8,
      "pf": 2.2,
      "plus_minus": 7.4,
      "total_pts": 1932,
      "fgm": 662,
      "fga": 1465,
      "tpm": 250,
      "tpa": 728,
      "ftm": 358,
      "fta": 440,
      "fg_pct": 0.452,
      "tp_pct": 0.343,
      "ft_pct": 0.814,
      "efg_pct": 0.537,
      "ts_pct": 0.582
    }
  ],
  "recent_games": [
    {
      "game_id": "401869410",
      "date": "2026-04-30",
      "season": 2026,
      "opponent": "PHI",
      "home": false,
      "result": "L",
      "minutes": 29,
      "pts": 17,
      "reb": 11,
      "ast": 3,
      "stl": 0,
      "blk": 0,
      "tov": 3,
      "fgm": 6,
      "fga": 13,
      "tpm": 2,
      "tpa": 6,
      "ftm": 3,
      "fta": 5,
      "plus_minus": -11
    },
    {
      "game_id": "401869408",
      "date": "2026-04-28",
      "season": 2026,
      "opponent": "PHI",
      "home": true,
      "result": "L",
      "minutes": 41,
      "pts": 24,
      "reb": 16,
      "ast": 4,
      "stl": 3,
      "blk": 0,
      "tov": 4,
      "fgm": 8,
      "fga": 19,
      "tpm": 4,
      "tpa": 12,
      "ftm": 4,
      "fta": 7,
      "plus_minus": -9
    },
    {
      "game_id": "401869406",
      "date": "2026-04-26",
      "season": 2026,
      "opponent": "PHI",
      "home": false,
      "result": "W",
      "minutes": 35,
      "pts": 30,
      "reb": 7,
      "ast": 11,
      "stl": 0,
      "blk": 0,
      "tov": 5,
      "fgm": 8,
      "fga": 16,
      "tpm": 5,
      "tpa": 10,
      "ftm": 9,
      "fta": 9,
      "plus_minus": 25
    }
  ]
}

Response fields

playerobject
player.player_idstring
player.namestring
player.positionstring
player.jerseystring
player.team_idstring
player.teamstring
player.team_namestring
seasons[]array
List of objects
seasons[].seasonnumber
seasons[].season_typestring
seasons[].teamsstring
seasons[].gamesnumber
seasons[].startsnumber
seasons[].minnumber
seasons[].ptsnumber
seasons[].rebnumber
seasons[].astnumber
seasons[].stlnumber
seasons[].blknumber
seasons[].tovnumber
seasons[].orebnumber
seasons[].drebnumber
seasons[].pfnumber
seasons[].plus_minusnumber
seasons[].total_ptsnumber
seasons[].fgmnumber
seasons[].fganumber
seasons[].tpmnumber
seasons[].tpanumber
seasons[].ftmnumber
seasons[].ftanumber
seasons[].fg_pctnumber
seasons[].tp_pctnumber
seasons[].ft_pctnumber
seasons[].efg_pctnumber
seasons[].ts_pctnumber
recent_games[]array
List of objects
recent_games[].game_idstring
recent_games[].datestring

Related endpoints

Try it

500 credits free on signup: 100 calls to get_player, and no card.