get_leaders
5 creditsStats + aggregationPOST /v1/get_leaders
Data refreshed · changelog
Season leaders for any stat we compute or keep
Use it when you want a season's leaders in one stat with each player's sample size.
Parameters
statenum: scoring_average | adj_vs_field | vs_field | birdies_per_round | bogey_avoidance | par3_average | par4_average | par5_average | sg_par3 | sg_par4 | sg_par5 | earnings | cup_points | wins | top_tens | driving_distance | driving_accuracy | greens_in_regulation | putts_per_girrequired- The stat to rank.
seasonstring | numberrequired- Season year, e.g. 2025.
minintegeroptional- Minimum sample: rounds (default 40), starts (1) or tournaments with a stat line (8).
limitintegeroptional- Max players (default 25).
leagueenum: golf | lpga | liv | dpwt | kornferryoptional- League. Defaults to golf. One of: golf, lpga, liv, dpwt, kornferry.
Notes
- Over MCP, ask for it in plain English and the client calls
get_leadersitself. 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_leaders \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"stat": "adj_vs_field",
"season": 2025,
"limit": 3
}'Response
json
{
"stat": "adj_vs_field",
"label": "Strokes versus the field per round, field-strength adjusted",
"season": 2025,
"minimum": 40,
"minimum_of": "rounds",
"leaders": [
{
"rank": 1,
"player_id": "9478",
"name": "Scottie Scheffler",
"country": "USA",
"value": 3.857,
"sample": 84
},
{
"rank": 2,
"player_id": "3470",
"name": "Rory McIlroy",
"country": "Northern Ireland",
"value": 2.854,
"sample": 58
},
{
"rank": 3,
"player_id": "5539",
"name": "Tommy Fleetwood",
"country": "England",
"value": 2.726,
"sample": 74
}
],
"count": 3
}Response fields
statstringlabelstringseasonnumberminimumnumberminimum_ofstringleaders[]array- List of objects
leaders[].ranknumberleaders[].player_idstringleaders[].namestringleaders[].countrystringleaders[].valuenumberleaders[].samplenumbercountnumber
Used in
- PGA Tour player stats data: Driving distance and accuracy, greens in regulation, putts per green and sand saves per player per PGA Tour tournament, with scoring stats counted from every hole.
- Guide: How do I get PGA Tour stat leaders in Python?
Related endpoints
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
list_tournaments1 cr
Filters by the same season and limit.
A season's tournaments with dates, winner, purse and courses
get_schedule1 cr
Filters by the same league.
Tournaments this week and coming up, with the host course
Try it
500 free credits every month: 100 calls to get_leaders, and no card.