AI Search & Trip Planning
Overview#
The API features YGO AI, a sophisticated AI-powered system for travel search and planning. Unlike traditional search APIs that rely solely on supplier-provided data and rigid parameter structures, YGO AI aggregates, augments, and enhances hotel, flight, transfer, and activity information from multiple sources to deliver more complete and accurate results.Multi-Modal Intelligence: Accept natural language prompts, structured data, or combinations of both - YGO AI adapts to your input format
Superior Data Quality: Augmented travel product information from multiple sources ensures fresher, more complete, and more accurate data than supplier APIs aloneHotels: Enhanced amenity details (up to 50 features), enriched descriptions, curated guest reviews, verified location data, and high-quality images aggregated from multiple platforms for unmatched completeness
Activities: Detailed inclusions/exclusions, accurate duration and timing, verified meeting points, guest experience insights, and authentic reviews analyzed for quality and relevance
Flights & Transfers: Optimized with real-time availability and routing intelligence
Multi-Layer Smart Filtering: Three-tier filter architecture from basic supplier filters to deep content search across reviews, descriptions, and metadata
Lightning-Fast Responses: Specialized AI flows deliver results in under 2 seconds for focused queries
Context-Aware: Maintains conversation history for natural, iterative refinement of search criteria
Sales-driven Recommendation Engine: Results optimized by balancing user preferences with commercial performance objectives
Multi-Lingual: Understands and responds in 50+ languages including English, German, French, Spanish, Italian, Portuguese, Chinese, Japanese, Korean, Arabic, and more - with fully localized responses, quick replies, and product summaries
Core Capabilities#
Smart Package Search#
Search hotel packages with enhanced flexibility using augmented, multi-source data for more accurate results.Natural Language Processing: "Find me a beach hotel in Greece for around 5 nights in July" → YGO AI extracts all parameters
Flexible Duration Search: Automatically searches multiple durations (e.g., "around 5 nights" → searches 4, 5, and 6 nights)
Multi-Layer Smart Filtering: Three-tier filter architecture for unmatched search precision:Layer 1: Supplier-native filters (star rating, room type, board type)
Layer 2: Enhanced hotel features (up to 50 augmented amenities beyond industry standards)
Layer 3: Deep content search across reviews, descriptions, images, and metadata
Augmented Product Data: Travel information aggregated and enhanced from multiple sources for superior accuracy and completenessHotels: Up to 50 enriched amenity features, verified guest reviews, location intelligence
Activities: Detailed logistics, guest experience analysis, requirement validation
Budget Optimization: Filters packages to match budget constraints with intelligent price sorting
Recommendation Ranking: Results sorted by AI-powered relevance scoring based on user preferences
Aggregates amenity data from suppliers, review platforms, and content providers to achieve up to 50 verified features per property
Cross-references guest reviews to validate facility claims and surface hidden insights
Enhances location data with proximity intelligence and neighborhood context
Enriches official descriptions with verified guest experiences and practical details
Validates meeting points, timings, and requirements against actual traveler feedback
Analyzes reviews to extract specific insights about guides, group sizes, and experience quality
Package discovery on your website's search page
Complex natural language searches across reviews and descriptions
Budget-constrained searches with quality optimization
Feature-specific hotel filtering with enhanced amenity data
Multi-Source Intelligence: Combines official hotel data with guest review insights
Source Attribution: Clearly distinguishes between hotel-provided information and guest feedback
Review Analysis: Analyzes guest reviews for common themes, pros/cons, and sentiment
Contextual Responses: Answers specific questions about amenities, policies, location, and services
Quick Follow-Ups: AI-generated contextual follow-up questions guide user exploration
Hotel detail page Q&A features
"Ask about this hotel" chat widgets
Pre-booking information gathering
Guest review summarization
Comprehensive Details: Duration, timing, meeting points, inclusions/exclusions, requirements
Guest Experience Insights: Analysis of activity reviews and ratings
Source-Attributed Information: Clear distinction between official descriptions and guest feedback
Booking Requirements: Age limits, group size, accessibility, and special requirements
Activity detail page enhancements
"Learn more about this tour" features
Pre-booking requirement validation
Activity comparison tools
Full Trip Planning (Advanced)#
Complete trip planning flow that transforms complex travel arrangements into walkable, optimized itineraries.Intelligent Itinerary Generation: Creates day-by-day activity plans that are actually walkableOptimizes routing based on real distances and travel times between locations
Respects opening hours and live availability for each activity
Considers logical flow (e.g., morning museum visits, afternoon outdoor activities)
Accounts for meal times and natural break points
Preference-Based Personalization: Adapts itineraries to individual traveler interestsFilters activities based on stated preferences (history, art, food, adventure, etc.)
Adjusts pace and intensity to match traveler style
Balances popular attractions with hidden gems based on preferences
Live Availability Integration: Uses real-time data to ensure activities are actually bookable
Multi-Agent Orchestration: Coordinates destination analysis, package search, itinerary creation, and budget validation
Conversational Refinement: Iteratively improves trip plans through natural dialogue
Complete trip planning assistants that generate ready-to-use itineraries
Travel concierge chat interfaces with intelligent day planning
Complex multi-city trip arrangements with optimized routing
Personalized itinerary builders that adapt to individual interests
Natural Language Only#
Send a text prompt - YGO AI extracts all parameters.Structured Data Only#
Send pre-extracted parameters - YGO AI validates and processes.Hybrid (Natural Language + Structured)#
Combine both for maximum control with natural enhancement.Coming Soon: Voice input support for hands-free search experiences.Specialized AI Models: Optimized for Speed#
YGO AI routes requests to specialized AI flows based on your use case, dramatically improving response times:| Model | Purpose | Response Time | Use Case |
|---|
packagelist | Package search with smart filters | <3 seconds | "Find beach hotels in Greece under €1500" |
hotelinfo | Hotel details and amenities | <2 seconds | "What time is check-in at this hotel?" |
hotelreviews | Guest review analysis | <2 seconds | "What do guests say about the breakfast?" |
activityinfo | Activity and attraction details | <2 seconds | "How long does this tour last?" |
"" (empty) | Full trip planning flow | 5-10 seconds | "Plan a 5-day trip to Paris for 2 people" |
80% faster for focused queries (hotel info, reviews, activities)
Reduced API costs through optimized processing
Better relevance with context-specific validation
Scalable architecture supporting new models without breaking changes
How Search Works: Under the Hood#
Package Search Flow (packagelist model)#
1.
Input Processing (Multi-Modal)Natural language: "Hotels in Barcelona with pool for around 5 nights"
Structured: {Destination: "Barcelona", FlexibleNights: [4,5,6]}
Hybrid: Combination of both
2.
Destination detection with geocoding
Flexible duration parsing (e.g., "around 5" → [4, 5, 6] nights)
Hotel feature extraction (pool, gym, spa, etc.)
Budget constraints and traveler counts
3.
Queries package inventory across multiple departure airports
Searches all flexible duration options simultaneously
Applies budget filters when specified
4.
Multi-Layer Smart FilteringLayer 1: Supplier-native filters (star rating, room type, meal plans)
Layer 2: Enhanced hotel features with AND logic (must have ALL requested features)
Layer 3: Deep content search across reviews, descriptions, and metadata
Quality filters (star ratings, review scores)
Flight preferences (times, direct flights only)
5.
Proprietary recommendation engine scores each result
Balances user preferences (current + historical behavior) with commercial objectives
Optimizes for high-margin inventory and strategic hotel partnerships
The system learns from successful bookings to improve future recommendations
Price-quality optimization
6.
Natural language explanation of results
Contextual quick replies for refinement
Clear attribution of filters applied
1.
Validates ProductID (hotel identifier)
Processes natural language question
Applies safety and relevancy checks
2.
Fetches official hotel details (amenities, policies, location)
Selects representative guest reviews (recent + extreme ratings)
Combines multiple data sources
3.
Processes question against hotel data and reviews
Distinguishes official information from guest feedback
Generates source-attributed response
4.
Adds contextual follow-up questions
Provides confidence levels for review-based statements
Handles off-topic queries gracefully
Smart Features in Detail#
Flexible Duration Search#
YGO AI automatically interprets duration flexibility:| User Input | Interpreted As | Nights Searched |
|---|
| "5 nights" | Exact duration | [5] |
| "around 5 nights" | Flexible ±1 | [4, 5, 6] |
| "approximately 7 nights" | Flexible ±1 | [6, 7, 8] |
| "3 to 5 nights" | Range | [3, 4, 5] |
| "between 4 and 7 nights" | Range | [4, 5, 6, 7] |
Increases availability by 3-5x compared to exact duration searches
Reveals better value options at nearby durations
Reduces "no results" scenarios
Multi-Layer Smart Filtering#
YGO AI employs a sophisticated three-tier filtering architecture that goes far beyond traditional search capabilities:Layer 1 - Supplier Native Filters:
Standard filters provided by booking suppliers (star rating, room type, board type, meal plans). Fast and efficient for basic categorization.Layer 2 - Enhanced Hotel Features:
Augmented feature set with up to 50 amenities that extend industry-standard classifications. Features are enriched and validated from multiple data sources for higher accuracy and completeness.Supported Enhanced Features Include:Pool, Spa, Sauna, Gym, Fitness
Pets Allowed, Wheelchair Accessible
WiFi, Air Conditioning, Elevator
Bar, Restaurant, Breakfast, Parking
And 30+ additional enhanced amenities
Searches across all available hotel data including guest reviews, descriptions, images, and metadata. Enables natural language queries like "hotels with rooftop terrace" or "good vegan breakfast praised by guests and a heated 50m pool, all close to the beach and train station"Example Queries Across All Layers:Layer 2: "Hotels with pool and gym where I can bring my dog" → Feature-based AND logic
Layer 3: "Hotels with rooftop bar and sea views" → Deep content search across descriptions and reviews
Combined: "4-star hotels with spa and highly rated breakfast" → Multi-layer filtering
AND logic: Hotels must match ALL requested criteria
Clear error messages when no hotels match criteria with alternative suggestions
Intelligent handling of feature synonyms and natural language variations
AI Recommendation Ranking#
Results are sorted by our proprietary recommendation engine which balances user satisfaction with commercial performance:Current session interests and search patterns
Historical booking behavior and preferences
Price-quality ratio optimization
Location desirability and accessibility
Guest review sentiment and ratings
Strategic inventory optimization (higher stock, better margins)
Supplier partnership priorities
Seasonal relevance and availability
Real-time booking trends and conversion data
Conversation Management#
Chat Sessions#
YGO AI maintains conversation context across multiple messages:1.
Create Chat → Get unique ChatID
2.
Send Messages → Maintains full context and history
3.
Iterative Refinement → Build on previous responses
User: "Find me hotels in Barcelona"
YGO AI: [Returns 50 hotels in Barcelona]
User: "Only show ones with a pool and under €150 per night"
YGO AI: [Refines previous results with new filters]
User: "What about the one near the beach?"
YGO AI: [Provides details on specific hotel from context]
Message History#
Each message (Run) contains:User input and extracted parameters
System responses and recommendations
Applied filters and search criteria
Selected packages and itinerary items
Localization & Multi-Lingual Support#
YGO AI understands and responds in 50+ languages, making it truly global:Primary Supported Languages:English, German, French, Spanish, Italian, Portuguese
Chinese, Japanese, Korean
Arabic, Dutch, Polish, Swedish, Norwegian, Danish, Finnish
And 35+ additional languages
Analyzes user input language automatically
Responds in the same language with proper grammar and cultural context
Generates localized quick reply suggestions in the user's language
Creates product summaries and descriptions in the detected language
No need to specify language for most queries - YGO AI adapts automatically
Locale parameter:"de": German responses (Deutsch)
And more (ISO 639-1 language codes)
Natural language responses with cultural nuances and local expressions
Error messages and validations in user's language
Quick reply suggestions contextually generated in the target language
Product summaries and descriptions adapted to local preferences
Hotel and activity information presented in user's language
Date and currency formatting per regional standards
Proper name handling and transliteration
Localized follow-up questions and conversation flows
Integration Patterns#
Search Page Integration#
Use Case: Main package search functionalityHotel Detail Page Q&A#
Use Case: "Ask about this hotel" featureFilter Refinement#
Use Case: Progressive filter applicationReview Analysis#
Use Case: Guest feedback summarizationBest Practices#
Model Selection#
Choose the right model for your use case:packagelist: Use for search, discovery, and filter-based queries✅ "Find hotels in Barcelona"
✅ "Show me beach resorts under €1000"
✅ "Hotels with pool and gym"
hotelinfo: Use for questions about specific hotel amenities and policies✅ "What's the check-in time?"
✅ "Does this hotel have a spa?"
✅ "How far is it from the airport?"
hotelreviews: Use for guest feedback and experience questions✅ "What do guests say about the service?"
✅ "Are there complaints about noise?"
✅ "How do guests rate the breakfast?"
activityinfo: Use for activity and attraction details✅ "How long does this tour last?"
✅ "What's included in this cooking class?"
✅ "Where is the meeting point?"
Empty model (""): Use for complex trip planning✅ "Plan a 5-day trip to Paris for 2 people"
✅ "Create an itinerary for Rome with historical sites"
1.
Use specialized models when possible (80% faster)
2.
Provide structured input alongside natural language for best results
3.
Reuse ChatID to maintain context without repeating parameters
4.
Set appropriate locale to avoid language detection overhead
5.
Include UserID for personalized recommendation ranking
Error Handling#
No results found: YGO AI provides clear explanation and suggests alternatives
Invalid parameters: Validation errors explain what's missing or incorrect
Off-topic queries: Specialized models politely redirect to relevant questions
Safety violations: Generic refusal messages for inappropriate content
Security Considerations#
Always include UserID: Required for identifying the end customer
Validate API responses: Check for errors before displaying results
Sanitize user input: Although YGO AI has protections, additional validation is recommended
Rate limiting: Implement reasonable rate limits to prevent abuse
Error message handling: Don't expose internal errors to end users
Example Workflows#
Workflow 1: Discovering the Perfect Hotel#
Workflow 2: Budget-Constrained Search#
Workflow 3: Activity Planning#
Response Structure#
All YGO AI responses follow a consistent structure:Technical Limits#
Max message length: 2000 characters
Timeout: 60 seconds per request
Max flexible nights range: 10 nights
Max hotel features per query: 50
Max packages returned: 100 per search
Max reviews analyzed per hotel: 1000
Enforced per API token at the project level
Contact support for enterprise rate limit increases
Modified at 2025-10-18 07:05:51
