1. Enrichment
YGO Client API
v2
  • v2
  • v1
  • Project API
    • Overview
    • Core Concepts
    • Authentication
    • Error Handling & Limits
    • Content Enrichment API
      • Text Generation
        • Generate text
        • Get text generation status
        • Preview text
      • Enrichment
        • Get enriched hotel
          POST
        • List enriched hotels
          POST
        • List enriched hotel summaries
          POST
      • Templates
        • Save text template
        • List text templates
      • Tags
        • Save tag
        • List tags
        • Delete tag
        • Add tag to hotels (bulk)
        • Remove tag from hotels (bulk)
      • Settings
        • Get content settings
        • List the selectable image-provider catalog
    • Schemas
      • GetEnrichedHotelRequest
      • GenerateTextRequest
      • GetTextGenerationStatusRequest
      • PreviewTextRequest
      • GetEnrichedHotelsByTagRequest
      • ListEnrichedHotelsRequest
      • GetContentSettingsRequest
      • ListTextTemplatesRequest
      • SaveTextTemplateRequest
      • generateText_GenerateTextRequest
      • GetEnrichedHotelResponse
      • GenerateTextResponse
      • GetTextGenerationStatusResponse
      • PreviewTextResponse
      • GetEnrichedHotelsByTagResponse
      • ListEnrichedHotelsResponse
      • GetContentSettingsResponse
      • ListTextTemplatesResponse
      • SaveTextTemplateResponse
      • generateText_GenerateTextResponse
      • TextGenerationRun
      • TextGenerationStatus
      • PreviewResult
      • EnrichedHotelsByTag
      • Pagination
      • ContentSettings
      • TextTemplate
      • generateText_TextGenerationRun
      • ErrorResponse
      • RunProgress
      • PreviewHotel
      • TagSummary
      • EnrichedHotelListItem
      • generateText_RunProgress
      • EnrichedHotel
      • ErrorDetail
      • PreviewCell
      • TemplateUsageStats
      • generateText_ErrorResponse
      • Location
      • FieldError
      • PreviewChange
      • generateText_ErrorDetail
      • Address
      • generateText_FieldError
      • FactualAttribute
      • getTextGenerationStatus_GetTextGenerationStatusRequest
      • FactualInstance
      • getTextGenerationStatus_GetTextGenerationStatusResponse
      • POI
      • getTextGenerationStatus_TextGenerationStatus
      • CheckIn
      • getTextGenerationStatus_RunProgress
      • CheckOut
      • getTextGenerationStatus_ErrorResponse
      • GeneratedTexts
      • getTextGenerationStatus_ErrorDetail
      • GeneratedTextDetail
      • getTextGenerationStatus_FieldError
      • Image
      • previewText_PreviewTextRequest
      • EnrichedRoom
      • previewText_PreviewTextResponse
      • Bedding
      • previewText_PreviewResult
      • previewText_PreviewHotel
      • previewText_PreviewText
      • previewText_PreviewChange
      • previewText_ErrorResponse
      • previewText_ErrorDetail
      • previewText_FieldError
      • getEnrichedHotel_GetEnrichedHotelRequest
      • getEnrichedHotel_GetEnrichedHotelResponse
      • getEnrichedHotel_EnrichedHotel
      • getEnrichedHotel_ProjectTagSummary
      • getEnrichedHotel_Location
      • getEnrichedHotel_Address
      • getEnrichedHotel_FactualAttribute
      • getEnrichedHotel_FactualInstance
      • getEnrichedHotel_POI
      • getEnrichedHotel_CheckIn
      • getEnrichedHotel_CheckOut
      • getEnrichedHotel_GeneratedTexts
      • getEnrichedHotel_GeneratedTextDetail
      • getEnrichedHotel_Image
      • getEnrichedHotel_EnrichedRoom
      • getEnrichedHotel_Bedding
      • getEnrichedHotel_ErrorResponse
      • getEnrichedHotel_ErrorDetail
      • getEnrichedHotel_FieldError
      • listEnrichedHotelSummaries_ListEnrichedHotelSummariesRequest
      • listEnrichedHotelSummaries_ListEnrichedHotelSummariesResponse
      • listEnrichedHotels_EnrichedHotelListItem
      • listEnrichedHotelSummaries_Pagination
      • listEnrichedHotelSummaries_EnrichedHotelSummary
      • listEnrichedHotelSummaries_ErrorResponse
      • listEnrichedHotelSummaries_ErrorDetail
      • listEnrichedHotelSummaries_FieldError
      • listEnrichedHotels_ListEnrichedHotelsRequest
      • listEnrichedHotels_ListEnrichedHotelsResponse
      • listEnrichedHotels_Pagination
      • listEnrichedHotels_EnrichedHotel
      • listEnrichedHotels_ProjectTagSummary
      • listEnrichedHotels_Location
      • listEnrichedHotels_Address
      • listEnrichedHotels_FactualAttribute
      • listEnrichedHotels_FactualInstance
      • listEnrichedHotels_POI
      • listEnrichedHotels_CheckIn
      • listEnrichedHotels_CheckOut
      • listEnrichedHotels_GeneratedTexts
      • listEnrichedHotels_GeneratedTextDetail
      • listEnrichedHotels_Image
      • listEnrichedHotels_EnrichedRoom
      • listEnrichedHotels_Bedding
      • listEnrichedHotels_ErrorResponse
      • listEnrichedHotels_ErrorDetail
      • listEnrichedHotels_FieldError
      • getContentSettings_GetContentSettingsRequest
      • getContentSettings_GetContentSettingsResponse
      • getContentSettings_ContentSettings
      • getContentSettings_ErrorResponse
      • getContentSettings_ErrorDetail
      • getContentSettings_FieldError
      • listImageProvidersProject_ListImageProvidersRequest
      • listImageProvidersProject_ListImageProvidersResponse
      • listImageProvidersProject_ImageProviderCatalog
      • listImageProvidersProject_ImageProviderCatalogEntry
      • listImageProvidersProject_ErrorResponse
      • listImageProvidersProject_ErrorDetail
      • listImageProvidersProject_FieldError
      • addTagToHotels_AddTagToHotelsRequest
      • addTagToHotels_AddTagToHotelsResponse
      • addTagToHotels_BulkTagResult
      • addTagToHotels_BulkTagHotelResult
      • addTagToHotels_ErrorResponse
      • addTagToHotels_ErrorDetail
      • addTagToHotels_FieldError
      • deleteTag_DeleteTagRequest
      • deleteTag_DeleteTagResponse
      • deleteTag_DeletedProjectTag
      • deleteTag_ErrorResponse
      • deleteTag_ErrorDetail
      • deleteTag_FieldError
      • listTags_ListTagsRequest
      • listTags_ListTagsResponse
      • listTags_ProjectTag
      • listTags_ErrorResponse
      • listTags_ErrorDetail
      • listTags_FieldError
      • removeTagFromHotels_RemoveTagFromHotelsRequest
      • removeTagFromHotels_RemoveTagFromHotelsResponse
      • removeTagFromHotels_BulkTagResult
      • removeTagFromHotels_BulkTagHotelResult
      • removeTagFromHotels_ErrorResponse
      • removeTagFromHotels_ErrorDetail
      • removeTagFromHotels_FieldError
      • saveTag_SaveTagRequest
      • saveTag_SaveTagResponse
      • saveTag_ProjectTag
      • saveTag_ErrorResponse
      • saveTag_ErrorDetail
      • saveTag_FieldError
      • listTextTemplates_ListTextTemplatesRequest
      • listTextTemplates_ListTextTemplatesResponse
      • listTextTemplates_Pagination
      • listTextTemplates_TextTemplate
      • listTextTemplates_TemplateUsageStats
      • listTextTemplates_ErrorResponse
      • listTextTemplates_ErrorDetail
      • listTextTemplates_FieldError
      • saveTextTemplate_SaveTextTemplateRequest
      • saveTextTemplate_SaveTextTemplateResponse
      • saveTextTemplate_TextTemplate
      • saveTextTemplate_ErrorResponse
      • saveTextTemplate_ErrorDetail
      • saveTextTemplate_FieldError
  1. Enrichment

Get enriched hotel

POST
/v2/project/content/getEnrichedHotel
Retrieve a single enriched hotel by its UUID, including its rooms, images, points of interest, factual attributes, structured check-in / check-out times, and per-locale generated texts.
The hotel must belong to the calling project; a hotel outside the project's scope returns 404.

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200
application/json
Enriched hotel retrieved successfully.
Headers

Bodyapplication/json

🟠400getEnrichedHotel_BadRequest
🟠401getEnrichedHotel_Unauthorized
🟠403getEnrichedHotel_Forbidden
🟠404getEnrichedHotel_NotFound
🟠429getEnrichedHotel_TooManyRequests
🔴500getEnrichedHotel_InternalServerError
Request Request Example
Shell
JavaScript
Java
Swift
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"
        },
        "GlobalHotelID": "ES-MALLR-K7MP2",
        "Stars": 4,
        "AccommodationType": "hotel",
        "Location": {
            "Latitude": 39.5696,
            "Longitude": 2.6502,
            "CountryCode": "ES",
            "Address": {
                "Street": "Carrer de la Mar 12",
                "City": "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
            },
            {
                "Key": "parking",
                "Type": "factual",
                "Name": {
                    "en-US": "Parking",
                    "de-DE": "Parkplatz"
                },
                "Value": "true",
                "ValueType": "boolean",
                "ParentKey": "facilities_and_services",
                "IsFree": false
            },
            {
                "Key": "restaurant",
                "Type": "factual",
                "Name": {
                    "en-US": "Restaurants",
                    "de-DE": "Restaurants"
                },
                "ValueType": "group",
                "ParentKey": "food_and_drink",
                "IsFree": null,
                "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": [
            {
                "Name": {
                    "en-US": "Palma Cathedral",
                    "de-DE": "Kathedrale von Palma"
                },
                "Type": "landmark",
                "Distance": 3.2,
                "Unit": "km"
            },
            {
                "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."
                },
                "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"
                }
            },
            "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."
                },
                "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"
                }
            }
        },
        "RenderLayouts": {
            "Summary": "prose",
            "HouseRules": "highlights"
        },
        "Images": [
            {
                "ID": "0192fb20-1aa2-7def-9abc-1122334455aa",
                "URL": "https://cdn.ygo.ai/hotels/bahia-azul/exterior-pool.jpg",
                "PHash": "c1f0e3a4b5d6c7e8",
                "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",
                "Descriptions": {
                    "en-US": "Rooftop infinity pool overlooking the Bay of Palma at sunset."
                }
            }
        ],
        "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
                    }
                ],
                "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."
                        }
                    }
                },
                "RenderLayouts": {
                    "": "roomcards"
                },
                "Images": [
                    {
                        "ID": "0192fb31-3cc4-7abc-8def-aabbccddeeff",
                        "URL": "https://cdn.ygo.ai/hotels/bahia-azul/room-seaview.jpg",
                        "PHash": "a9b8c7d6e5f40312",
                        "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."
                        }
                    }
                ],
                "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-07-01 06:49:44
Previous
Preview text
Next
List enriched hotels
Built with