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
          • List enriched hotels
          • List enriched hotel summaries
        • 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

    listEnrichedHotels_ListEnrichedHotelsResponse

    Paginated list response wrapping the full enriched hotels.

    {
        "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",
                        "Details": {
                            "property1": "string",
                            "property2": "string"
                        },
                        "IsFree": true,
                        "ValueLocalized": {
                            "property1": "string",
                            "property2": "string"
                        },
                        "Instances": [
                            {
                                "Name": "La Marea",
                                "Details": {
                                    "property1": "string",
                                    "property2": "string"
                                },
                                "DetailsLocalized": {
                                    "property1": {
                                        "property1": "string",
                                        "property2": "string"
                                    },
                                    "property2": {
                                        "property1": "string",
                                        "property2": "string"
                                    }
                                }
                            }
                        ]
                    }
                ],
                "POIs": [
                    {
                        "Name": {
                            "en-US": "Palma Cathedral",
                            "de-DE": "Kathedrale von Palma"
                        },
                        "Type": "landmark",
                        "Distance": 3.2,
                        "Unit": "m",
                        "Details": {
                            "property1": "string",
                            "property2": "string"
                        }
                    }
                ],
                "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.",
                            "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"
                        ],
                        "Flags": [
                            "string"
                        ],
                        "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": "wifi",
                                "Type": "factual",
                                "Name": {
                                    "en-US": "Free WiFi",
                                    "de-DE": "Kostenloses WLAN"
                                },
                                "Value": "true",
                                "ValueType": "boolean",
                                "ParentKey": "facilities_and_services",
                                "Details": {
                                    "property1": "string",
                                    "property2": "string"
                                },
                                "IsFree": true,
                                "ValueLocalized": {
                                    "property1": "string",
                                    "property2": "string"
                                },
                                "Instances": [
                                    {
                                        "Name": "La Marea",
                                        "Details": {
                                            "property1": "string",
                                            "property2": "string"
                                        },
                                        "DetailsLocalized": {
                                            "property1": {
                                                "property1": "string",
                                                "property2": "string"
                                            },
                                            "property2": {
                                                "property1": "string",
                                                "property2": "string"
                                            }
                                        }
                                    }
                                ]
                            }
                        ],
                        "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.",
                                    "GeneratedAt": "2026-04-12T09:15:00Z",
                                    "TextType": "rules"
                                }
                            }
                        },
                        "RenderLayouts": {
                            "": "roomcards"
                        },
                        "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"
                                ],
                                "Flags": [
                                    "string"
                                ],
                                "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."
                                }
                            }
                        ],
                        "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"
            }
        ],
        "Pagination": {
            "Total": 128,
            "Limit": 50,
            "Offset": 0
        }
    }
    Built with