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

    GetEnrichedHotelsByTagResponse

    Single-object response envelope wrapping the tag and its enriched hotels.

    {
        "Data": {
            "Tag": {
                "ID": "0192fc01-1234-7abc-8def-aabbccddeeff",
                "Name": "summer-collection",
                "TagType": "collection"
            },
            "Hotels": [
                {
                    "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"
                        }
                    ],
                    "Status": "active",
                    "CreatedAt": "2026-03-01T08:00:00Z",
                    "UpdatedAt": "2026-04-12T09:15:00Z"
                }
            ],
            "FailedCount": 0
        }
    }
    Built with