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

CODEBLOCK0

Facility-Specific Search (SearchType: 1) — WORKS ✅

Requires a FacilityId. Returns all tee times for that course on a given date.

CODEBLOCK1

Area Search (SearchType: 0) — DOES NOT WORK ❌

Returns 0 results without a FacilityId. The API requires facility-specific queries.

Key Parameters

Param	Values	Notes
INLINECODE1	"1"-"4"	String, not int
INLINECODE2

"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

CODEBLOCK2

Building Course URLs

https://www.golfnow.com/tee-times/facility/{seoFriendlyName}/search

Example: INLINECODE9

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:

1. 1. Use the known course database (see below)
2. Web search: site:golfnow.com/tee-times/facility {city} {state} — URL contains the ID
3. 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:

CODEBLOCK4

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

1. 1. 🔥 GolfNow Hot Deals — isHotDeal: true in API. Unsold inventory at deep discounts.
2. 💳 Trade Offers — isTradeOffer: true. Bookable with GolfNow credits.
3. 🚶 Walk don't ride — saves $20-50 on cart fees
4. 🌅 Twilight rates — after 2-3 PM, prices drop significantly (look for rateName: "Twilight")
5. 🏠 FL resident rate — show ID for local discount at public courses
6. ⏰ Last-minute deals — day-of prices drop; hot deals appear closer to tee time
7. 📞 Call pro shop — phone-only rates sometimes cheaper than online
8. 🗓️ Weekday > Weekend — Monday-Thursday is always cheaper
9. 🌧️ 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

1. 1. Navigate to INLINECODE18
2. Select golfer count — click radio button, dispatch change event, verify green fees total updates
3. Click "Continue to Book" (.btnBook) — redirects to login if not authenticated
4. Login — GolfID iframe (my.golfid.io): use frame=[src*=golfid] to access email/password fields

- Creds: scripts/vault.sh get golfnow

1. 5. 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)

1. 6. 📸 SCREENSHOT & SEND TO USER — Send checkout screenshot via Telegram before proceeding
2. Wait for approval
3. Accept terms: Check INLINECODE29
4. Click reservation: INLINECODE30
5. 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