淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	描述
city_code	Number	必须	100100	城市code
shid	Number	可选	1000000	标准酒店id，如果需要查询单条酒店的信息，需要传入此参数
current_page	Number	可选	1	分页参数：当前页数，从1开始计数。默认值：1
page_size	Number	可选	10	分页参数：每页酒店数量。最小值1，最大值为50。默认值：20
pid	String	可选	mm_2000059001_20312022_20470013	pid

名称	类型	示例值	描述
total_results	Number	1500	酒店总数
hotels	SHotelInfoObject []		标准酒店信息
└ shid Number 1000256 标准酒店ID └ name String 北京大饭店酒店名称 └ type String 1,2 酒店类型 └ province Number 100000 省的code └ city Number 100100 市的code └ district Number 100000 地区的值 └ address String 崇文门西大街1号酒店地址 └ lat String 18.264846 纬度 └ lng String 109.50098 纬度 └ star String 1 酒店星级，1-5星，0是客栈 └ opening_time String 2000 酒店开业时间 └ decorate_time String 2000-01-01 酒店装修时间 └ tel String 0086-010-85322688 电话，包括三种类型： 1.固定电话，例如：0086-010-85322688 2.移动电话，例如：13869696363 3.400或800电话，例如：0086-4006123928 └ rate_number Number 18 评论数 └ rate_score String 4.5 评分 └ description String 酒店描述酒店描述 └ pic_urls String http://img08.taobaocdn.com/bao/uploaded/i8/T1v5JOFptbXXaAGmMT_013104.jpg,http://img04.taobaocdn.com/bao/uploaded/i4/T1TPVNFwFcXXaAGmMT_013104.jpg 图片url，多张图片使用","隔开 └ hotel_facilities String 酒店设施酒店设施 └ services String 服务设施服务设施 └ brand String 品牌酒店品牌 └ status Number 0 酒店状态,0,营业中；-1，筹建中；-2，暂停营业；-3，已停业； └ h5_detail_url String http://h5.m.taobao.com/trip/hotel/detail/detail.html?hid=0&shid=10107739&checkin=2014-05-12&checkout=2014-05-13&curcitycode=110100 H5的detail页面的URL └ pc_detail_url String http://kezhan.trip.taobao.com/hotel_detail2.htm?shid=10004405&searchBy=yisou&requestId=1232322313 酒店detail页面的url rooms SRoomType [] 房型信息 └ srid Number 123456 匹配的标准房型 └ shid Number 123456 shid └ name String aaa 房型名 └ floor String 7-8层楼层 └ bed String [{"bedType":"大床","bedSize":"1.5m"},{"bedType":"双床","bedSize":"1.2m"}] 床型。json格式：[{"bedType":"大床","bedSize":"1.5m"},{"bedType":"双床","bedSize":"1.2m"}] └ internet String aaa 宽带服务 "0","有线上网(免费), "1","有线上网(无)", "2","有线上网(收费)", "3","有线上网(部分有且免费)", "4","有线上网(部分有且收费)" └ pic_url String aaa pic_url └ facility String aaa facility └ area String 16－30平米面积 └ max_occupancy Number 1 最大入住人数 └ window_type String 有窗窗型 └ status Number 0 状态 └ bnb_hotel Boolean false 是否为民宿类型 └ check_in_time String 入住时间 └ check_out_time String 离店时间 └ pet_info String 宠物信息 └ foreign_type Number 外宾类型 └ foreign_desc String 外宾描述

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
XhotelInfoListGetRequest req = new XhotelInfoListGetRequest();
req.setCityCode(100100L);
req.setShid(1000000L);
req.setCurrentPage(1L);
req.setPageSize(10L);
req.setPid("mm_2000059001_20312022_20470013");
XhotelInfoListGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
XhotelInfoListGetRequest req = new XhotelInfoListGetRequest();
req.CityCode = 100100L;
req.Shid = 1000000L;
req.CurrentPage = 1L;
req.PageSize = 10L;
req.Pid = "mm_2000059001_20312022_20470013";
XhotelInfoListGetResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new XhotelInfoListGetRequest;
$req->setCityCode("100100");
$req->setShid("1000000");
$req->setCurrentPage("1");
$req->setPageSize("10");
$req->setPid("mm_2000059001_20312022_20470013");
$resp = $c->execute($req);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=taobao.xhotel.info.list.get' \
-d 'partner_id=apidoc' \
-d 'sign=67C66F004D076E4D592A69CF086994D2' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-14+17%3A16%3A39' \
-d 'v=2.0' \
-d 'city_code=100100' \
-d 'current_page=1' \
-d 'page_size=10' \
-d 'pid=mm_2000059001_20312022_20470013' \
-d 'shid=1000000'

# -*- coding: utf-8 -*-
import top.api

req=top.api.XhotelInfoListGetRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.city_code=100100
req.shid=1000000
req.current_page=1
req.page_size=10
req.pid="mm_2000059001_20312022_20470013"
try:
	resp= req.getResponse()
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"taobao.xhotel.info.list.get");
add_param(pRequest,"city_code","100100");
add_param(pRequest,"shid","1000000");
add_param(pRequest,"current_page","1");
add_param(pRequest,"page_size","10");
add_param(pRequest,"pid","mm_2000059001_20312022_20470013");
pResponse = top_execute(pClient,pRequest,NULL);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('taobao.xhotel.info.list.get', {
	'city_code':'100100',
	'shid':'1000000',
	'current_page':'1',
	'page_size':'10',
	'pid':'mm_2000059001_20312022_20470013'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<xhotel_info_list_get_response>
    <total_results>1500</total_results>
    <hotels>
        <s_hotel_info_object>
            <shid>1000256</shid>
            <name>北京大饭店</name>
            <type>1,2</type>
            <province>100000</province>
            <city>100100</city>
            <district>100000</district>
            <address>崇文门西大街1号</address>
            <lat>18.264846</lat>
            <lng>109.50098</lng>
            <star>1</star>
            <opening_time>2000</opening_time>
            <decorate_time>2000-01-01</decorate_time>
            <tel>0086-010-85322688</tel>
            <rate_number>18</rate_number>
            <rate_score>4.5</rate_score>
            <description>酒店描述</description>
            <pic_urls>http://img08.taobaocdn.com/bao/uploaded/i8/T1v5JOFptbXXaAGmMT_013104.jpg,http://img04.taobaocdn.com/bao/uploaded/i4/T1TPVNFwFcXXaAGmMT_013104.jpg</pic_urls>
            <hotel_facilities>酒店设施</hotel_facilities>
            <services>服务设施</services>
            <brand>品牌</brand>
            <status>0</status>
            <h5_detail_url>http://h5.m.taobao.com/trip/hotel/detail/detail.html?hid=0&amp;shid=10107739&amp;checkin=2014-05-12&amp;checkout=2014-05-13&amp;curcitycode=110100</h5_detail_url>
            <pc_detail_url>http://kezhan.trip.taobao.com/hotel_detail2.htm?shid=10004405&amp;searchBy=yisou&amp;requestId=1232322313</pc_detail_url>
            <rooms>
                <s_room_type>
                    <srid>123456</srid>
                    <shid>123456</shid>
                    <name>aaa</name>
                    <floor>7-8层</floor>
                    <bed>[{&quot;bedType&quot;:&quot;大床&quot;,&quot;bedSize&quot;:&quot;1.5m&quot;},{&quot;bedType&quot;:&quot;双床&quot;,&quot;bedSize&quot;:&quot;1.2m&quot;}]</bed>
                    <internet>aaa</internet>
                    <pic_url>aaa</pic_url>
                    <facility>aaa</facility>
                    <area>16－30平米</area>
                    <max_occupancy>1</max_occupancy>
                    <window_type>有窗</window_type>
                    <status>0</status>
                </s_room_type>
            </rooms>
            <bnb_hotel>false</bnb_hotel>
            <check_in_time></check_in_time>
            <check_out_time></check_out_time>
            <pet_info></pet_info>
            <foreign_type></foreign_type>
            <foreign_desc></foreign_desc>
        </s_hotel_info_object>
    </hotels>
</xhotel_info_list_get_response>

{
    "xhotel_info_list_get_response":{
        "total_results":1500,
        "hotels":{
            "s_hotel_info_object":[
                {
                    "shid":1000256,
                    "name":"北京大饭店",
                    "type":"1,2",
                    "province":100000,
                    "city":100100,
                    "district":100000,
                    "address":"崇文门西大街1号",
                    "lat":"18.264846",
                    "lng":"109.50098",
                    "star":"1",
                    "opening_time":"2000",
                    "decorate_time":"2000-01-01",
                    "tel":"0086-010-85322688",
                    "rate_number":18,
                    "rate_score":"4.5",
                    "description":"酒店描述",
                    "pic_urls":"http:\/\/img08.taobaocdn.com\/bao\/uploaded\/i8\/T1v5JOFptbXXaAGmMT_013104.jpg,http:\/\/img04.taobaocdn.com\/bao\/uploaded\/i4\/T1TPVNFwFcXXaAGmMT_013104.jpg",
                    "hotel_facilities":"酒店设施",
                    "services":"服务设施",
                    "brand":"品牌",
                    "status":0,
                    "h5_detail_url":"http:\/\/h5.m.taobao.com\/trip\/hotel\/detail\/detail.html?hid=0&shid=10107739&checkin=2014-05-12&checkout=2014-05-13&curcitycode=110100",
                    "pc_detail_url":"http:\/\/kezhan.trip.taobao.com\/hotel_detail2.htm?shid=10004405&searchBy=yisou&requestId=1232322313",
                    "rooms":{
                        "s_room_type":[
                            {
                                "srid":123456,
                                "shid":123456,
                                "name":"aaa",
                                "floor":"7-8层",
                                "bed":"[{\"bedType\":\"大床\",\"bedSize\":\"1.5m\"},{\"bedType\":\"双床\",\"bedSize\":\"1.2m\"}]",
                                "internet":"aaa",
                                "pic_url":"aaa",
                                "facility":"aaa",
                                "area":"16－30平米",
                                "max_occupancy":1,
                                "window_type":"有窗",
                                "status":0
                            }
                        ]
                    },
                    "bnb_hotel":false,
                    "check_in_time":"",
                    "check_out_time":"",
                    "pet_info":"",
                    "foreign_type":,
                    "foreign_desc":""
                }
            ]
        }
    }
}

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案
isv.invalid-parameter:ERROR	参数不正确：页数小于0，pagesize参数过大等	检查参数
isp.remote-service-error	系统错误	请稍后重试
isp.service-unavailable	服务不可用	重试或找对应开发

API测试工具错误码查询工具 SDK下载

开放平台

酒店导购API

taobao.xhotel.info.list.get (酒店详细信息查询)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ