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 ********************

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 name

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"
            },
            "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

Get enriched hotel

List enriched hotel summaries