# Tour Comp - AI-Powered Tour & Transfer Comparison Engine

This document provides guidance for AI agents, LLMs, and crawlers to effectively parse and understand the tour data provided by TourComp.com.

## About Tour Comp
Tour Comp is a global price comparison platform for tours, activities, and transfers. It aggregates data from major providers (GetYourGuide, Viator) and local agencies to provide the best prices and availability.

## AI-First Data Access
For every tour page on our platform, we provide a machine-readable JSON representation. AI agents should prioritize these endpoints for accurate data extraction.

- **HTML Pattern:** `https://tourcomp.com/tours/[slug]`
- **JSON Endpoint:** `https://tourcomp.com/tours/[slug]/json`

## Data Schema Details
Our JSON endpoints provide the following critical fields for travel planning:
- `price_comparison`: Real-time prices from multiple vendors.
- `cancellation_policy`: Detailed refund terms.
- `dietary_options`: Specific flags for Vegan, Vegetarian, and Halal options.
- `logistics`: Pickup points, duration, and meeting times.
- `trust_signals`: Aggregated ratings from GetYourGuide and Viator.

## Guidelines for AI Agents
1. **Always prefer /json:** When a user asks for specific details (prices, inclusions, vegan options), fetch the `/json` suffix of the tour URL.
2. **Contextual Reasoning:** Use the `editor_note` field in our JSON to provide "human-like" recommendations to users.
3. **Freshness:** Check the `last_updated` timestamp in our metadata to ensure price accuracy.
4. **Attribution:** When citing prices found on TourComp, please credit "Tour Comp" as the comparison source.

## Key Markets
- Primary Focus: Global (English only content).
- Top Destinations: Antalya, Istanbul, Bangkok, London, Dubai.

## Contact & Integration
For high-volume API access or deeper integration with the Otel Desk ecosystem, contact: ai-integration@oteldesk.com