taobao.product.get.tmall (天猫获取商品)

两种方式查看一个产品详细信息: 传入product_id来查询 传入cid和props来查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
fields String 必须 product_id,outer_id 需返回的字段列表.可选值:Product数据结构中的所有字段;多个字段之间用","分隔.
product_id Number 可选 86126527 Product的id.两种方式来查看一个产品:1.传入product_id来查询 2.传入cid和props来查询
cid Number 可选 50012286 商品类目id.调用taobao.itemcats.get获取;必须是叶子类目id,如果没有传product_id,那么cid和props必须要传.
props String 可选 10005:10027;10006:29729 比如:诺基亚N73这个产品的关键属性列表就是:品牌:诺基亚;型号:N73,对应的PV值就是10005:10027;10006:29729.
market_id String 可选 2 2
customer_props String 可选 customer_props customer_props

响应参数

名称 类型 示例值 描述
product 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 删除)
  • └ vertical_market
  • Number
  • 3
  • 垂直市场,如:3(3C),4(鞋城)
  • └ property_alias
  • String
  • 1627207:3232483:深深绿色
  • 销售属性值别名。格式为pid1:vid1:alias1;pid1:vid2:alia2。
  • └ customer_props
  • String
  • 20000:优衣库
  • 用户自定义属性,结构:pid1:value1;pid2:value2 例如:“20000:优衣库”,表示“品牌:优衣库”
  • └ sell_pt
  • String
  • 明星同款
  • 产品卖点描述,长度限制20个汉字
  • 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
  • 图片序号。产品里的图片展示顺序,数据越小越靠前。要求是正整数。
  • └ cspu_feature
  • String
  • cspu:0/cspu:1
  • cspuFeature

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
ProductGetTmallRequest req = new ProductGetTmallRequest();
req.setFields("product_id,outer_id");
req.setProductId(86126527L);
req.setCid(50012286L);
req.setProps("10005:10027;10006:29729");
req.setMarketId("2");
req.setCustomerProps("customer_props");
ProductGetTmallResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<product_get_tmall_response>
    <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>
        <vertical_market>3</vertical_market>
        <property_alias>1627207:3232483:深深绿色</property_alias>
        <customer_props>20000:优衣库</customer_props>
        <sell_pt>明星同款</sell_pt>
        <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>
        <cspu_feature>cspu:0/cspu:1</cspu_feature>
    </product>
</product_get_tmall_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.missing-parameter:pid-or-cid 输入参数不正确,检查需要输入的参数 1,输入正确的product_id 2,输入正确的cid和props (这些参数均可以通过taobao.products.search或taobao.products.get接口获取)

API工具

如何获得此API

FAQ

返回
顶部