酒店查询列表

POST

/open/v1/hotel/search

根据目的地、入住/离店日期等条件查询酒店列表，支持星级、价格、设施筛选与多种排序。

AI Agent 友好：可通过 scene 字段传入场景标签（couple/family/senior/business/inbound），返回结果会带 scene_tags 提示。

成功时每个酒店都会返回 search_offer_id；下单前需先调用 /open/v1/hotel/rooms 获取产品级 offer_id。

风控约束（参考开放平台文档第 11 节）：

不可指定过去日期；

check_out 必须晚于 check_in；

单次最多返回 50 条，需分页获取全量。

请求参数

Authorization

Header 参数

Body 参数application/json必填

示例

{
    "adcode": "330106",
    "adult_count": 2,
    "check_in": "2026-06-11",
    "check_out": "2026-06-13",
    "destination": "杭州西湖",
    "filters": {
        "bed_preference": [
            "big_bed",
            "twin"
        ],
        "breakfast_included": true,
        "has_child_facility": true,
        "has_gymnasium": true,
        "has_parking": true,
        "has_restaurant": true,
        "has_swimming_pool": true,
        "has_wifi": true,
        "hotel_brand": "希尔顿",
        "max_distance_km": 5,
        "max_price": 1000,
        "min_price": 200,
        "min_review_score": 4,
        "refundable": true,
        "star_levels": [
            4,
            5
        ]
    },
    "latitude": 30.2594,
    "longitude": 120.1486,
    "page": 1,
    "page_size": 10,
    "room_count": 1,
    "scene": "couple",
    "sort_by": "best"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://open.longxiachuxing.com/api/open/v1/hotel/search' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data '{
    "adcode": "330106",
    "adult_count": 2,
    "check_in": "2026-06-11",
    "check_out": "2026-06-13",
    "destination": "杭州西湖",
    "filters": {
        "bed_preference": [
            "big_bed",
            "twin"
        ],
        "breakfast_included": true,
        "has_child_facility": true,
        "has_gymnasium": true,
        "has_parking": true,
        "has_restaurant": true,
        "has_swimming_pool": true,
        "has_wifi": true,
        "hotel_brand": "希尔顿",
        "max_distance_km": 5,
        "max_price": 1000,
        "min_price": 200,
        "min_review_score": 4,
        "refundable": true,
        "star_levels": [
            4,
            5
        ]
    },
    "latitude": 30.2594,
    "longitude": 120.1486,
    "page": 1,
    "page_size": 10,
    "room_count": 1,
    "scene": "couple",
    "sort_by": "best"
}'

返回响应

🟢200

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "data": {
        "hotels": [
            {
                "address": "浙江省杭州市西湖区北山街道",
                "brand_name": "希尔顿",
                "business_zone": "西湖景区",
                "city": "杭州",
                "currency": "CNY",
                "distance_km": 1.2,
                "district": "西湖区",
                "has_breakfast": true,
                "has_parking": true,
                "has_swimming_pool": true,
                "has_wifi": true,
                "hotel_id": "H10001",
                "hotel_name": "杭州西湖希尔顿酒店",
                "hotel_name_en": "Hilton Hangzhou West Lake",
                "latitude": 30.2594,
                "longitude": 120.1486,
                "main_picture": "https://cdn.example.com/hotel/H10001.jpg",
                "min_price": 800,
                "review_count": 1250,
                "review_score": 4.8,
                "scene_tags": [
                    "couple",
                    "family"
                ],
                "search_offer_id": "eyJhbGciOiJBMjU2R0NNIi...",
                "star_rating": 5,
                "star_tag": "豪华型"
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 10,
            "total": 128
        },
        "search_id": "a1b2c3d4-e5f6-7890",
        "total": 128
    },
    "message": "success",
    "request_id": "req_a1b2c3"
}

🟠400

🟠401

🟠429

修改于 2026-06-10 04:01:22

酒店接口说明

酒店房型详情