1. Product Search (Deprecated)
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
    • Product Search (Deprecated)
      • Search for hotel & package offers
        POST
      • Get transfers for booking
        POST
      • Get package price calendar
        POST
    • 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. Product Search (Deprecated)

Search for hotel & package offers

Deprecated
POST
/listPackagedHotelProducts
The classic way to search for hotels and hotel+flight packages provided by connected Amadeus & Peakwork supply.
This endpoint enables you to search for individual hotel-only and hotel packages by location (geographic radius or polygon), travel dates, traveler composition, and quality preferences. The system automatically enforces minimum hotel quality standards (category and review scores) and supports flexible search options including direct flights, luggage preferences, and custom sorting. Results include comprehensive pricing, hotel details, and flight information, with optional caching for improved performance.
Non-bookable content is harmonized, improved and augmented using AI.

Request

Authorization
or
Body Params application/json

Examples

Responses

🟢200OK
application/json
Successfully retrieved hotel packages with flight options
Headers

Bodyapplication/json

🟠400Bad Request
🟠401Unauthorized
🔴500Server Error
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://api.ygo.ai/v1/listPackagedHotelProducts' \
--header 'Content-Type: application/json' \
--data '{
    "DepartureDate": "2025-11-15",
    "ReturnDate": "2025-11-22",
    "Latitude": 41.3874,
    "Longitude": 2.1686,
    "Radius": 50000,
    "PersonAges": [
        30,
        28
    ],
    "Locale": "en",
    "MinimumCategory": 4,
    "MinimumScore": 80,
    "DepartureAirports": [
        "FRA",
        "MUC"
    ],
    "Limit": 20,
    "Offset": 0
}'
Response Response Example
200 - Successful package search results
{
    "Data": [
        {
            "ID": 12345,
            "Type": "flight+hotel",
            "Provider": "Peakwork",
            "ProviderID": "PW-HTL-9876",
            "CountryCode": "ES",
            "Latitude": 41.3851,
            "Longitude": 2.1734,
            "Distance": 2.3,
            "Rating": 5.2,
            "Price": 1289.99,
            "Texts": {
                "Locales": {
                    "en": {
                        "Name": "Hotel Arts Barcelona",
                        "City": "Barcelona",
                        "Country": "Spain",
                        "ShortText": "Luxury beachfront hotel with stunning Mediterranean views",
                        "Description": "Experience unparalleled luxury at this iconic 5-star beachfront hotel featuring world-class dining, spa facilities, and breathtaking views of the Mediterranean Sea and Barcelona skyline."
                    }
                }
            },
            "Images": [
                {
                    "URL": "https://cdn.ygo.ai/hotels/12345/main.jpg",
                    "Width": 1920,
                    "Height": 1080,
                    "Type": "main"
                }
            ],
            "Details": {
                "Category": 5,
                "RatingAverage": 5.2,
                "RatingCount": 3847,
                "RecommendationScore": 92,
                "Hotel": {
                    "HotelbedsCode": 123456,
                    "LocalizedRooms": {
                        "en": [
                            {
                                "RoomCode": "DBL.ST",
                                "Description": "Double Standard Room with Sea View",
                                "MinPax": 1,
                                "MaxPax": 2,
                                "MaxAdults": 2,
                                "MinAdults": 1,
                                "Type": {
                                    "Code": "DBL",
                                    "Description": {
                                        "Content": "Double Room"
                                    }
                                }
                            }
                        ]
                    },
                    "LocalizedFacilities": {
                        "en": [
                            {
                                "FacilityCode": 10,
                                "FacilityGroupCode": 70,
                                "Description": {
                                    "Content": "Outdoor Swimming Pool"
                                },
                                "Number": 2,
                                "IndYesOrNo": true
                            },
                            {
                                "FacilityCode": 550,
                                "FacilityGroupCode": 60,
                                "Description": {
                                    "Content": "Spa"
                                },
                                "IndFee": true
                            }
                        ]
                    },
                    "RoomImages": {
                        "DBL.ST": [
                            {
                                "URL": "https://cdn.ygo.ai/hotels/12345/rooms/dbl-st-1.jpg",
                                "Width": 1920,
                                "Height": 1080,
                                "Type": "room"
                            }
                        ]
                    },
                    "RoomFeatures": {
                        "DBL.ST": {
                            "SquareMeters": 35,
                            "HasBalcony": true,
                            "HasWifi": true,
                            "HasTV": true,
                            "HasAirCondition": true,
                            "HasMinibar": true,
                            "HasShower": true,
                            "HasBathtub": false,
                            "WheelchairAccessible": false
                        }
                    },
                    "Stars": 5,
                    "Exists": true,
                    "PetsAllowed": false,
                    "HasPool": true,
                    "HasSpa": true,
                    "HasWifi": true,
                    "HasRestaurant": true,
                    "Has24hReception": true,
                    "HasParking": true,
                    "Features": {
                        "PetsAllowed": "no",
                        "Pool": "yes",
                        "Spa": "yes",
                        "Fitness": "yes",
                        "Wifi": "yes",
                        "Bar": "yes",
                        "Restaurant": "yes",
                        "Elevator": "yes",
                        "AirCondition": "yes",
                        "Breakfast": "yes",
                        "Parking": "yes",
                        "Reception24h": "yes",
                        "WheelchairAccessible": "unknown"
                    }
                },
                "PackageOffers": [
                    {
                        "TourOperator": {
                            "Code": "FTI",
                            "Name": "FTI Touristik"
                        },
                        "Accommodation": {
                            "Code": "DBL-SEA",
                            "LengthOfStay": 7,
                            "ArrivalDate": "2025-11-15",
                            "Rooms": [
                                {
                                    "Description": "Double Room Sea View",
                                    "Board": "Half Board",
                                    "BoardCode": "HB",
                                    "Code": "DBL-SEA"
                                }
                            ]
                        },
                        "Transport": {
                            "Departure": {
                                "TransportType": "FLIGHT",
                                "DepartureAirport": {
                                    "Code": "FRA",
                                    "Name": "Frankfurt Airport"
                                },
                                "ArrivalAirport": {
                                    "Code": "BCN",
                                    "Name": "Barcelona El Prat Airport"
                                },
                                "DepartureDateTime": "2025-11-15T08:30:00",
                                "ArrivalDateTime": "2025-11-15T10:45:00",
                                "FlightNumber": "LH1134",
                                "Airline": {
                                    "Code": "LH",
                                    "Name": "Lufthansa"
                                },
                                "Duration": 135,
                                "StopOver": 0
                            },
                            "Return": {
                                "TransportType": "FLIGHT",
                                "DepartureAirport": {
                                    "Code": "BCN",
                                    "Name": "Barcelona El Prat Airport"
                                },
                                "ArrivalAirport": {
                                    "Code": "FRA",
                                    "Name": "Frankfurt Airport"
                                },
                                "DepartureDateTime": "2025-11-22T18:15:00",
                                "ArrivalDateTime": "2025-11-22T20:30:00",
                                "FlightNumber": "LH1135",
                                "Airline": {
                                    "Code": "LH",
                                    "Name": "Lufthansa"
                                },
                                "Duration": 135,
                                "StopOver": 0
                            }
                        },
                        "Price": {
                            "Amount": 1289.99,
                            "PriceByPax": [
                                {
                                    "PersonType": "ADULT",
                                    "Amount": 644.99,
                                    "RefID": 1
                                },
                                {
                                    "PersonType": "ADULT",
                                    "Amount": 644.99,
                                    "RefID": 2
                                }
                            ]
                        },
                        "PricePerNight": {
                            "Amount": 184.28
                        },
                        "PricePerPerson": {
                            "Amount": 644.99
                        },
                        "Brand": "FTI"
                    }
                ]
            },
            "Status": "online"
        }
    ],
    "Error": null
}
Modified at 2026-04-14 07:23:47
Previous
Product Search (Deprecated)
Next
Get transfers for booking
Built with