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_statsitself. Point any MCP client athttps://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
playerobjectplayer.player_idstringplayer.namestringplayer.first_namenullplayer.last_namestringplayer.countrystringplayer.birth_datenullplayer.amateurbooleanplayer.headshotstringseasonnumberresultsobjectresults.startsnumberresults.winsnumberresults.top_tensnumberresults.top_25snumberresults.made_cutnumberresults.missed_cutnumberresults.withdrew_or_dqnumberresults.average_finishnumberresults.earningsnumberresults.cup_pointsnumberresults.roundsnumberresults.scoring_averagenumberresults.average_to_parnumberresults.vs_fieldnumberresults.adj_vs_fieldnumberhole_scoringobjecthole_scoring.rounds_with_holesnumberhole_scoring.eagles_per_roundnumberhole_scoring.birdies_per_roundnumberhole_scoring.bogeys_or_worse_per_roundnumberhole_scoring.par_ratenumberhole_scoring.par3_averagenumberhole_scoring.par4_averagenumberhole_scoring.par5_averagenumberhole_scoring.holes_in_onenumberball_strikingobjectball_striking.tournamentsnumberball_striking.driving_distancenumberball_striking.driving_accuracynumber
Related endpoints
get_schedule1 cr
Returns the player_id this one takes.
Tournaments this week and coming up, with the host course
search_players1 cr
Returns the player_id this one takes.
Find players by name
get_scorecard2 cr
Takes the player_id this one returns.
A player's hole-by-hole scorecard for a tournament, with par and yardage
get_player5 cr
Takes the player_id this one returns.
Profile, rating, season lines and recent finishes
Try it
500 credits free on signup: 100 calls to get_player_stats, and no card.