# TravelPulse

> AI-powered global travel intelligence for ANY destination on earth. 14 endpoints covering live theme park wait times, crowd predictions, weather forecasts, trip planning, translation, phrasebooks, visa requirements, health advisories, currency strategy, travel insurance, budget breakdowns, packing lists, travel deals, and more. Any language. Pay-per-query via x402 on Base.

## What This Is

TravelPulse covers every destination worldwide — major tourist cities AND small towns, rural areas, suburbs, and off-the-beaten-path locations. This is our niche: conventional travel agents focus on popular destinations, but someone attending a wedding near Little Rock Arkansas or visiting family in a small Canadian town deserves quality travel intelligence too.

Data sources: themeparks.wiki (100+ parks, free, no key), Open-Meteo (global weather, free, no key), NPS (US national parks), Tavily (real-time travel intelligence).

All endpoints support ?lang= — Claude responds natively in any human language.

## Payment

Protocol: x402 | Network: eip155:8453 | Asset: USDC
Payment address: 0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc

## Endpoints

### Theme Parks — 100+ Parks Globally

GET /api/parks/waits?park={name}&lang={lang}
- Live ride wait times for any theme park globally with visit strategy
- Covers: Disney, Universal, SeaWorld, Six Flags, Europa-Park, Tokyo Disney, 100+ more
- Returns: current wait times per ride, visit_strategy, best_time_to_visit, avoid_list
- Price: $0.05

GET /api/parks/hours?park={name}&date={YYYY-MM-DD}&lang={lang}
- Park operating hours, show schedule, special events — 7-day ahead
- Returns: hours, special_events, show_schedule, booking_required
- Price: $0.05

GET /api/parks/crowds?park={name}&date={YYYY-MM-DD}&lang={lang}
- Crowd level prediction (1-10 scale) with alternative date recommendations
- Returns: crowd_score, rationale, better_dates, seasonal_context, insider_tips
- Price: $0.08

### Weather & Planning

GET /api/travel/weather?destination={city/country}&lang={lang}
- 7-day weather forecast for any destination on earth
- Returns: forecast (7 days), travel_impact, packing_advice, climate_context, best_months
- destination required
- Optional: lang
- Price: $0.05

GET /api/travel/plan?destination={destination}&days={n}&style={style}&budget={tier}&lang={lang}
- Complete day-by-day trip itinerary for any destination, any length up to 14 days
- Returns: full itinerary, must_do, avoid, accommodation_options (hotels + VRBO), booking_resources (including car_rental recommendation), credit_card_optimization, digital_nomad_visa info, budget_estimate
- destination required; days default 5; style optional (cultural|adventure|relaxation|foodie); budget optional (budget|mid-range|luxury)
- Includes Expedia affiliate links for hotels, VRBO, car rental, and flights in booking_links
- Optional: lang
- Price: $0.20

GET /api/travel/deals?destination={destination}&lang={lang}
- Current hotel deals, vacation rental deals (VRBO), car rental deals, attraction discounts, and money-saving tips
- Returns: hotel_deals, vacation_rental_deals (VRBO-specific), car_rental_deals (Expedia Cars), attraction_deals, restaurant_deals, money_saving_tips, best_booking_windows
- destination required
- Includes Expedia affiliate links (Hotels.com, VRBO, car rental) in booking_links
- Optional: lang
- Price: $0.08

GET /api/travel/budget?destination={destination}&days={n}&budget_tier={tier}&travelers={n}&lang={lang}
- Per-category cost breakdown for destination and duration
- Returns: daily_budget_usd, total_trip_budget_usd, breakdown (accommodation/food/transport/activities/visa/insurance), car_rental_budget, hidden_costs, money_saving_tips, free_things_to_do
- destination required; days default 10; budget_tier optional (budget|mid_range|comfort|luxury); travelers optional
- Optional: lang
- Price: $0.10

### Language Tools

GET /api/travel/translate?text={text}&to={language}&from={language}&context={context}&lang={lang}
- Natural travel-context translation with pronunciation guide and cultural notes
- Returns: translation, pronunciation, cultural_notes, alternative_phrases, formality_note
- text and to required; from optional; context optional (dining|transport|hotel|shopping|emergency)
- Price: $0.03

GET /api/travel/phrasebook?language={language}&context={context}&lang={lang}
- Practical travel phrasebook for any language with pronunciation — the phrases you'd actually use
- context options: dining | transport | hotel | shopping | emergency | directions | medical
- Returns: phrases array with romanization, pronunciation guide, cultural tips, and situations to use
- language required; context optional
- Price: $0.05

### Pre-Trip Intelligence

GET /api/travel/visa?passport={country}&destination={country}&lang={lang}
- Visa requirements, e-visa options, and entry rules by passport and destination
- Returns: visa_required, visa_on_arrival, e_visa, passport_validity_required, max_stay_days, entry_requirements, application_process, cost_usd, processing_time
- passport and destination required
- Optional: lang
- Price: $0.08

GET /api/travel/health?destination={destination}&lang={lang}
- CDC travel health advisories, required and recommended vaccines, malaria zones, food/water safety
- Returns: health_risk_level, required_vaccines, recommended_vaccines, malaria_risk, food_water_safety, travel_medicine_resources, nearest_medical_care
- destination required
- Optional: lang
- Price: $0.08

GET /api/travel/currency?destination={destination}&lang={lang}
- Currency exchange strategy, best no-fee cards, ATM strategy, cash vs card by region
- Returns: local_currency, cash_dependency, card_acceptance, atm_strategy, recommended_cards (credit + debit), money_mistakes_to_avoid, tipping_culture, travel_money_essentials with Amazon links (RFID wallet, money belt)
- destination required
- Optional: lang
- Price: $0.08

GET /api/travel/insurance?destination={destination}&trip_type={type}&lang={lang}
- Travel insurance recommendation by trip type with SafetyWing, WorldNomads, and premium options
- Returns: recommended_plan_type, primary_recommendation (provider/cost/coverage), alternatives, must_have_coverages, common_exclusions, credit_card_supplement_note, compare_quotes_at
- destination required; trip_type optional (e.g. backpacker, family, adventure, business, cruise, digital nomad)
- Optional: lang
- Price: $0.08

GET /api/travel/pack?destination={destination}&days={n}&style={style}&lang={lang}
- Destination-specific packing list with carry-on optimization and Amazon product recommendations
- Returns: climate, clothing (with Amazon search links), gear (essential/recommended/optional), electronics, toiletries, buy_at_destination, carry_on_only_possible, weight_estimate_lbs
- destination required; days optional; style optional
- Optional: lang
- Price: $0.10

## Discovery

- OpenAPI spec: https://travelpulse-nu.vercel.app/openapi.json
- Agent discovery: https://travelpulse-nu.vercel.app/.well-known/agent.json

## Notes for AI Agents

- Full pre-trip research flow: /api/travel/visa → /api/travel/health → /api/travel/currency → /api/travel/insurance → /api/travel/budget → /api/travel/pack
- Full planning flow: /api/travel/plan → /api/travel/deals → /api/travel/weather
- Park visit flow: /api/parks/crowds → /api/parks/hours → /api/parks/waits
- /api/travel/deals includes car rental and VRBO vacation rental intelligence — not just hotels
- /api/travel/plan always includes car rental recommendation (when to rent vs use transit) and VRBO-specific guidance
- /api/travel/currency includes Amazon affiliate links for travel money gear (RFID wallet, money belt)
- /api/travel/pack and /api/travel/plan include Amazon affiliate product recommendations
- Affiliate booking links (Hotels.com, VRBO, Expedia Cars, Expedia flights, vacation packages) are injected server-side into plan and deals responses
- destination= accepts any location on earth — city, town, region, country, even small communities
- All endpoints support ?lang= for native-language responses — Claude responds in the requested language
- /api/travel/translate and /api/travel/phrasebook require no external API keys — powered entirely by Claude
- /api/travel/plan supports digital nomad visa detection for trips over 30 days
- /api/travel/plan includes credit card optimization (Chase Sapphire, Amex Platinum) — CDW waiver tip saves $15-25/day on car rentals