Search for hotel & package offers
POST
/listPackagedHotelProducts
Request
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location --request POST 'https://api.ygo.ai/v1/listPackagedHotelProducts' \
--header 'Content-Type: application/json' \
--data-raw '{
"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 2025-10-17 15:39:50