How has a golfer played at one course or event over the years?
A player's result at one tournament in every year they played it, with finish, score, earnings and strokes against the field, plus a career summary.
Code verified October 10, 2026. One call to get_course_history, 5 credits.
The call
Any year's tournament_id works; every edition is returned. Pass course_id instead to follow a course across events.
import requests
import pandas as pd
API_KEY = "YOUR_API_KEY"
resp = requests.post(
"https://mcp.birdieapi.com/v1/get_course_history",
headers={"x-api-key": API_KEY},
json={
"player_id": "3470",
"tournament_id": "401811941",
},
timeout=60,
)
resp.raise_for_status()
data = resp.json()["data"]
h = pd.DataFrame(data["editions"])
print(data["player"]["name"], data["tournament"])
print(data["summary"])
print(h[["season", "position_display", "to_par", "total_strokes", "vs_field"]].head(10))
print("average vs field in top-10 years:", round(h[h["position"] <= 10]["vs_field"].mean(), 2))
Replace YOUR_API_KEY with a key from your dashboard. Python needs requests and pandas (pip install requests pandas). JavaScript runs on Node 18 or newer, or in the browser.
What comes back
The data object of the response, trimmed to the first rows. Every field is real output from the run above.
{
"player": {
"player_id": "3470",
"name": "Rory McIlroy"
},
"tournament": "Masters Tournament",
"summary": {
"starts": 18,
"wins": 2,
"top_tens": 9,
"made_cut": 15,
"missed_cut": 3,
"average_finish": 12.4,
"vs_field": 1.42,
"earnings": 13023021
},
"editions": [
{
"season": 2026,
"name": "Masters Tournament",
"position_display": "1",
"to_par": -12,
"total_strokes": 276,
"earnings": 4500000,
"vs_field": 3.55,
"rounds": [
67,
65,
"...2 more"
]
},
{
"season": 2025,
"name": "Masters Tournament",
"position_display": "1",
"to_par": -11,
"total_strokes": 277,
"earnings": 4200000,
"vs_field": 3.43,
"rounds": [
72,
66,
"...2 more"
]
},
"...16 more"
],
"count": 18
}What to do next
- get_head_to_head (5 credits). Two players' finishes in every tournament they both played.
- get_player_results (5 credits). The same player's season, tournament by tournament.
More guides
Start with 500 free credits
No card. REST or MCP.