Embed Leaderboard URL
Every Live Tourney event has an /embed URL that returns a lightweight, polling-based leaderboard. Unlike the standard event page (which holds an open Firestore real-time connection), the embed page fetches updates from a cached JSON API on a fixed interval. This is the recommended URL for GPS systems, course displays, club websites, and any other integration that needs a leaderboard view without the bandwidth cost of a live connection.
Embed URL by Event Type
| Event type | URL |
|---|---|
| Tournament (single round) | https://app.livetourney.com/tournament/[code]/embed |
| Multi-Round Tournament | https://app.livetourney.com/event/[code]/embed |
| Round Robin | https://app.livetourney.com/roundrobin/[code]/embed |
| Ryder Cup | https://app.livetourney.com/rydercup/[code]/embed |
| Bracket | https://app.livetourney.com/bracket/[code]/embed |
[code] is the event code (or custom slug) — the same value used in your standard event URL.
The embed URL is public — anyone with the event code can view it. No login is required.
URL Parameters
The embed page accepts the following query parameters:
| Param | Type | Default | Behavior |
|---|---|---|---|
poll |
integer seconds | 60 |
How often the leaderboard fetches fresh data. Clamped to between 10 and 3600 seconds. |
chrome |
true / false |
true |
When false, hides the top event header bar. Tab navigation (Leaderboard / Scorecard) stays visible. |
theme |
light / dark |
light |
When dark, applies a dark color palette suitable for cart screens and low-light displays. |
scorecardCode |
scorecard code | none | Opens the Scorecard tab with that group's scorecard already loaded, instead of the leaderboard. |
hole |
hole number | none | Opens the loaded scorecard on that hole. See Opening Score Entry on a Specific Hole below. |
Examples
Five-minute poll, dark theme, header hidden (a common GPS/cart configuration):
https://app.livetourney.com/tournament/12345/embed?poll=300&chrome=false&theme=dark
Ten-second poll for an active scoring TV:
https://app.livetourney.com/tournament/12345/embed?poll=10
Default behavior (60-second poll, light theme, header shown):
https://app.livetourney.com/tournament/12345/embed
Opening Score Entry on a Specific Hole
A GPS cart system can open score entry for the group in the cart, on the hole they just finished (for example, when the cart leaves the green).
Add scorecardCode and hole to the embed URL:
https://www.livetourney.com/tournament/12345/embed?chrome=false&theme=dark&scorecardCode=456789&hole=7
scorecardCodeis the group's scorecard code, the same code players type to open their scorecard. In the partner API it is thescorecardIdon each group of the pairings response.holeis the hole number as it appears on the Live Tourney scorecard. It takes priority over the group's starting hole and over the hole the device last had open.- If the hole is not on that scorecard (for example, hole 14 on a front-nine card), it is ignored and the scorecard opens as it normally would.
Changing the hole without reloading
If your screen keeps the page open, change the URL fragment instead of loading a new URL:
https://www.livetourney.com/tournament/12345/embed?chrome=false&theme=dark&scorecardCode=456789#hole=8
Changing #hole= moves the open scorecard to that hole without a page reload. Any scores already entered are saved first. If the scorer is partway through entering the current hole, the change is ignored so they are not interrupted.
Both parameters also work on the standard event page URL.
Caching
The underlying JSON API sets the following cache headers:
Cache-Control: s-maxage=60, stale-while-revalidate=120
This means a single response is shared across all viewers for up to 60 seconds, with stale content served for an additional 120 seconds while the cache is refreshed. Setting poll below 60 seconds is allowed but will frequently return cached responses.
When to Use Embed vs the Standard Event Page
| Use case | Recommended URL |
|---|---|
| Player viewing on phone during their round | Standard event page (real-time updates) |
| TV at the clubhouse for live event viewing | TV leaderboard URL (see Setting Up a TV Leaderboard) |
| GPS cart screen or third-party leaderboard display | Embed URL |
| Iframe on a club website | Embed URL with ?chrome=false |
| Anywhere lower bandwidth matters more than instant updates | Embed URL |
For Integration Partners
If you are building a GPS, course-management, or display system that needs to consume Live Tourney leaderboard data, the embed URL is the supported entry point. The page is iframe-friendly (no X-Frame-Options restrictions) and the underlying API is documented in the codebase at src/pages/api/leaderboard/singleRound/README.md.
For direct API access without rendering the page, contact help@livetourney.com to discuss partner API keys. See API Keys and Integrations for the partner API process.