1. AI Search & Trip Planning
YGO Client API
v1
  • v2
  • v1
  • Default Module
    • Overview
    • Core Concepts
    • Authentication
    • Quickstart Guide
    • AI Search & Trip Planning
    • Booking Flow
    • Environments
    • General
      • Check API health status
      • Get current API key context
    • AI Search & Trip Planning
      • Send message to YGO AI
        POST
    • Product Search (Deprecated)
      • Search for hotel & package offers
      • Get transfers for booking
      • Get package price calendar
    • Bookings
      • Get or create open booking
      • Check offer availability
      • Update open booking
      • Update booking status and trigger workflows
      • List bookings
      • Get booking
    • Schemas
      • Schemas
        • PackageSearchRequest
        • GetPackageCalendarRequest
        • GetBookingRequest
        • ListBookingsRequest
        • SaveBookingStatusRequest
        • SaveOpenBookingRequest
        • GetOpenBookingRequest
        • GetTransfersRequest
        • Product
        • Booking
        • TransferOptionsResponse
        • PackageCalendarResponse
        • ProductTexts
        • BookingDetails
        • TripReference
        • TransferOption
        • PackageCalendarDate
        • LocaleContent
        • BookingItemInput
        • Trip
        • ProductImage
        • TransferImage
        • BookingItem
        • Traveller
        • PickupInformation
        • ProductDetails
        • PackageOffer
        • PickupLocation
        • Image
        • Pickup
        • TourOperator
        • CheckPickup
        • Accommodation
        • TransferRemark
        • Room
        • CancellationPolicy
        • Transport
        • Flight
        • Airport
        • Price
        • PriceByPax
        • SuccessResponse
        • ErrorResponse
        • Hotel
        • HotelFeatures
        • FeatureState
        • RoomFeatures
        • RoomContent
        • Facility
      • Response
        • Unauthorized
  1. AI Search & Trip Planning

Send message to YGO AI

POST
/sendMessage

Process travel queries using YGO AI's advanced multi-agent system with augmented, multi-source hotel data. Supports natural language, structured data, or hybrid inputs for maximum flexibility.

Choose Your Model:

ModelSpeedUse CaseBest For
packagelist<3sPackage search with smart filtersHotel discovery, search refinement
hotelinfo<2sHotel details and amenities"Ask about hotel" features, Q&A
hotelreviews<2sGuest review analysisReview summaries, sentiment insights
activityinfo<2sActivity/tour informationActivity details, tour Q&A
hotellist <3sHotel-only searchHotel-only suppliers, accommodation-focused projects
agency_packagelist<2sAgency package search with structured inputB2B travel-agent integrations, CRM-driven deterministic searches
agency_hotellist<2sAgency hotel-only search with structured inputB2B travel-agent hotel-only workflows, accommodation-only bookings
"" (empty)5-10sFull trip planningComplex itinerary generation

Key Capabilities:

  • Multi-Modal Input: Accept text prompts, structured parameters, or both
  • Superior Data Quality: Hotel information augmented from multiple sources for unmatched accuracy and completeness
  • Multi-Layer Smart Filtering: Three-tier filter architecture from basic supplier filters to deep content search
  • Smart Package Search: Find hotels with flexible durations, enhanced filters, and conversion-driven ranking
  • Hotel Intelligence: Get detailed information with integrated guest review analysis
  • Activity Details: Comprehensive activity and attraction information
  • 50+ Languages: Full localization including responses, quick replies, and product summaries
  • Lightning Fast: Specialized models are 80% faster than full planning flow

How It Works:

  1. Send a message (natural language, structured data, or both)
  2. YGO AI routes to the optimal AI flow based on your Model parameter
  3. Receives intelligent, context-aware response with recommendations
  4. Continue conversation using same ChatID for iterative refinement

Coming Soon: Voice input support for hands-free experiences.

Request

Authorization
or
Body Params application/json

Examples

Responses

🟢200OK
application/json
Message processed successfully
Bodyapplication/json

🟠400Bad Request
🟠401Unauthorized
🟠404Record Not Found
🔴500Server Error
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://api.ygo.ai/v1/sendMessage' \
--header 'Content-Type: application/json' \
--data '{
    "ChatID": "chat_abc123",
    "Content": "I want a beach hotel in Greece with pool for around 5 nights in August under €1500",
    "UserID": "user_customer123",
    "Locale": "en",
    "Model": "packagelist"
}'
Response Response Example
200 - Package search results
{
    "Data": {
        "ID": "run_xyz789",
        "ChatID": "chat_abc123",
        "UserID": "user_customer123",
        "Content": "Find me hotels in Barcelona with pool for around 5 nights",
        "Locale": "en",
        "Model": "packagelist",
        "TripParams": {
            "Destination": "Barcelona",
            "DestinationName": "Barcelona, Spain",
            "StartDate": "2025-06-15",
            "EndDate": "2025-06-20",
            "FlexibleNights": [
                4,
                5,
                6
            ],
            "StayDirectDuration": 5,
            "TravellersAmount": 2,
            "Latitude": 41.3851,
            "Longitude": 2.1734,
            "Packages": [
                {
                    "ID": 12345,
                    "HotelName": "Hotel Barcelona Beach",
                    "Price": {
                        "Amount": 850,
                        "Currency": "EUR",
                        "PerPerson": true
                    },
                    "Details": {
                        "Hotel": {
                            "Features": {
                                "Pool": "yes",
                                "Wifi": "yes",
                                "AirCondition": "yes"
                            },
                            "StarRating": 4,
                            "Images": [
                                {
                                    "URL": "https://cdn.ygo.ai/hotels/12345_main.jpg"
                                }
                            ]
                        }
                    },
                    "ConversionScore": 0.92
                }
            ]
        },
        "Messages": [
            {
                "Role": "assistant",
                "Content": "I found 45 hotels in Barcelona with pool for 4-6 nights starting June 15th. The results are sorted by best match based on your preferences. Prices range from €750 to €1,450 per person."
            }
        ],
        "QuickReplies": [
            "Show only 4-star hotels",
            "Filter by budget under €1000",
            "Hotels near the beach",
            "Add gym and spa filter"
        ],
        "Intents": [
            "PACKAGE_SEARCH",
            "HOTEL_WITH_POOL"
        ],
        "Instructions": []
    },
    "Error": null
}
Modified at 2026-05-06 11:36:35
Previous
Get current API key context
Next
Product Search (Deprecated)
Built with