Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Introduction

Sportradar’s Golf API offers a comprehensive suite of real-time tournament updates, rankings, and seasonal statistics to power your golf experiences.

We provide full hole-by-hole coverage for the PGA Tour, DP World Tour, LIV Tour, LPGA Tour, Champions Tour, Korn Ferry, Olympics, Ryder Cup, and President's Cup. All Majors are covered. For further coverage info, click here.

Primary feeds will return schedules, tournament leaderboards, tee times, and hole-by-hole scoring.

Additional feeds provide a host of complementary stats, including:

  • Player profiles
  • Seasonal statistics
  • World golf ranking for the top 200 players
  • Detailed course information

Real-time customers are also offered two delivery Push Feeds to enhance speed.

🗝️

Authentication is required for all API calls.

API Map

To best utilize the Golf API, you will need several parameters to create your API calls. The map below illustrates how you can obtain the parameters you need.

The primary feeds require only a date or year to call the endpoints. Those feeds provide Tournament Ids which can be used to access the tournament feeds.


Endpoint Descriptions

Daily Change Log – Provides IDs and timestamps for players, tournaments, schedules, pairings and statistics that have been modified on a given date. To receive the data updates, use these unique IDs to pull relevant API feeds.

Official World Golf Ranking – Provides Official World Golf Rankings and points for top the 200 players. 

Player Profile – Provides biographical information and historical tournament statistics for a given player.

Player Statistics – Season statistics for all golfers who have earned Fed Ex Cup points in a given year. Season statistics are validated and adjusted on a weekly basis. 

Players – Provides player biographical information for a given year and tour, for all players. This includes height, weight, place of birth, date of birth, residence, and college.

Scorecards per Round – Detailed round scoring including player information, course information, player scoring per hole, and overall tournament scoring per player. 

Seasons – Provides a list of all available seasons for every tour.

Tee Times per Round – Provides tee times for a given round, including pairings and starting positions. 

Tournament Hole Statistics – Detailed information on how the field fared on each hole for a given tournament. 

Tournament Leaderboard – Provides a real-time leaderboard position for a given tournament, including player statistics at tournament and per-round level.

Tournament Schedule – Schedule of tournaments for a given season including date, location, course layouts, and tournament purse. 

Tournament Summary – Provides information for a given tournament by year, including location, course layout and tournament field. 

Push Leaderboard – Detailed real-time tournament statistics including player statistics at tournament and per-round level.

Push Scorecard – Detailed real-time round scoring including player information, player scoring per hole, and overall tournament scoring per player.


Data Retrieval Sample

To find a pairing's tee time for a given tournament:

  1. Call the Tournament Schedule and find the Tournament Id for the chosen tournament
  2. Call the Tee Times Per Round using the Tournament Id and a chosen round number
  3. Find your chosen pairing and locate the tee_time attribute

The tee time of the pairing is displayed.


Tour Coverage

Our Golf API provides hole-by-hole coverage for each of the below tours. See below for further information on events covered.

PGA Tour calendar events - We cover all PGA Tour events in which Fed Ex Cup points are awarded. In addition, we also cover the President’s Cup and Ryder Cup events.

DP World Tour calendar events - We cover all traditional match and stroke play events on the DP World Tour schedule that award Race to Dubai points. We also cover the President's Cup and Ryder Cup.

LPGA Tour calendar events - We cover all traditional match and stroke-play events on the LPGA Tour schedule which award points, including Majors. In addition, we also cover the Solheim Cup.

PGA Tour Champions calendar events - We cover all standard stroke and match play PGA Tour Champions events in which points are awarded.

Korn Ferry Tour calendar events - We cover all standard stroke and match play Korn Ferry Tour events in which points are awarded.

LIV Golf Invitational Series - We cover all standard stroke play events on the LIV Golf Invitational Series schedule.

Olympic calendar events – We cover all Olympic Men’s & Women’s Golf events.

Hero World Challenge – We cover the Hero World Challenge. This event will not be reflected in player seasonal statistics, as it does not award Fed Ex Cup points. This tournament is listed in our PGA Tour Schedule.

The Match exhibitions - We cover these exhibitions within our PGA Tour schedule as a ‘cup’ style event. These events will not be reflected in player seasonal statistics, as they do not award Fed Ex Cup points.

USGA events - We covered the USGA for the 2019 season.



Data Entry Workflow

See below for a daily breakdown of data updates for the Golf API.

Sunday

  • Tournament finalized within 2 hours after completion (points and earnings updated).

Monday

  • Validate field for the next tournament (10 pm CT)
  • Season stats validation (All Day)

Tuesday

  • Player Statistics updated with weekend tournament results (AM)
  • Season stats validation (All Day)
  • First and second round tee times entered for the weekend's tournament(s) (10 pm CT). Note: Tee times may be available earlier, depending on when they are officially released. Tournaments starting on Fridays may have tee times entered on Wednesdays.
  • Validate field for the next tournament (10 pm CT)
  • Season stats validation (All Day)

Wednesday

  • Validate field for the next tournament (10 pm CT)

Thursday

  • Season stats validation (5 pm CT)
  • Review positions and finalize completed round within 1 hour of round completion

Friday

  • Review positions and finalize completed round within 1 hour of round completion
  • Set the cut line for the tournament(s) (10 pm CT)
  • Third and fourth round tee times entered for the weekend's tournament(s) (10 pm CT)
  • Create the field for the next tournament(s) (10 pm CT)

Saturday

  • Review positions and finalize completed round within 1 hour of round completion
  • If necessary, set the cut line for the tournament(s) (10 pm CT)
  • If necessary, fourth round tee times entered for the weekend's tournament(s) (10 pm CT)

Integration Links

Postman Workspace

Our entire Media APIs are available on Postman. Click the link above to be taken directly to our Golf API collection.

Feel free to follow and/or fork any collections to receive updates.

Schema Download

Open the zip file below to access our entire Golf API XSD schema.

Golf v3 Schema