taobao.products.get (获取产品列表)

根据淘宝会员帐号搜索所有产品信息,推荐使用taobao.products.search 注意:支持分页,每页最多返回100条,默认值为40,页码从1开始,默认为第一页

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
fields String [] 必须 product_id,tsc,cat_name,name
  • 最大列表长度:20
  • 需返回的字段列表.可选值:Product数据结构中的所有字段;多个字段之间用","分隔
    nick String 必须 淘小二 用户昵称
    page_no Number 可选 1 页码.传入值为1代表第一页,传入值为2代表第二页,依此类推.默认返回的数据是从第一页开始.
    page_size Number 可选 40 每页条数.每页返回最多返回100条,默认值为40

    响应参数

    名称 类型 示例值 描述
    products Product [] 返回具体信息为入参fields请求的字段信息
    • └ product_id
    • Number
    • 3433222
    • 产品ID
    • └ outer_id
    • String
    • 123456
    • 外部产品ID
    • └ tsc
    • String
    • hkjki
    • 淘宝标准产品编码
    • └ cid
    • Number
    • 50012286
    • 商品类目ID.必须是叶子类目ID
    • └ cat_name
    • String
    • 日用品
    • 商品类目名称
    • └ props
    • String
    • pid:vid;pid:vid
    • 产品的关键属性列表.格式:pid:vid;pid:vid
    • └ props_str
    • String
    • 品牌:诺基亚;型号:N73
    • 产品的关键属性字符串列表.比如:品牌:诺基亚;型号:N73(注:属性名称中的冒号":"被转换为:"#cln#"; 分号";"被转换为:"#scln#" )
    • └ name
    • String
    • 惠普笔记本
    • 产品名称
    • └ binds
    • String
    • pid:vid;pid:vid
    • 产品的非关键属性列表.格式:pid:vid;pid:vid.
    • └ binds_str
    • String
    • 品牌:诺基亚;型号:N73
    • 产品的非关键属性字符串列表.格式同props_str(注:属性名称中的冒号":"被转换为:"#cln#"; 分号";"被转换为:"#scln#" )
    • └ sale_props
    • String
    • pid:vid;pid:vid
    • 产品的销售属性列表.格式:pid:vid;pid:vid
    • └ sale_props_str
    • String
    • 品牌:诺基亚;型号:N73
    • 产品的销售属性字符串列表.格式同props_str(注:属性名称中的冒号":"被转换为:"#cln#"; 分号";"被转换为:"#scln#" )
    • └ price
    • String
    • 200.07
    • 产品的市场价.单位为元.精确到2位小数;如:200.07
    • └ desc
    • String
    • 这是一款产品
    • 产品的描述.最大25000个字节
    • └ pic_url
    • String
    • http://host/image_path
    • 产品的主图片地址.(绝对地址,格式:http://host/image_path)
    • └ created
    • Date
    • 2000-01-01 00:00:00
    • 创建时间.格式:yyyy-mm-dd hh:mm:ss
    • └ modified
    • Date
    • 2000-01-01 00:00:00
    • 修改时间.格式:yyyy-mm-dd hh:mm:ss
    • └ status
    • Number
    • 1
    • 当前状态(0 商家确认 1 屏蔽 3 小二确认 2 未确认 -1 删除)
    • product_imgs
    • ProductImg []
    • 产品的子图片.目前最多支持4张。fields中设置为product_imgs.id、product_imgs.url、product_imgs.position 等形式就会返回相应的字段
    • └ id
    • Number
    • 9684
    • 产品图片ID
    • └ product_id
    • Number
    • 96899
    • 图片所属产品的ID
    • └ url
    • String
    • http://host/image_path
    • 图片地址.(绝对地址,格式:http://host/image_path)
    • └ position
    • Number
    • 2355
    • 图片序号。产品里的图片展示顺序,数据越小越靠前。要求是正整数。
    • product_prop_imgs
    • ProductPropImg []
    • 产品的属性图片.比如说黄色对应的产品图片,绿色对应的产品图片。fields中设置为product_prop_imgs.id、 product_prop_imgs.props、product_prop_imgs.url、product_prop_imgs.position等形式就会返回相应的字段
    • └ id
    • Number
    • 674443
    • 产品属性图片ID
    • └ product_id
    • Number
    • 96899
    • 图片所属产品的ID
    • └ props
    • String
    • 颜色:红色表示为 1627207:28326
    • 属性串(pid:vid),目前只有颜色属性.如:颜色:红色表示为 1627207:28326
    • └ url
    • String
    • http://host/image_path
    • 图片地址.(绝对地址,格式:http://host/image_path)
    • └ position
    • Number
    • 2355
    • 图片序号。产品里的图片展示顺序,数据越小越靠前。要求是正整数。

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    ProductsGetRequest req = new ProductsGetRequest();
    req.setFields("product_id,tsc,cat_name,name");
    req.setNick("淘小二");
    req.setPageNo(1L);
    req.setPageSize(40L);
    ProductsGetResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <products_get_response>
        <products>
            <product>
                <product_id>3433222</product_id>
                <outer_id>123456</outer_id>
                <tsc>hkjki</tsc>
                <cid>50012286</cid>
                <cat_name>日用品</cat_name>
                <props>pid:vid;pid:vid</props>
                <props_str>品牌:诺基亚;型号:N73</props_str>
                <name>惠普笔记本</name>
                <binds>pid:vid;pid:vid</binds>
                <binds_str>品牌:诺基亚;型号:N73</binds_str>
                <sale_props>pid:vid;pid:vid</sale_props>
                <sale_props_str>品牌:诺基亚;型号:N73</sale_props_str>
                <price>200.07</price>
                <desc>这是一款产品</desc>
                <pic_url>http://host/image_path</pic_url>
                <created>2000-01-01 00:00:00</created>
                <modified>2000-01-01 00:00:00</modified>
                <status>1</status>
                <product_imgs>
                    <product_img>
                        <id>9684</id>
                        <product_id>96899</product_id>
                        <url>http://host/image_path</url>
                        <position>2355</position>
                    </product_img>
                </product_imgs>
                <product_prop_imgs>
                    <product_prop_img>
                        <id>674443</id>
                        <product_id>96899</product_id>
                        <props>颜色:红色表示为 1627207:28326</props>
                        <url>http://host/image_path</url>
                        <position>2355</position>
                    </product_prop_img>
                </product_prop_imgs>
            </product>
        </products>
    </products_get_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.user-not-exist:invalid-nick 传入的nick不存在 发生错误不要重试,清除本地数据库该用户资料,或者使用其他接口(如:taobao.item.get)来更新用户资料

    API工具

    如何获得此API

    FAQ

    返回
    顶部