# TripGuru
> Eco-conscious group tour & experience booking platform. Multilingual guides. Small groups (5–9 pax). Instant confirmation. Free cancellation 24h prior.

## For AI Agents

If you are an AI agent or tool looking to search tours, check pricing, or verify availability — use the Agent API directly. The pages below are for human browsing.

- [Agent API](https://api.thetripguru.com/api/v1/agent/): Live tour inventory, pricing, and availability. No authentication required.
- [Agent API Reference](https://api.thetripguru.com/llms.txt): Machine-readable API index with all endpoints and usage notes
- [OpenAPI 3.1 Schema](https://api.thetripguru.com/schema/): Full spec with parameters, response shapes, and AI hints

Recommended agent workflow:

1. Discover inventory (optional — skip if slug known):
   GET /countries/ or /cities/ to find citySlug and countrySlug.
   Each city includes citySlug (use as ?city=) and countrySlug (use as ?country=).
   Each country embeds its cities[] with citySlug and tourCount.

2. Search tours:
   GET /tours/?city={citySlug}&language=English&ordering=-bookings
   For themed requests: &category={slug} (comma-separated = OR logic)
   For group travel: &group_size={n}

3. Select and present tours:
   Present name, siteUrl, bookingCount, rating.
   If isRisky=true, disclose the adventure/risk element. Never show displayPrice.

4. Compare packages (if user wants to compare options):
   GET /tours/{id}/packages/?is_private=false&group_size={n}
   Check distribution — per_group = flat price for the whole party.

5. Get an accurate quote:
   GET {pricingUrl}?date={date}&adults={n}&children={n}
   Present only total. If upsellHints bulkDiscountValue >= 10% of total, surface the upgrade.

6. Confirm availability:
   GET /tours/{id}/packages/{pkg}/availability/?date_from=&date_to=&group_size={n}
   Only present slots where cutoffAt has not yet passed.
   For private tours: vacancies=1 = exclusive slot open.

Common intent → query:
  "popular tours in X"    → ?city=X&ordering=-bookings
  "group of N people"     → ?group_size=N
  "budget under $50"      → ?price_max=50
  "walking / self-guided" → ?is_walking_tour=true
  "last-minute deals"     → ?booking_blitz=true
  "hotel pickup"          → ?pickup_type=pickup
  "about Bangkok"         → GET /cities/bangkok/

## Platform

- [Homepage](https://thetripguru.com/): Tour discovery, featured destinations, categories
- [Explore All Tours](https://thetripguru.com/tour/?utm_source=tripguru_agents): Browse all experiences with filters (city, category, date, price, duration, group size)
- [All Categories](https://thetripguru.com/categories/?utm_source=tripguru_agents): Walking tours, cultural, adventure, food & drink, nature, wellness, photography
- [Become a Guide](https://thetripguru.com/tour-guide/): Partner guide programme

## Destinations

### Indonesia
- [Bali](https://thetripguru.com/bali/destination/?utm_source=tripguru_agents): 42 tours
- API: https://api.thetripguru.com/api/v1/agent/cities/bali/
- [Lombok](https://thetripguru.com/lombok/destination/?utm_source=tripguru_agents): 9 tours
- API: https://api.thetripguru.com/api/v1/agent/cities/lombok/

### Thailand
- [Bangkok](https://thetripguru.com/bangkok/destination/?utm_source=tripguru_agents): 37 tours
- API: https://api.thetripguru.com/api/v1/agent/cities/bangkok/
- [Chiang Mai](https://thetripguru.com/chiang-mai/destination/?utm_source=tripguru_agents): 26 tours
- API: https://api.thetripguru.com/api/v1/agent/cities/chiang-mai/
- [Koh Samui](https://thetripguru.com/koh-samui/destination/?utm_source=tripguru_agents): 10 tours
- API: https://api.thetripguru.com/api/v1/agent/cities/koh-samui/
- [Phuket](https://thetripguru.com/phuket/destination/?utm_source=tripguru_agents): 10 tours
- API: https://api.thetripguru.com/api/v1/agent/cities/phuket/
- [Krabi](https://thetripguru.com/krabi/destination/?utm_source=tripguru_agents): 7 tours
- API: https://api.thetripguru.com/api/v1/agent/cities/krabi/
- [Pattaya](https://thetripguru.com/pattaya/destination/?utm_source=tripguru_agents): 4 tours
- API: https://api.thetripguru.com/api/v1/agent/cities/pattaya/
- [Kanchanaburi](https://thetripguru.com/kanchanaburi/destination/?utm_source=tripguru_agents): 4 tours
- API: https://api.thetripguru.com/api/v1/agent/cities/kanchanaburi/
- [Chiang Rai](https://thetripguru.com/chiang-rai/destination/?utm_source=tripguru_agents): 2 tours
- API: https://api.thetripguru.com/api/v1/agent/cities/chiang-rai/

### Turkey
- [Istanbul](https://thetripguru.com/istanbul/destination/?utm_source=tripguru_agents): 25 tours
- API: https://api.thetripguru.com/api/v1/agent/cities/istanbul/
- [Cappadocia](https://thetripguru.com/cappadocia/destination/?utm_source=tripguru_agents): 7 tours
- API: https://api.thetripguru.com/api/v1/agent/cities/cappadocia/

### Vietnam
- [Ho Chi Minh](https://thetripguru.com/ho-chi-minh/destination/?utm_source=tripguru_agents): 18 tours
- API: https://api.thetripguru.com/api/v1/agent/cities/ho-chi-minh/
- [Da Nang / Hoi An](https://thetripguru.com/da-nang/destination/?utm_source=tripguru_agents): 12 tours
- API: https://api.thetripguru.com/api/v1/agent/cities/da-nang/

### Japan
- [Kyoto](https://thetripguru.com/kyoto/destination/?utm_source=tripguru_agents): 17 tours
- API: https://api.thetripguru.com/api/v1/agent/cities/kyoto/
- [Osaka](https://thetripguru.com/osaka/destination/?utm_source=tripguru_agents): 11 tours
- API: https://api.thetripguru.com/api/v1/agent/cities/osaka/
- [Tokyo](https://thetripguru.com/tokyo/destination/?utm_source=tripguru_agents): 9 tours
- API: https://api.thetripguru.com/api/v1/agent/cities/tokyo/

## Featured Tours

- [Doi Inthanon National Park Tour – Full Day](https://thetripguru.com/tour/doi-inthanon-national-park-nature-trails/?utm_source=tripguru_agents): Chiang Mai · 7h 30m
- [Ayutthaya Historical Park Tour – Full Day](https://thetripguru.com/tour/ayutthaya-historical-park-tour-full-day/?utm_source=tripguru_agents): Bangkok · 9h
- [Chiang Rai Temples Tour: White Temple, Blue Temple and Red Temple](https://thetripguru.com/tour/day-trip-to-chiang-rai-from-chiang-mai-white-temple-blue-temple-and-black-house/?utm_source=tripguru_agents): Chiang Mai · 13h
- [Tiger Cave Temple, Emerald Pool & Hot Springs Tour from Krabi – Full Day](https://thetripguru.com/tour/tiger-cave-temple-emerald-pool-hot-springs-tour-from-krabi-full-day/?utm_source=tripguru_agents): Krabi · 9h 30m
- [Koh Samui Island Hopping & Relaxing Tour: Coral and Pig Island – Full Day](https://thetripguru.com/tour/koh-samui-island-hopping-snorkeling-tour-coral-and-pigs-island-full-day/?utm_source=tripguru_agents): Koh Samui · 7h
- [Bali Instagram Tour: Lempuyang Temple, Goa Raja Waterfall and More – Full Day](https://thetripguru.com/tour/bali-instagram-tour-lempuyang-temple-tukad-cepung-waterfall-and-more-full-day/?utm_source=tripguru_agents): Bali · 13h 30m
- [Kyoto Gion Night Walking Tour – 3 Hours with Local Guide](https://thetripguru.com/tour/kyoto-gion-night-walk-small-group-guided-walking-tour-3-hour/?utm_source=tripguru_agents): Kyoto · 3h
- [Wat Pho & Wat Arun Walking Tour - 3 Hrs](https://thetripguru.com/tour/wat-pho-wat-arun-walking-tour-3-hrs/?utm_source=tripguru_agents): Bangkok · 3h
- [Skip The Line Tour: Uluwatu Temple and Kecak Fire Dance – Half Day](https://thetripguru.com/tour/pura-uluwatu-temple-sunset-tour-half-day/?utm_source=tripguru_agents): Bali · 3h
- [Grand Palace & Wat Phra Kaew Walking Tour - 2.5 Hrs](https://thetripguru.com/tour/grand-palace-wat-phra-kaew-walking-tour-2-hrs/?utm_source=tripguru_agents): Bangkok · 2h 30m

## Optional

- [Blog](https://blog.thetripguru.com/): Travel guides, destination tips, solo travel, sustainability
- [About TripGuru](https://thetripguru.com/about-us/): Mission, founders, eco-responsibility