淘宝开放平台

请求地址：

环境	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。

名称	类型	是否必须	示例值	更多限制	描述
user_id	Number	可选	0	默认值：0	用户ID
city_code	Number	可选	310100	默认值：310100	城市id
platform	Number	可选	2	默认值：2	平台码
keyword	String	可选	复仇者		关键词

名称	类型	示例值	描述
result	ResultListModel		result
└ return_url String returnUrl └ return_code String 0 返回错误码 └ request_id String requestId return_value_list TopShowInfo [] 返回值模型 └ id Number 1304628 id └ show_name String 反贪风暴4 影片名称 └ show_name_en String P Storm 影片英文民称 └ director String 林德禄导演 └ leading_role String 古天乐,郑嘉颖,林峯,林家栋主演 └ type String 剧情,动作,犯罪影片类型 └ country String 中国大陆国家 └ language String 中文语言 └ duration Number 98 时长 └ open_time String 2019-04-04 08:00 上映时间 └ poster String i2/TB14FRbNhTpK1RjSZFKXXa2wXXa_.jpg 海报 └ remark String 8.8 评分 └ remark_count Number 431938 评分人数 └ want_count Number 234234 想看人数 └ sold_type String NORMAL 售票 PRE预售售票类型 └ koubei_h5_url String - - └ alipay_koubei_h5_url String - - └ return_error_oper String returnErrorOper └ return_error_solution String returnErrorSolution └ return_message String returnMessage └ return_error_stack_trace String returnErrorStackTrace

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
FilmShowKeywordSearchRequest req = new FilmShowKeywordSearchRequest();
req.setUserId(0L);
req.setCityCode(310100L);
req.setPlatform(2L);
req.setKeyword("复仇者");
FilmShowKeywordSearchResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

XML示例
JSON示例

<film_show_keyword_search_response>
    <result>
        <return_url></return_url>
        <return_code>0</return_code>
        <request_id></request_id>
        <return_value_list>
            <top_show_info>
                <id>1304628</id>
                <show_name>反贪风暴4</show_name>
                <show_name_en>P Storm</show_name_en>
                <director>林德禄</director>
                <leading_role>古天乐,郑嘉颖,林峯,林家栋</leading_role>
                <type>剧情,动作,犯罪</type>
                <country>中国大陆</country>
                <language>中文</language>
                <duration>98</duration>
                <open_time>2019-04-04 08:00</open_time>
                <poster>i2/TB14FRbNhTpK1RjSZFKXXa2wXXa_.jpg</poster>
                <remark>8.8</remark>
                <remark_count>431938</remark_count>
                <want_count>234234</want_count>
                <sold_type>NORMAL 售票 PRE预售</sold_type>
                <koubei_h5_url>-</koubei_h5_url>
                <alipay_koubei_h5_url>-</alipay_koubei_h5_url>
            </top_show_info>
        </return_value_list>
        <return_error_oper></return_error_oper>
        <return_error_solution></return_error_solution>
        <return_message></return_message>
        <return_error_stack_trace></return_error_stack_trace>
    </result>
</film_show_keyword_search_response>

{
    "film_show_keyword_search_response":{
        "result":{
            "return_url":"",
            "return_code":"0",
            "request_id":"",
            "return_value_list":{
                "top_show_info":[
                    {
                        "id":1304628,
                        "show_name":"反贪风暴4",
                        "show_name_en":"P Storm",
                        "director":"林德禄",
                        "leading_role":"古天乐,郑嘉颖,林峯,林家栋",
                        "type":"剧情,动作,犯罪",
                        "country":"中国大陆",
                        "language":"中文",
                        "duration":98,
                        "open_time":"2019-04-04 08:00",
                        "poster":"i2\/TB14FRbNhTpK1RjSZFKXXa2wXXa_.jpg",
                        "remark":"8.8",
                        "remark_count":431938,
                        "want_count":234234,
                        "sold_type":"NORMAL 售票 PRE预售",
                        "koubei_h5_url":"-",
                        "alipay_koubei_h5_url":"-"
                    }
                ]
            },
            "return_error_oper":"",
            "return_error_solution":"",
            "return_message":"",
            "return_error_stack_trace":""
        }
    }
}

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>

错误码	错误描述	解决方案

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

电影票API

taobao.film.show.keyword.search (淘票票关键词搜索正在热映影片)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ