Skip to content

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_leaders 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_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

statstring
labelstring
seasonnumber
minimumnumber
minimum_ofstring
leaders[]array
List of objects
leaders[].ranknumber
leaders[].player_idstring
leaders[].namestring
leaders[].countrystring
leaders[].valuenumber
leaders[].samplenumber
countnumber

Used in

Related endpoints

Try it

500 free credits every month: 100 calls to get_leaders, and no card.