Get enriched hotel
POST
/v2/project/content/getEnrichedHotel
HotelID is the hotel UUID, GlobalHotelID the cross-tenant identifier, ExternalHotelID a map of your own identifiers.ExternalHotelID sub-keys are productid and giata; several are AND-combined, so the hotel must match every key.giata returns 400.Retry-After seconds.Request
Header Params
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://api.ygo.ai/v2/project/content/getEnrichedHotel' \
--header 'X-Project-ID: ' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"HotelID": "0192fb17-5dc6-7abc-8def-123456789abc"
}'Response Response Example
200 - A fully enriched Mallorca-style hotel
{
"Data": {
"ID": "0192fb17-5dc6-7abc-8def-123456789abc",
"Name": "Bahia Azul Beach Resort",
"Names": {
"en-US": "Bahia Azul Beach Resort",
"de-DE": "Bahia Azul Strandresort"
},
"ExternalHotelIDs": {
"ProductID": "IBS-MAJ-4711",
"Giata": "668370"
},
"GlobalHotelID": "ES-MALLR-K7MP2",
"Stars": 4,
"AccommodationType": "resort",
"Chain": "Meliá Hotels International",
"Brand": "Sol by Meliá",
"Location": {
"Latitude": 39.5696,
"Longitude": 2.6502,
"CountryCode": "ES",
"Address": {
"Street": "Carrer de la Mar 12",
"City": "Palma",
"CityNames": {
"en-US": "Palma",
"de-DE": "Palma"
},
"State": "Illes Balears",
"PostalCode": "07015"
}
},
"FactualAttributes": [
{
"Key": "wifi",
"Type": "factual",
"Name": {
"en-US": "Free WiFi",
"de-DE": "Kostenloses WLAN"
},
"Value": "true",
"ValueType": "boolean",
"ParentKey": "facilities_and_services",
"IsFree": true,
"GTCodes": [
"GT03-INTE",
"AT03-FRCH"
]
},
{
"Key": "parking",
"Type": "factual",
"Name": {
"en-US": "Parking",
"de-DE": "Parkplatz"
},
"Value": "true",
"ValueType": "boolean",
"ParentKey": "facilities_and_services",
"IsFree": false,
"GTCodes": [
"GT03-CAPA",
"AT03-EXCO"
]
},
{
"Key": "restaurant",
"Type": "factual",
"Name": {
"en-US": "Restaurants",
"de-DE": "Restaurants"
},
"ValueType": "group",
"ParentKey": "food_and_drink",
"IsFree": null,
"GTCodes": [
"GT03-REST"
],
"Instances": [
{
"Name": "La Marea",
"Details": {
"description": "Mediterranean a la carte restaurant with sea views.",
"hours": "19:00-23:00"
}
},
{
"Name": "Buffet Central",
"Details": {
"description": "Main buffet restaurant serving breakfast, lunch and dinner."
}
}
]
}
],
"POIs": [
{
"ID": "0192fb20-1aa2-7def-9abc-1122334455aa",
"Name": {
"en-US": "Palma Cathedral",
"de-DE": "Kathedrale von Palma"
},
"Type": "landmark",
"Distance": 3.2,
"Unit": "km"
},
{
"ID": "0192fb20-1aa2-7def-9abc-2233445566bb",
"Name": {
"en-US": "Can Pere Antoni Beach",
"de-DE": "Strand Can Pere Antoni"
},
"Type": "beach",
"Distance": 250,
"Unit": "m"
}
],
"CheckIn": {
"From": "15:00"
},
"CheckOut": {
"Until": "11:00"
},
"GeneratedTexts": {
"en-US": {
"Summary": {
"Text": "Set on a quiet stretch of the Bay of Palma, Bahia Azul Beach Resort pairs direct beach access with bright, contemporary rooms and a sea-view rooftop pool.",
"Compliance": {
"AIGenerated": true
}
},
"HouseRules": {
"Text": "Check-in is from 15:00 and check-out is until 11:00. Pets are not permitted. Quiet hours apply between 23:00 and 08:00.",
"GeneratedAt": "2026-04-12T09:15:00Z",
"TextType": "rules",
"Compliance": {
"AIGenerated": true
}
}
},
"de-DE": {
"Summary": {
"Text": "Das Bahia Azul Strandresort liegt an einem ruhigen Abschnitt der Bucht von Palma und verbindet direkten Strandzugang mit hellen, modernen Zimmern und einem Dachpool mit Meerblick.",
"Compliance": {
"AIGenerated": true
}
},
"HouseRules": {
"Text": "Der Check-in ist ab 15:00 Uhr und der Check-out bis 11:00 Uhr moeglich. Haustiere sind nicht gestattet. Ruhezeiten gelten zwischen 23:00 und 08:00 Uhr.",
"GeneratedAt": "2026-04-12T09:15:00Z",
"TextType": "rules",
"Compliance": {
"AIGenerated": true
}
}
}
},
"RenderLayouts": {
"Summary": "prose",
"HouseRules": "highlights"
},
"Images": [
{
"ID": "0192fb20-1aa2-7def-9abc-1122334455aa",
"URL": "https://cdn.ygo.ai/hotels/bahia-azul/exterior-pool.jpg",
"Source": "photo",
"Category": "exterior",
"Features": [
"pool",
"sea_view"
],
"Mood": [
"relaxing"
],
"Tags": [
"rooftop",
"sunset"
],
"AppealScore": 88,
"QualityScore": 91,
"Width": 1600,
"Height": 1067,
"Format": "jpeg",
"FileSize": 412000,
"DominantColor": "#2E6F95",
"BlurHash": "LKO2?U%2Tw=w]~RBVZRi};RPxuwH",
"FileMetadata": {
"CaptureDate": "2012-06-14",
"Copyright": "© 2012 Hotel Sol S.A."
},
"Descriptions": {
"en-US": "Rooftop infinity pool overlooking the Bay of Palma at sunset."
},
"Compliance": {
"AIGenerated": true
},
"Presence": [
{
"Label": "person",
"Confidence": 0.91
},
{
"Label": "adult",
"Confidence": 0.86
}
],
"Safety": {
"Inappropriate": 0.02,
"OffTopic": null
},
"TextDetections": [
{
"Content": "POOL BAR",
"Label": "signage",
"Confidence": 0.74
}
],
"FeatureDetections": [
{
"Label": "pool",
"Confidence": 0.96
},
{
"Label": "sea_view",
"Confidence": 0.9
}
]
}
],
"Rooms": [
{
"ID": "0192fb30-2bb3-7abc-8def-99887766aabb",
"Name": {
"en-US": "Double Room Sea View",
"de-DE": "Doppelzimmer mit Meerblick"
},
"SizeSqm": 26,
"Beddings": [
[
{
"Type": "double",
"Quantity": 1
}
]
],
"FactualAttributes": [
{
"Key": "air_conditioning",
"Type": "factual",
"Name": {
"en-US": "Air Conditioning",
"de-DE": "Klimaanlage"
},
"Value": "true",
"ValueType": "boolean",
"ParentKey": "room_facilities",
"IsFree": true,
"GTCodes": [
"GT05-AICO",
"AT05-FRCH"
]
}
],
"GeneratedTexts": {
"en-US": {
"RoomDescription": {
"Text": "A bright 26 sqm room with a private balcony framing the bay, a king-size bed and a walk-in rain shower.",
"Compliance": {
"AIGenerated": true
}
}
}
},
"RenderLayouts": {
"": "roomcards"
},
"ExternalRoomIDs": {
"ProductRoomIDs": [
"11824",
"11902"
]
},
"Images": [
{
"ID": "0192fb31-3cc4-7abc-8def-aabbccddeeff",
"URL": "https://cdn.ygo.ai/hotels/bahia-azul/room-seaview.jpg",
"Category": "room",
"Features": [
"balcony",
"sea_view"
],
"Mood": [
"bright"
],
"Tags": [
"king_bed"
],
"AppealScore": 80,
"QualityScore": 84,
"Width": 1500,
"Height": 1000,
"Format": "jpeg",
"FileSize": 356000,
"DominantColor": "#D9E2EC",
"BlurHash": "LEHV6nWB2yk8pyo0adR*.7kCMdnj",
"Descriptions": {
"en-US": "Sea-view double room with a private balcony."
},
"Compliance": {
"AIGenerated": true
}
}
],
"Status": "active",
"CreatedAt": "2026-03-01T08:00:00Z",
"UpdatedAt": "2026-04-10T12:30:00Z"
}
],
"Tags": [
{
"ID": "0192fc01-1111-7abc-8def-aaaaaaaaaaaa",
"Name": "Summer Campaign"
}
],
"Status": "active",
"CreatedAt": "2026-03-01T08:00:00Z",
"UpdatedAt": "2026-04-12T09:15:00Z"
}
}Modified at 2026-09-14 07:24:05