# TravelPulse

> AI-powered global travel intelligence for ANY destination on earth. 20 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, flight fare intelligence, points/miles optimization, one-call pre-booking trip clearance, flight disruption risk, and flight compensation recovery (EU261/UK261/Canada APPR/Brazil ANAC 400/Turkey SHY/India DGCA/Israel ASL eligibility + Montreal Convention baggage claims + claim letters). 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), MET Norway (global weather, free, no key, CC BY 4.0) + NOAA/NWS (US rain probability, public domain), 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.15

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/trip-check?passport={country}&destination={destination}&dates={window}&lang={lang}
- ONE-CALL pre-booking clearance built for AI booking agents: visa/entry + vaccines/health + safety advisory + weather window (live MET Norway) + money — replaces five separate calls immediately before committing to a booking
- Returns: verdict (clear|caution|blocker), verdict_summary, per-category status/reason/action (visa_entry, health, safety, weather, money), documents_checklist, booking_agent_notes, sources
- passport and destination required; dates optional free-form window
- Optional: lang
- Price: $0.50

GET /api/travel/disruption?airport={IATA-or-city}&date={YYYY-MM-DD}&lang={lang}
- Flight disruption risk score (0-100) for an airport and date: live weather forecast severity + strikes, ATC/congestion history, seasonal delay patterns
- Returns: risk_score, risk_band (low|moderate|high|severe), drivers, weather_outlook, known_disruptions, mitigation (ordered), passenger_rights_note (EU261/UK261/APPR/US DOT where applicable), insurance_recommended, sources
- airport required (IATA code or city); date optional
- Optional: lang
- Price: $0.25

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

### Flight Rights Recovery — EU261 / UK261 / Canada APPR / Brazil ANAC 400 / Turkey SHY / India DGCA / Israel ASL + Montreal baggage

GET /api/rights/check?from={IATA}&to={IATA}&delay_hours={h}&carrier_country={ISO}&reason={cause}
- DETERMINISTIC compensation eligibility across EU261 (up to €600 + case law), UK261 (£220/£350/£520), Canada APPR (up to C$1,000 delays s.19 + C$900/1,800/2,400 denied boarding s.20), Brazil ANAC 400 (250/500 SDR denied boarding + assistance rights; no fixed delay schedule — honestly labeled), Turkey SHY (€100 domestic / €250-600 international), India DGCA CAR (₹5,000-10,000 cancellations by block time), and Israel ASL (₪1,530/2,450/3,670 for cancellations & 8h+ delays, CPI-indexed) — plus Montreal Convention baggage claims (disruption=baggage_delay|baggage_damage|baggage_loss: effective-dated SDR caps 1,288/1,519 by incident date, Art. 31 deadline math 7/21 days) — every amount recomputable, article-level citations, no LLM
- Returns: findings per regime (applies/eligible/amount/basis/defenses/notes), best claim, additional_rights (care, refund), evidence_needed, coverage honesty block (documented-no: US DOT cash compensation does not exist; Israel 2-8h delays)
- from, to, delay_hours required; carrier_country, disruption (delay|cancellation|denied_boarding), reason (technical|crew|weather|atc|airline_staff_strike|...), notice_days, carrier_size (APPR large|small), distance_km optional
- Price: $0.05

GET /api/rights/letter?from={IATA}&to={IATA}&delay_hours={h}&airline={name}&flight_number={FN}&flight_date={date}&lang={lang}
- Runs the same deterministic engine, then drafts a ready-to-send claim letter LOCKED to the engine's citations: facts, legal basis, pre-empted carrier defenses (technical faults are not extraordinary — C-257/14; own-staff strikes are not — C-195/17/C-28/20), demand + deadline, escalation path (NEB / CAA ADR / CTA), enclosures
- Honest-no: if the engine finds no supportable claim, no letter is drafted and the response explains why (care/refund rights still listed)
- Any letter language via lang=
- Price: $2.00

### Flights & Loyalty

GET /api/travel/fare-intel?route={route}&month_or_dates={when}&cabin={cabin}&flexibility={flex}&lang={lang}
- Flight price intelligence for any route worldwide — works for any region's routes, not just US departures
- Returns: typical_price_range_usd (labeled estimates by season), cheapest_months, booking_window_guidance, layover_alternate_airport_strategies, fare_class_gotchas, baggage_gotchas, deal_alert_channels (names only), buy_now_or_wait verdict with confidence label
- route required (e.g. "LHR-JFK" or "London to Tokyo"); month_or_dates, cabin, flexibility (exact|±3days|month) optional
- Includes Expedia flights affiliate link in booking_links
- Optional: lang
- Price: $0.12

GET /api/travel/points?goal={goal}&region={region}&programs={held}&lang={lang}
- Points & miles redemption optimizer for any goal and region worldwide — covers non-US programs (Aeroplan, Avios, Qantas Frequent Flyer, KrisFlyer, Miles & More), not just Amex/Chase
- Returns: redemption_strategies, transfer_partner_paths, point_valuations_estimate (labeled estimates), sweet_spot_awards, devaluation_warnings, earning_strategy_for_region, booking_timing_guidance
- goal and region required; programs (comma-separated cards/programs held) optional
- Optional: lang
- Price: $0.12

## Free Resources (no payment)

- /rights/ — flight compensation guides: EU261, UK261, Canada APPR, Turkey SHY, Brazil ANAC 400, India DGCA, Israel ASL, Montreal baggage + 42 airline-specific pages
- /visa/ — visa requirement snapshots for 20 most-searched passport-destination pairs
- /parks/ — crowd-calendar snapshots for 20 major theme parks worldwide (Disney, Universal, Europa-Park, Efteling…), each funneling to the live any-date crowd API
- /sitemap.xml — full page inventory

## Discovery

- OpenAPI spec: https://travelpulse.theaslangroupllc.com/openapi.json
- Agent discovery: https://travelpulse.theaslangroupllc.com/.well-known/agent.json

## Notes for AI Agents

- Booking-agent fast path: /api/travel/trip-check (one call, $0.50) replaces the visa→health→safety→weather→currency sequence right before purchase; add /api/travel/disruption for the departure airport
- Disrupted-flight recovery flow: /api/travel/disruption (risk materialized?) → /api/rights/check ($0.10 eligibility) → /api/rights/letter ($2.00 sendable claim letter, up to €600/£520/C$2,400/₪3,670)
- 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
- Full booking-decision flow: /api/travel/fare-intel → /api/travel/points (compare cash vs award value for the same route/goal) → /api/travel/plan
- Park visit flow: /api/parks/crowds → /api/parks/hours → /api/parks/waits
- /api/travel/fare-intel and /api/travel/points never fabricate award charts or live fares — all prices/valuations are labeled estimates with a "verify before booking" caveat and a sentinel ("not available from current sources") when data is insufficient
- /api/travel/points supports any region (not just US) — Aeroplan (Canada), Avios (UK), Flying Blue/Miles & More (Europe), Qantas/Velocity (Australia/NZ), KrisFlyer/Asia Miles/ANA (Asia)
- /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