文档中心 > API类目 > 电影票API

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

关键词搜索正在热映影片

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
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>

    异常示例

    • 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工具

    如何获得此API

    FAQ

    返回
    顶部