| name | golf-tee-times |
| description | Search for golf tee times and deals near any location. Find cheapest rounds, compare prices across platforms, and get discount tips. Use when asked about golf, tee times, courses, or booking a round. |
| metadata | {"openclaw":{"emoji":"⛳","requires":{"bins":"[Truncated]"}}} |
Golf Tee Time Finder ⛳
Find and compare golf tee times using the GolfNow API (reverse-engineered). Works for any location.
When to Use
- User asks to find tee times, book golf, or play a round
- Looking for cheap/discounted golf or hot deals
- Comparing courses in an area
- Checking availability for a specific date
- Finding credit-bookable (trade offer) tee times
GolfNow API (Primary Method)
The GolfNow website uses a POST API to fetch tee times. This is the only reliable method — web_fetch returns empty shells (JS-rendered SPA).
API Endpoint
POST https://www.golfnow.com/api/tee-times/tee-time-results
Content-Type: application/json
Accept: application/json
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36
Origin: https://www.golfnow.com
Facility-Specific Search (SearchType: 1) — WORKS ✅
Requires a FacilityId. Returns all tee times for that course on a given date.
{
"Radius": 50,
"Latitude": 26.1224,
"Longitude": -80.1373,
"PageSize": 50,
"PageNumber": 0,
"SearchType": 1,
"SortBy": "Date",
"SortDirection": 0,
"Date": "Feb 16 2026",
"BestDealsOnly": false,
"PriceMin": "0",
"PriceMax": "10000",
"Players": "2",
"Holes": "3",
"FacilityType": 0,
"RateType": "all",
"TimeMin": "10",
"TimeMax": "42",
"FacilityId": 5744,
"SortByRollup": "Date.MinDate",
"View": "Grouping",
"ExcludeFeaturedFacilities": true,
"TeeTimeCount": 50,
"PromotedCampaignsOnly": "false",
"CurrentClientDate": "2026-02-16T05:00:00.000Z"
}
Area Search (SearchType: 0) — DOES NOT WORK ❌
Returns 0 results without a FacilityId. The API requires facility-specific queries.
Key Parameters
| Param | Values | Notes |
|---|
Players | "1"-"4" | String, not int |
Holes | "1"=9h, "2"=18h, "3"=any | String |
TimeMin/TimeMax | 10-42 | Maps to time ranges. 10=5AM, 42=9PM+ |
Date | "Feb 16 2026" | Human-readable format |
FacilityType | 0=any, 1=course, 2=simulator | |
BestDealsOnly | true/false | Hot deals filter (but returns 0 for area search) |
SearchType | 1 | Must be 1 (facility). 0/2/3 don't work |
Response Structure
ttResults.teeTimes[] → array of tee time groups
├── formattedTime: "7:18"
├── formattedTimeMeridian: "AM"
├── time: "2026-02-16T07:18:00" (ISO timestamp)
├── displayRate: 35.0 (price per player)
├── multipleHolesRate: 18 (hole count)
├── maxPriceTransactionFee: 2.99
├── facility.name, facility.address.city, facility.averageRating, facility.reviewCount
├── facility.seoFriendlyName (for building URLs)
├── facility.latitude, facility.longitude
└── teeTimeRates[] → rate options for this time slot
├── rateName: "Prepaid - Online Rate" / "Hot Deal" / "Twilight" / etc.
├── isHotDeal: true/false 🔥
├── isTradeOffer: true/false 💳 (credit-bookable)
├── isCartIncluded: true/false
├── singlePlayerPrice.greensFees.value: 35.0
└── rateSetTypeId: 1=prepaid, other=pay at course
Building Course URLs
https://www.golfnow.com/tee-times/facility/{seoFriendlyName}/search
Example: https://www.golfnow.com/tee-times/facility/5744-colony-west-golf-club-glades-course/search
Helper Script
Use skills/golf-tee-times/golfnow-search.py for batch queries. See script for usage.
Finding Facility IDs
Since area search doesn't work, you need FacilityIds. Methods:
- Use the known course database (see below)
- Web search:
site:golfnow.com/tee-times/facility {city} {state} — URL contains the ID
- Browser intercept: Load a course page, intercept the POST to
/api/tee-times/tee-time-results, read the FacilityId from the payload
Telegram Output Format
Use this clean format for presenting tee times:
🏌️ *Tee Times · {Day} {Date} · {Players} Players*
⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯
🔥 *DEALS*
🔥 *[Course Name](url)*
City · X mi · ⭐ X.X · N reviews
▸ Time · *$XX* · 18 holes · cart 🔥
⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯
*[Course Name](url)*
City · X mi · ⭐ X.X · N reviews
▸ Time range · $XX
▸ Time range · $XX twilight
⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯
_All prices per player · cart included · via GolfNow_
Key formatting rules:
- Use
▸ for time slot lines
- Bold the course name as a markdown link
- Show deals section first (🔥 hot deals, 💳 credit/trade offers)
- Group times by price tier within each course
- Include distance, rating, review count
- Add
← AM slots or similar callouts for notable availability
- Footer: All prices per player · cart included · via GolfNow
- Do NOT use backtick code blocks for time listings (looks bad on mobile)
Discount Tips
- 🔥 GolfNow Hot Deals —
isHotDeal: true in API. Unsold inventory at deep discounts.
- 💳 Trade Offers —
isTradeOffer: true. Bookable with GolfNow credits.
- 🚶 Walk don't ride — saves $20-50 on cart fees
- 🌅 Twilight rates — after 2-3 PM, prices drop significantly (look for
rateName: "Twilight")
- 🏠 FL resident rate — show ID for local discount at public courses
- ⏰ Last-minute deals — day-of prices drop; hot deals appear closer to tee time
- 📞 Call pro shop — phone-only rates sometimes cheaper than online
- 🗓️ Weekday > Weekend — Monday-Thursday is always cheaper
- 🌧️ Rain forecast — prices drop when weather looks iffy
Seasonal Notes (your area)
- Peak season (Dec-Apr): Highest prices, book 3-7 days ahead. Morning sells out fast.
- Summer (May-Sep): 40-60% cheaper, but hot/humid. Early AM or twilight.
- Hurricane season (Jun-Nov): Rain discounts common
- Best value month: September (cheapest + least crowded)
Booking Flow## Booking Flow (GolfNow via Browser)
⚠️ CRITICAL: Always send a screenshot of the final checkout page to the user BEFORE clicking "Make Your Reservation". Wait for explicit approval.
Steps
- Navigate to
https://www.golfnow.com/tee-times/facility/{facilityId}/tee-time/{teeTimeId}
- Select golfer count — click radio button, dispatch
change event, verify green fees total updates
- Click "Continue to Book" (
.btnBook) — redirects to login if not authenticated
- Login — GolfID iframe (
my.golfid.io): use frame=[src*=golfid] to access email/password fields
- Creds:
scripts/vault.sh get golfnow
- Checkout page (URL:
.../checkout/players/{count}):
- Apply rewards: Click
#applyRewardsBtn → checkboxes by code ID (e.g. #MEMBERSAVE)
- Note: Rewards marked "Cannot Be Combined" won't stack on Hot Deals
- Apply GolfPass Points: Click
#btn-apply-loyalty-points (these DO work on Hot Deals)
- Decline Tee Time Protection: Click
input[name=rdlTeeTimeProtection][value=false]
- Decline charity roundup: Click "No Thanks" if desired
- Payment: Pre-filled from saved cards (default: AMEX 1004)
- 📸 SCREENSHOT & SEND TO USER — Send checkout screenshot via Telegram before proceeding
- Wait for approval
- Accept terms: Check
#agree-terms-top
- Click reservation:
#reservation-button-top
- Confirmation: Remove Truist ad overlay (
[class*=rokt], [class*=bold]), screenshot confirmation page
the user's Booking Preferences
- Always apply points/rewards to minimize cost
- Decline Tee Time Protection (save $3-4)
- Default payment: AMEX ending 1004
- Send confirmation screenshot after booking
