Skip to content

get_player

5 creditsStats + aggregationPOST /v1/get_player

Data refreshed · changelog

Profile, rating, season lines and recent finishes

Use it when you are profiling a player: career totals, current rating, a line per season and the latest results.

Parameters

player_idstringrequired
Player id from search_players or get_leaderboard.
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_player 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 \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "player_id": "9478"
}'

Response

json
{
  "player": {
    "player_id": "9478",
    "name": "Scottie Scheffler",
    "first_name": null,
    "last_name": "Scheffler",
    "country": "USA",
    "birth_date": null,
    "amateur": false
  },
  "career": {
    "starts": 167,
    "wins": 23,
    "top_tens": 90,
    "top_25s": 126,
    "made_cut": 149,
    "missed_cut": 18,
    "withdrew_or_dq": 0,
    "average_finish": 12.9,
    "earnings": 136496992,
    "cup_points": 29391,
    "rounds": 631,
    "scoring_average": 68.69,
    "average_to_par": -2.4,
    "vs_field": 1.93,
    "adj_vs_field": 2.92
  },
  "rating": {
    "rating": 3.31,
    "weighted_rounds": 133.1,
    "as_of": "2026-08-30"
  },
  "seasons": [
    {
      "season": 2026,
      "starts": 20,
      "wins": 3,
      "top_tens": 13,
      "made_cut": 19,
      "earnings": 30937526,
      "cup_points": 4986,
      "scoring_average": 67.86,
      "adj_vs_field": 3.46
    },
    {
      "season": 2025,
      "starts": 21,
      "wins": 6,
      "top_tens": 18,
      "made_cut": 21,
      "earnings": 27659548,
      "cup_points": 7457,
      "scoring_average": 67.94,
      "adj_vs_field": 3.86
    },
    {
      "season": 2024,
      "starts": 20,
      "wins": 8,
      "top_tens": 17,
      "made_cut": 20,
      "earnings": 29228358,
      "cup_points": 6615,
      "scoring_average": 67.9,
      "adj_vs_field": 3.75
    }
  ],
  "recent_results": [
    {
      "tournament_id": "401811964",
      "name": "TOUR Championship",
      "season": 2026,
      "start_date": "2026-08-27",
      "major": false,
      "position_display": "1",
      "status": "finished",
      "to_par": -16,
      "earnings": 10000000
    },
    {
      "tournament_id": "401811963",
      "name": "BMW Championship",
      "season": 2026,
      "start_date": "2026-08-20",
      "major": false,
      "position_display": "T12",
      "status": "finished",
      "to_par": -7,
      "earnings": 426250
    },
    {
      "tournament_id": "401811962",
      "name": "FedEx St. Jude Championship",
      "season": 2026,
      "start_date": "2026-08-13",
      "major": false,
      "position_display": "1",
      "status": "finished",
      "to_par": -17,
      "earnings": 3600000
    }
  ]
}

Response fields

playerobject
player.player_idstring
player.namestring
player.first_namenull
player.last_namestring
player.countrystring
player.birth_datenull
player.amateurboolean
careerobject
career.startsnumber
career.winsnumber
career.top_tensnumber
career.top_25snumber
career.made_cutnumber
career.missed_cutnumber
career.withdrew_or_dqnumber
career.average_finishnumber
career.earningsnumber
career.cup_pointsnumber
career.roundsnumber
career.scoring_averagenumber
career.average_to_parnumber
career.vs_fieldnumber
career.adj_vs_fieldnumber
ratingobject
rating.ratingnumber
rating.weighted_roundsnumber
rating.as_ofstring
seasons[]array
List of objects
seasons[].seasonnumber
seasons[].startsnumber
seasons[].winsnumber
seasons[].top_tensnumber
seasons[].made_cutnumber
seasons[].earningsnumber
seasons[].cup_pointsnumber
seasons[].scoring_averagenumber
seasons[].adj_vs_fieldnumber
recent_results[]array
List of objects
recent_results[].tournament_idstring

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.

Related endpoints

Try it

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