Data atlas
Inspect the golf data layer before you build on it.
BirdieAPI exposes golf datasets through REST and MCP. This atlas keeps coverage claims explicit: what exists, which endpoints expose it, and where availability is partial.
Coverage ledger
Coverage is a product claim, not a freshness signal. Operational freshness is tracked separately.
| Data | Status | Coverage | Volume |
|---|---|---|---|
Leaderboards and results Finishing position, ties, cut and withdrawal status, score to par, total strokes, each round, earnings and season points. | Available | PGA Tour 2001 to current | Every player in every field |
Hole-by-hole scores Strokes on each hole with par and yardage from the tournament's course setup; for pro-ams, the course each round was played on. PGA Tour, and the Korn Ferry Tour from 2007 (99% of its rounds); only round totals, not holes, are kept for the LPGA, LIV and the DP World Tour. | Available | PGA Tour 2001 to current | About 99% of PGA Tour rounds; the rest have round totals only |
Courses Par and yards per hole as set up for each tournament, and how each hole played. | Available | PGA Tour 2001 to current | Every tournament's setup |
Driving, greens and putting The stat line per player per tournament: driving distance and accuracy, greens in regulation, putts per green, sand saves. PGA Tour only; no strokes gained by category and no shot-level data. | Partial | PGA Tour, from 2011 | Per player per tournament |
Major winner odds Each sportsbook's price on every priced golfer to win the Masters, PGA Championship, U.S. Open and Open Championship before the first round: the opening price, the latest price and every snapshot, with the implied probability, linked to our player id where the name matches the field. The four men's majors only; past majors are weekly archive snapshots, so their latest price can be up to a week before the first tee time; an upcoming major is refreshed daily while its market is open (every six hours in tournament week) and not at all once the first round starts; the 2020 U.S. Open has one snapshot and 2021 fewer than later years; no round, matchup or other-tournament markets. | Partial | The four majors from 2021 (and the 2020 U.S. Open), plus the next edition of each while its market is open | Weekly archive snapshots per sportsbook and golfer, then daily (every six hours in tournament week) while a major's market is open |
Strokes versus the field Each round against its field's average on the same course, adjusted for field strength (score-based, the same idea as strokes gained: total), and a rating after every tournament. The PGA Tour and Korn Ferry Tour also get par 3, 4 and 5 splits (sg_par3, sg_par4, sg_par5); there are no shot-level splits. | Available | Each tour's seasons with leaderboards (PGA Tour 2001 on; Korn Ferry Tour 2007 on; LPGA, LIV and DP World Tour with the gaps their pages list) | Full 18-hole rounds in fields of ten or more |
Endpoint map
Start with the dataset, then jump to the exact tool reference or a runnable surface.
Leaderboards and results
availableFinishing position, ties, cut and withdrawal status, score to par, total strokes, each round, earnings and season points.
Hole-by-hole scores
availableStrokes on each hole with par and yardage from the tournament's course setup; for pro-ams, the course each round was played on.
Courses
availablePar and yards per hole as set up for each tournament, and how each hole played.
Driving, greens and putting
partialThe stat line per player per tournament: driving distance and accuracy, greens in regulation, putts per green, sand saves.
Major winner odds
partialEach sportsbook's price on every priced golfer to win the Masters, PGA Championship, U.S. Open and Open Championship before the first round: the opening price, the latest price and every snapshot, with the implied probability, linked to our player id where the name matches the field.
Strokes versus the field
availableEach round against its field's average on the same course, adjusted for field strength (score-based, the same idea as strokes gained: total), and a rating after every tournament. The PGA Tour and Korn Ferry Tour also get par 3, 4 and 5 splits (sg_par3, sg_par4, sg_par5); there are no shot-level splits.
Sportsbook coverage
Odds coverage currently documents winner prices for the four men's majors from DraftKings, FanDuel, BetMGM, ESPN BET and Pinnacle, among other books, as the sportsbook odds archive holds them. Outright winner prices for the four men's majors only, from 2021: weekly archive snapshots for past majors, refreshed daily for an upcoming major while its market is open, none once play starts; no round, matchup, three-ball or finishing-position prices, nothing for other tournaments or tours, and no in-play prices.