Skip to content

get_player_stats

5 creditsStats + aggregationPOST /v1/get_player_stats

A player's season stats: scoring, birdies, par-3/4/5 scoring, driving, greens, putting

Use it when you want a player's season in numbers: scoring, birdies and bogeys per round, par 3/4/5 averages, driving, greens and putting.

Parameters

player_idstringrequired
Player id from search_players.
seasonstring | numberrequired
Season year, e.g. 2025.

Notes

  • Over MCP, ask for it in plain English and the client calls get_player_stats itself. Point any MCP client at https://mcp.birdieapi.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.birdieapi.com/v1/get_player_stats \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "player_id": "9478",
  "season": 2024
}'

Response

json
{
  "player": {
    "player_id": "9478",
    "name": "Scottie Scheffler",
    "first_name": null,
    "last_name": "Scheffler",
    "country": "USA",
    "birth_date": null,
    "amateur": false,
    "headshot": "https://a.espncdn.com/i/headshots/golf/players/full/9478.png"
  },
  "season": 2024,
  "results": {
    "starts": 20,
    "wins": 8,
    "top_tens": 17,
    "top_25s": 18,
    "made_cut": 20,
    "missed_cut": 0,
    "withdrew_or_dq": 0,
    "average_finish": 7.3,
    "earnings": 29228360,
    "cup_points": 6615,
    "rounds": 79,
    "scoring_average": 67.9,
    "average_to_par": -3.34,
    "vs_field": 2.63,
    "adj_vs_field": 3.75
  },
  "hole_scoring": {
    "rounds_with_holes": 79,
    "eagles_per_round": 0.139,
    "birdies_per_round": 4.975,
    "bogeys_or_worse_per_round": 1.709,
    "par_rate": 0.621,
    "par3_average": 2.981,
    "par4_average": 3.869,
    "par5_average": 4.431,
    "holes_in_one": 0
  },
  "ball_striking": {
    "tournaments": 18,
    "driving_distance": 304.5,
    "driving_accuracy": 67.7,
    "greens_in_regulation": 75.5,
    "putts_per_gir": 1.656,
    "sand_saves": 51.1
  },
  "espn_season": {
    "events": 19,
    "cuts_made": 19,
    "wins": 7,
    "top_tens": 16,
    "earnings": 29228356,
    "cup_points": 6615,
    "scoring_average": 68.013336,
    "driving_distance": null,
    "driving_accuracy": null,
    "greens_in_regulation": null,
    "putts_per_gir": 1.68,
    "birdies": 366,
    "eagles": 11
  }
}

Response fields

playerobject
player.player_idstring
player.namestring
player.first_namenull
player.last_namestring
player.countrystring
player.birth_datenull
player.amateurboolean
player.headshotstring
seasonnumber
resultsobject
results.startsnumber
results.winsnumber
results.top_tensnumber
results.top_25snumber
results.made_cutnumber
results.missed_cutnumber
results.withdrew_or_dqnumber
results.average_finishnumber
results.earningsnumber
results.cup_pointsnumber
results.roundsnumber
results.scoring_averagenumber
results.average_to_parnumber
results.vs_fieldnumber
results.adj_vs_fieldnumber
hole_scoringobject
hole_scoring.rounds_with_holesnumber
hole_scoring.eagles_per_roundnumber
hole_scoring.birdies_per_roundnumber
hole_scoring.bogeys_or_worse_per_roundnumber
hole_scoring.par_ratenumber
hole_scoring.par3_averagenumber
hole_scoring.par4_averagenumber
hole_scoring.par5_averagenumber
hole_scoring.holes_in_onenumber
ball_strikingobject
ball_striking.tournamentsnumber
ball_striking.driving_distancenumber
ball_striking.driving_accuracynumber

Related endpoints

Try it

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