taobao.tae.items.list (商品列表服务)

根据传入的字段及商品ID获取商品列表信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
fields String 必须 title,nick,price 返回值中需要的字段. 可选值 title,nick,pic_url,location,cid,price,post_fee,promoted_service,ju,shop_name字段间用 (,) 逗号分隔
num_iids String 可选 123456789,123456789 商品ID,英文逗号(,)分隔,最多50个。优先级低于open_iid,open_iids存在的话,则忽略本参数
open_iids String 可选 AAEhb-fzAAgOrLpFIt9AhGdJ,AAEhb-fzAAgOrLpFIt9AhGdJ
  • 最大长度:3000
  • 商品混淆ID,英文逗号(,)分隔,最多50个。优先级高于open_iid,本参数存在的话,则忽略num_iids

    响应参数

    名称 类型 示例值 描述
    items XItem [] 商品数据
    • └ cid
    • Number
    • 12344
    • 商品叶子类目
    • └ istk
    • Boolean
    • false
    • 是否淘客商品
    • location
    • XLocation
    • 位置信息
    • └ city
    • String
    • 杭州市
    • 商品所在市
    • └ state
    • String
    • 浙江省
    • 商品所在省
    • └ mall
    • Boolean
    • true
    • 是否天猫宝贝. true 是, false 不是
    • └ nick
    • String
    • aliwangwang
    • 卖家nick
    • └ num
    • Number
    • 123
    • 库存数量
    • └ open_id
    • Number
    • 123
    • 废弃, 不使用了。
    • └ pic_url
    • String
    • http://
    • 主图链接
    • └ post_fee
    • String
    • 10.00
    • 平邮邮费. 单位:元,精确到分
    • └ price
    • String
    • 120.50
    • 商品优惠价格(PC端),可能为空. 单位:元,精确到分。当PC端访问,且当前时间落在price_start_time到price_end_time区间内时使用该价格
    • └ price_end_time
    • String
    • 1411658400139
    • PC端商品优惠价格开始时间。如果当前没有PC端优惠,该字段为空
    • └ price_start_time
    • String
    • 1411658400139
    • PC端商品优惠价格结束时间。如果当前没有PC端优惠,该字段为空
    • └ price_wap
    • String
    • 35.00
    • 手机端商品优惠价格. 可能为空。单位:元,精确到分。当手机端访问且当前时间落在price_wap_start_time到price_wap_end_time之间的话,使用该价格。如果改价格为空,请使用reserve_price.
    • └ price_wap_end_time
    • String
    • 1411658400139
    • 手机端商品优惠价格结束时间。如果当前没有手机端优惠,该字段为空
    • └ price_wap_start_time
    • String
    • 1411658400139
    • 手机端商品优惠价格开始时间。如果当前没有手机端优惠,该字段为空
    • └ promoted_service
    • String
    • 2
    • 消保类型,多个类型以,分割。可取以下值: 2:假一赔三;4:7天无理由退换货;
    • └ reserve_price
    • String
    • 35.00
    • 商品的一口价
    • └ title
    • String
    • 正版连衣裙包邮
    • 商品标题
    • └ tk_rate
    • String
    • 150
    • 淘客佣金比例,比如:750 表示 7.50%
    • └ ju_item
    • Boolean
    • false
    • 是否是聚划算商品,如果查询参数的fields里没有设置ju条件,该值为空
    • └ ju_end
    • Number
    • 1421287688914
    • 聚划算活动结束时间,1970年到现在的毫秒数。如果不是聚划算商品,该值为空
    • └ ju_start
    • Number
    • 1421287588914
    • 聚划算活动开始时间,1970年到现在的毫秒数。如果不是聚划算商品,该值为空
    • └ ju_price
    • Number
    • 9000
    • 聚划算参团价格,如果不是聚划算商品,该值为空
    • └ shop_name
    • String
    • XXX的店铺
    • 店铺名称
    • └ open_auction_iid
    • String
    • open_auction_iid
    • └ open_iid
    • String
    • open_iid

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TaeItemsListRequest req = new TaeItemsListRequest();
    req.setFields("title,nick,price");
    req.setNumIids("123456789,123456789");
    req.setOpenIids("AAEhb-fzAAgOrLpFIt9AhGdJ,AAEhb-fzAAgOrLpFIt9AhGdJ");
    TaeItemsListResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <tae_items_list_response>
        <items>
            <x_item>
                <cid>12344</cid>
                <istk>false</istk>
                <location>
                    <city>杭州市</city>
                    <state>浙江省</state>
                </location>
                <mall>true</mall>
                <nick>aliwangwang</nick>
                <num>123</num>
                <open_id>123</open_id>
                <pic_url>http://</pic_url>
                <post_fee>10.00</post_fee>
                <price>120.50</price>
                <price_end_time>1411658400139</price_end_time>
                <price_start_time>1411658400139</price_start_time>
                <price_wap>35.00</price_wap>
                <price_wap_end_time>1411658400139</price_wap_end_time>
                <price_wap_start_time>1411658400139</price_wap_start_time>
                <promoted_service>2</promoted_service>
                <reserve_price>35.00</reserve_price>
                <title>正版连衣裙包邮</title>
                <tk_rate>150</tk_rate>
                <ju_item>false</ju_item>
                <ju_end>1421287688914</ju_end>
                <ju_start>1421287588914</ju_start>
                <ju_price>9000</ju_price>
                <shop_name>XXX的店铺</shop_name>
                <open_auction_iid></open_auction_iid>
            </x_item>
        </items>
    </tae_items_list_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>

    错误码解释

    错误码 错误描述 解决方案
    isv.invalid-numiids numiids非法 修改numiids
    isv.invalid-output-field output-field非法 修改output-field

    API工具

    如何获得此API

    FAQ

    返回
    顶部