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

List enriched hotels

POST
/v2/project/content/listEnrichedHotels
Return a paginated array of full enriched hotels for the calling project, with optional filters by country, status, full-enrichment flag, text-enrichment state, code kind, a free-text search, and the project's internal tags.
Each item is the same full enriched-hotel shape returned by get-enriched-hotel (rooms, images, points of interest, factual attributes, generated texts, and applied project tags). Because every row is a full build the page is hard-capped at 50 hotels; for a lean roster use list-enriched-hotel-summaries.
Results are limited to hotels that belong to the calling project. Tag filters (TagIDs and/or TagName) narrow the list to hotels carrying all named tags.

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/json

Examples

Responses

🟢200
application/json
Enriched hotels retrieved successfully.
Headers

Bodyapplication/json

🟠400listEnrichedHotels_BadRequest
🟠401listEnrichedHotels_Unauthorized
🟠403listEnrichedHotels_Forbidden
🟠404listEnrichedHotels_NotFound
🟠429listEnrichedHotels_TooManyRequests
🔴500listEnrichedHotels_InternalServerError
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://api.ygo.ai/v2/project/content/listEnrichedHotels' \
--header 'X-Project-ID: ' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "Limit": 50,
    "Offset": 0
}'
Response Response Example
200 - A page of 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",
                    "IsFree": true
                }
            ],
            "POIs": [
                {
                    "Name": {
                        "en-US": "Palma Cathedral",
                        "de-DE": "Kathedrale von Palma"
                    },
                    "Type": "landmark",
                    "Distance": 3.2,
                    "Unit": "km"
                }
            ],
            "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."
                    }
                }
            },
            "RenderLayouts": {
                "Summary": "prose"
            },
            "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
                        }
                    ],
                    "RenderLayouts": {
                        "": "roomcards"
                    },
                    "Images": [],
                    "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
    }
}
Modified at 2026-07-01 06:49:44
Previous
Get enriched hotel
Next
List enriched hotel summaries
Built with