List enriched hotels

POST

/v2/project/content/listEnrichedHotels

Return a paginated array of full enriched hotels for the calling project.

Each row is the same full hotel getEnrichedHotel returns, built and returned synchronously. Because every row is a full build the page is hard-capped at 50 hotels.

Limit above 50 is clamped to 50; for a lean roster use listEnrichedHotelSummaries.

Filters: country, status, full-enrichment flag, text-enrichment state, code kind and free-text search.

TagIDs and TagName narrow to hotels carrying all named tags; an unknown tag returns 404.

ExternalHotelIDs holds up to 50 selectors, OR-ed with each other and AND-ed with every other filter.

Only hotels belonging to your project are returned.

429 means the rate limit was hit; wait Retry-After seconds.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

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 Example

Shell

JavaScript

Java

Swift

cURL

First page with default page sizeFilter by country, active status, and a search termRestrict to hotels carrying all of these project tagsRestrict to hotels carrying a single tag by nameRestrict to hotels matching either of two external-identity selectors

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 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"
            },
            "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"
                    ]
                }
            ],
            "POIs": [
                {
                    "ID": "0192fb20-1aa2-7def-9abc-1122334455aa",
                    "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.",
                        "Compliance": {
                            "AIGenerated": true
                        }
                    }
                }
            },
            "RenderLayouts": {
                "Summary": "prose"
            },
            "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"
                            ]
                        }
                    ],
                    "RenderLayouts": {
                        "": "roomcards"
                    },
                    "ExternalRoomIDs": {
                        "ProductRoomIDs": [
                            "11824",
                            "11902"
                        ]
                    },
                    "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-09-14 07:24:05

Get enriched hotel

List enriched hotel summaries