Stats + aggregation

Leaders

Use for a season's leaders in one stat, with each player's sample. Stats from rounds and holes: scoring_average, vs_field, adj_vs_field, birdies_per_round, bogey_avoidance, par3_average, par4_average, par5_average, and sg_par3, sg_par4, sg_par5 (strokes versus the field on par 3, 4 or 5 holes, field-strength adjusted; PGA Tour and Korn Ferry Tour only, score-based, not shot data). From results: earnings (empty for the DP World Tour and LIV), cup_points (FedEx Cup points, PGA Tour only: no Race to Dubai or CME Globe points), wins, top_tens. From tournament stat lines (PGA Tour from 2011): driving_distance, driving_accuracy, greens_in_regulation, putts_per_gir. Costs 5 credits.

post/v1/get_leaders

Request

  • Base URL: https://mcp.birdieapi.com
  • URL: https://mcp.birdieapi.com/v1/get_leaders
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Request body

stat'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_gir' required

The stat to rank.

mininteger

Minimum sample: rounds (default 40), starts (1) or tournaments with a stat line (8).

limitinteger

Max players (default 25).

league'golf' | 'lpga' | 'liv' | 'dpwt' | 'kornferry'

League. Defaults to golf. One of: golf, lpga, liv, dpwt, kornferry.

Response

The result, wrapped in data.

Changes

No recorded changes to this operation across all 1 revision of this API.