Join our community at https://www.reddit.com/r/HotelByte/

HotelsMetadata

HotelByte OpenAPI - Test

https://api-test.hotelbyte.com

POST

/api/search/hotelsMetadata

ContentOpenapiSearch

Retrieve hotel metadata by destination with pagination support.

This endpoint provides hotel metadata information for a specific destination, enabling efficient hotel discovery and listing operations. It's designed for content management and hotel catalog browsing scenarios.

Primary Use Cases:

Hotel catalog browsing by destination

Content management system hotel listings

Hotel metadata enrichment for search interfaces

Required Parameters:

destinationId: The unique identifier for the destination (required)

Integration Notes:

Designed for content management and catalog operations

Ideal for building hotel selection interfaces

Enables efficient hotel metadata synchronization

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200成功

application/json

Body

🟠400请求有误

🟠401未认证

🟠403权限不足

🟠429请求过多

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api-test.hotelbyte.com/api/search/hotelsMetadata' \
--header 'Client-Request-Timestamp;' \
--header 'IP;' \
--header 'Language;' \
--header 'Request-Id;' \
--header 'Trace-Id;' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "destinationId": "804028047",
    "countryCode": "AE",
    "page": {
        "pageNum": 1,
        "pageSize": 10,
        "cursor": 0
    }
}'

Response Example

{
    "code": 0,
    "msg": "string",
    "data": {
        "hotelsMetadata": [
            {
                "hotelId": "string",
                "destinationId": "804028047",
                "name": {
                    "en": "Jumeirah Beach Hotel"
                },
                "rating": 4.5,
                "address": {
                    "en": "Millenium Al Barsha"
                },
                "latlngCoordinator": {
                    "google": {
                        "lat": 25.0478,
                        "lng": 121.5319
                    },
                    "gaode": {
                        "lat": 25.0478,
                        "lng": 121.5319
                    }
                },
                "logoURL": "https://static.hotelbyte.com/Images/Hotel/804028047_1.jpg"
            }
        ],
        "page": {
            "total": 100,
            "hasMore": true
        }
    }
}

HotelStaticDetail

HotelList