全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
获取单个商品详细信息
接口地址： http://api.vv-tool.com/tool/erps/getproduct
接口介绍： 获取单个商品详细信息
请求方式： POST
返回格式： JSON
接口收费： 联系客服
频率限制： 10 次/秒
请求头参数
| 参数 | 类型 | 必选 | 值 | 示例 |
|---|---|---|---|---|
| Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请使用新的生成 token 接口 点击查看详情
请求参数
| 参数 | 类型 | 必选 | 描述 |
|---|---|---|---|
| shop_id | Number | 是 | 店铺 id |
| fields | String | 是 | 需要返回的商品字段列表。可选值：Item 商品结构体中所有字段均可返回，多个字段用“,”分隔。 |
| num_iid | Number | 是 | 商品数字 ID |
| vvtype | Number | 否 | 2 高级版（必须填 2,不填默认是 2） |
请求示例
请求代码示例
cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
响应参数
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| item | Item | 商品详细信息 | |
| detail_url | String | http://item.taobao.com/auction/item_detail.htm?xid=0db2&item_num_id=46418&cm_cat=559372&pm2=1 | 商品 url |
| num_iid | Number | 1489161932 | 商品数字 id |
| title | String | Google test item | 商品标题，不能超过 60 字节 |
| nick | String | tbtest561 | 卖家昵称 |
| type | String | fixed | 商品类型(fixed:一口价;auction:拍卖)注：取消团购 |
| cid | Number | 132443 | 商品所属的叶子类目 id |
| seller_cids | String | 2234445,3344466,446434 | 商品所属的店铺内卖家自定义类目列表 |
| props | String | 135255:344454 | 商品属性 格式：pid:vid;pid:vid |
| input_pids | String | 2432,5353,656425 | 用户自行输入的类目属性 ID 串。结构："pid1,pid2,pid3"，如："20000"（表示品牌） 注：通常一个类目下用户可输入的关键属性不超过 1 个。 |
| input_str | String | 耐克;耐克系列;科比系列;科比系列;2K5 | 用户自行输入的子属性名和属性值，结构："父属性值;一级子属性名;一级子属性值;二级子属性名;自定义输入值，....",如：“耐克;耐克系列;科比系列;科比系列;2K5”，input_str 需要与 input_pids 一一对应，注：通常一个类目下用户可输入的关键属性不超过 1 个。所有属性别名加起来不能超过 3999 字节。 |
| desc | String | 这是一个好商品 | 商品描述， 字数要大于 5 个字节，小于 25000 个字节 |
| pic_url | String | http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg | 商品主图片地址 |
| num | Number | 8888 | 商品数量 |
| valid_thru | Number | 7 | 有效期，7 或者 14（默认是 14 天） |
| list_time | Date | 2009-10-22 14:22:06 | 上架时间（格式：yyyy-MM-dd HH:mm:ss） |
| delist_time | Date | 2000-01-01 00:00:00 | 下架时间（格式：yyyy-MM-dd HH:mm:ss） |
| stuff_status | String | new | 商品新旧程度(全新：new，闲置：unused，二手：second) |
| location | Location | 商品所在地 | |
| zip | String | 310000 | 邮政编码 |
| address | String | 华星路 99 号创业大厦 | 详细地址，最大 256 个字节（128 个中文） |
| city | String | 杭州 | 所在城市（中文名称） |
| state | String | 浙江 | 所在省份（中文名称） |
| country | String | 中国 | 国家名称 |
| district | String | 西湖区 | 区/县（只适用于物流 API） |
| price | Price | 5.00 | 商品价格，格式：5.00；单位：元；精确到：分 |
| post_fee | Price | 5.00 | 平邮费用，格式：5.00；单位：元；精确到：分 |
| express_fee | Price | 5.00 | 快递费用，格式：5.00；单位：元；精确到：分 |
| ems_fee | Price | 5.00 | ems 费用，格式：5.00；单位：元；精确到：分 |
| has_discount | Boolean | true | 支持会员打折，true/false |
| freight_payer | String | seller | 运费承担方式，seller（卖家承担），buyer(买家承担） |
| has_invoice | Boolean | true | 是否有发票，true/false |
| has_warranty | Boolean | true | 是否有保修，true/false |
| has_showcase | Boolean | true | 橱窗推荐，true/false |
| modified | Date | 2000-01-01 00:00:00 | 商品修改时间（格式：yyyy-MM-dd HH:mm:ss） |
| increment | String | 0 | 加价幅度。如果为 0，代表系统代理幅度。在竞拍中，为了超越上一个出价，会员需要在当前出价上增加金额，这个金额就是加价幅度。卖家在发布宝贝的时候可以自定义加价幅度，也可以让系统自动代理加价。系统自动代理加价的加价幅度随着当前出价金额的增加而增加，我们建议会员使用系统自动代理加价，并请买家在出价前看清楚加价幅度的具体金额。另外需要注意是，此功能只适用于拍卖的商品。以下是系统自动代理加价幅度表：当前价（加价幅度 ）1-40（ 1 ）、41-100（ 2 ）、101-200（5 ）、201-500 （10）、501-1001（15）、001-2000（25）、2001-5000（50）、5001-10000（100）10001 以上 200 |
| auto_repost | Boolean | true | 自动重发，true/false |
| approve_status | String | onsale | 商品上传后的状态。onsale 出售中，instock 库中 |
| postage_id | Number | 32 | 宝贝所属的运费模板 ID，如果没有返回则说明没有使用运费模板 |
| product_id | Number | 85883030 | 宝贝所属产品的 id(可能为空). 该字段可以通过 taobao.products.search 得到 |
| auction_point | Number | 15 | 返点比例 |
| property_alias | String | property | 属性值别名 |
| item_imgs | ItemImg[] | 商品图片列表(包括主图)。fields 中只设置 item_img 可以返回 ItemImg 结构体中所有字段，如果设置为 item_img.id、item_img.url、item_img.position 等形式就只会返回相应的字段 | |
| url | String | http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg | 图片链接地址 |
| position | Number | 1 | 图片放在第几张（多图时可设置） |
| prop_imgs | PropImg[] | 商品属性图片列表。fields 中只设置 prop_img 可以返回 PropImg 结构体中所有字段，如果设置为 prop_img.id、prop_img.url、prop_img.properties、prop_img.position 等形式就只会返回相应的字段 | |
| id | Number | 1646146 | 属性图片的 id，和商品相对应 |
| url | String | http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg | 图片链接地址 |
| properties | String | 1627207:28326 | 图片所对应的属性组合的字符串 |
| position | Number | 1 | 图片放在第几张（多图时可设置） |
| created | Date | 2000-01-01 00:00:00 | 图片创建时间 时间格式：yyyy-MM-dd HH:mm:ss |
| skus | Sku[] | Sku 列表。fields 中只设置 sku 可以返回 Sku 结构体中所有字段，如果设置为 sku.sku_id、sku.properties、sku.quantity 等形式就只会返回相应的字段 | |
| sku_id | Number | 123 | sku 的 id |
| iid | String | asdf12323adfaa | sku 所属商品 id(注意：iid 近期即将废弃，请用 num_iid 参数) |
| num_iid | Number | 12345 | sku 所属商品数字 id |
| properties | String | 1243:1215;5626:5125 | sku 的销售属性组合字符串（颜色，大小，等等，可通过类目 API 获取某类目下的销售属性）,格式是 p1:v1;p2:v2 |
| quantity | Number | 3 | 属于这个 sku 的商品的数量， |
| price | String | 200.07 | 属于这个 sku 的商品的价格 取值范围：0-100000000;精确到 2 位小数;单位：元。如：200.07，表示：200 元 7 分。 |
| created | String | 2009-11-04 15:24:43 | sku 创建日期 时间格式：yyyy-MM-dd HH:mm:ss |
| modified | String | 2009-11-04 15:24:43 | sku 最后修改日期 时间格式：yyyy-MM-dd HH:mm:ss |
| status | String | normal | sku 状态。 normal:正常 ；delete:删除，淘宝天猫此字段无效 |
| properties_name | String | 20000:3275069:品牌：盈讯;1753146:3485013:型号：F908;-1234:-5678:自定义属性 1:属性值 1 | sku 所对应的销售属性的中文名字串，格式如：pid1:vid1:pid_name1:vid_name1;pid2:vid2:pid_name2:vid_name2…… |
| sku_spec_id | Number | 123 | 表示 SKu 上的产品规格信息 |
| with_hold_quantity | Number | 100 | 商品在付款减库存的状态下，该 sku 上未付款的订单数量 |
| sku_delivery_time | String | 2013-11-11 | sku 级别发货时间 |
| change_prop | String | pid:vid:vid1,vid2,vid3;pid:vid:vid1,vid2 | 基础色数据 |
| outer_id | String | 12345 | 商家设置的外部 id。天猫和集市的卖家，需要登录才能获取到自己的商家编码，不能获取到他人的商家编码。 |
| barcode | String | 6903244981002 | 商品级别的条形码 |
| gmt_modified | Date | ||
| sku_feature | JSON | skuFeature | |
| delivery_time_type | String | skuDeliveryTimeType | |
| spec_id | String | specId | |
| outer_id | String | 34143554352 | 商家外部编码(可与商家外部系统对接) |
| is_virtual | Boolean | true | 虚拟商品的状态字段 |
| is_taobao | Boolean | true | 是否在淘宝显示 |
| is_ex | Boolean | true | 是否在外部网店显示 |
| is_timing | Boolean | true | 是否定时上架商品 |
| videos | Video[] | 商品视频列表(目前只支持单个视频关联)。fields 中只设置 video 可以返回 Video 结构体中所有字段，如果设置为 video.id、video.video_id、video.url 等形式就只会返回相应的字段 | |
| id | Number | 123456 | 视频关联记录的 id，和商品相对应 |
| video_id | Number | 123456 | video 的 id，对应于视频在淘秀的存储记录 |
| url | String | http://js.tudouui.com/bin/taobaoisv/TaoBaoPlayer.swf…… | video 的 url 连接地址。淘秀里视频记录里面存储的 url 地址 |
| 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） |
| iid | String | 94bccd061369cba108c2665445235154 | 视频记录关联的商品的数字 id(注意：iid 近期即将废弃，请用 num_iid 参数) |
| num_iid | Number | 1497217011 | 视频记录所关联的商品的数字 id |
| is_3D | Boolean | true | 是否是 3D 淘宝的商品 |
| score | Number | 2 | 商品所属卖家的信用等级数，1 表示 1 心，2 表示 2 心……，只有调用商品搜索：taobao.items.get 和 taobao.items.search 的时候才能返回 |
| volume | Number | 22 | 商品 30 天交易量，只有调用商品搜索：taobao.items.get 和 taobao.items.search 的时候才能返回 |
| one_station | Boolean | true | 是否淘 1 站商品 |
| second_kill | String | web_only | 秒杀商品类型。打上秒杀标记的商品，用户只能下架并不能再上架，其他任何编辑或删除操作都不能进行。如果用户想取消秒杀标记，需要联系小二进行操作。如果秒杀结束需要自由编辑请联系活动负责人（小二）去掉秒杀标记。可选类型 web_only(只能通过 Web 网络秒杀)wap_only(只能通过 wap 网络秒杀)web_and_wap(既能通过 Web 秒杀也能通过 wap 秒杀) |
| auto_fill | String | time_card | 代充商品类型。只有少数类目下的商品可以标记上此字段，具体哪些类目可以上传可以通过 taobao.itemcat.features.get 获得。在代充商品的类目下，不传表示不标记商品类型（交易搜索中就不能通过标记搜到相关的交易了）。可选类型：time_card(点卡软件代充)fee_card(话费软件代充) |
| cod_postage_id | Number | 53899 | 货到付款运费模板 ID |
| is_prepay | Boolean | true | 商品是否为先行赔付 taobao.items.search 和 taobao.items.vip.search 专用 |
| ww_status | Boolean | true | 商品所属的商家的旺旺在线状况，taobao.items.search 和 taobao.items.vip.search 专用 |
| wap_detail_url | String | http://auction1.wap.taobao.com/auction/item_detail-0db0-1234567.jhtml | 适合 wap 应用的商品详情 url ，该字段只在 taobao.item.get 接口中返回 |
| wap_desc | String | Wap 宝贝详情 | 不带 HTML 标签的 desc 文本信息，该字段只在 taobao.item.get 接口中返回 |
| violation | Boolean | true | 商品是否违规，违规：true , 不违规：false |
| sell_promise | Boolean | true | 是否承诺退换货服务！ |
| period_sold_quantity | Number | 100 | 周期销售库存 |
| item_rectangle_imgs | ItemImg[] | itemRectangleImgs | |
| url | String | http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg | 图片链接地址 |
| position | Number | 1 | 图片放在第几张（多图时可设置） |
| after_sale_id | Number | 123 | 售后服务 ID,该字段仅在 taobao.item.get 接口中返回 |
| barcode | String | 6903244981002 | 商品级别的条形码 |
| created | Date | 2000-01-01 00:00:00 | Item 的发布时间，目前仅供 taobao.item.add 和 taobao.item.get 可用 |
| custom_made_type_id | String | 1 | 定制工具 Id |
| desc_module_info | JSON | 宝贝描述规范化模块锚点信息 | |
| features | String | ;tags:3522,7234;source:sell;sp:2; | 宝贝特征值，只有在 Top 支持的特征值才能保存到宝贝上 |
| food_security | JSON | 食品安全信息，包括：生产许可证编号、产品标准号、厂名、厂址等 | |
| inner_shop_auction_template_id | Number | 2185480 | 用户内店宝贝装修模板 id |
| is_fenxiao | Number | 0 | 非分销商品：0，代销：1，经销：2 |
| is_lightning_consignment | Boolean | true | 是否 24 小时闪电发货 |
| is_xinpin | Boolean | false | 标示商品是否为新品。值含义：true-是，false-否。 |
| is_area_sale | Boolean | true | true:商品是区域限售商品；false:商品不是区域限售商品。 |
| large_screen_image_url | String | i4/2054159008/TB2ixFaXXXXXXbrXXXXXXXXXXXX_!!2054159008.png | 门店大屏图 |
| cuntao_item_specific | JSON | 村淘特有商品级数据结构 | |
| desc_modules | String | [{"module_id":123,"module_name":"模特图","type":"cat_mod","content":"模特要漂亮一点拜托"},{"module_id":null,"module_name":"店主最漂亮","type":"usr_mod","content":"老娘全网最美"}] | 商品描述模块化，模块列表，由 List 转化成 jsonArray 存入，后端逻辑验证通过，拼装成模块内容 + 锚点导航后存入 desc 中。数据结构具体参见 Item_Desc_Module |
| with_hold_quantity | Number | 12 | 预扣库存，即付款减库存的商品现在有多少处于未付款状态的订单 |
| wireless_desc | String | 无线宝贝描述，亲 | 无线的宝贝描述 |
| video_id | Number | 9527 | 该字段废弃，请勿使用。 |
| template_id | String | 123456 | 页面模板 id |
| sub_stock | Number | 1 | 商品是否支持拍下减库存：1 支持;2 取消支持(付款减库存);0(默认)不更改 集市卖家默认拍下减库存; 商城卖家默认付款减库存 |
| sold_quantity | Number | 8888 | 商品销量 |
| sell_point | String | 2013 新款 时尚 前卫 | 商品卖点信息，天猫商家使用字段，最长 150 个字符。 |
| props_name | String | 20000:3275069:品牌：盈讯;1753146:3485013:型号：F908;30606:112030:上市时间：2008 年 | 商品属性名称。标识着 props 内容里面的 pid 和 vid 所对应的名称。格式为：pid1:vid1:pid_name1:vid_name1;pid2:vid2:pid_name2:vid_name2……(注：属性名称中的冒号":"被转换为："#cln#"; 分号";"被转换为："#scln#") |
| promoted_service | String | 2 | 消保类型，多个类型以，分割。可取以下值：2：假一赔三；4：7 天无理由退换货；taobao.items.search 和 taobao.items.vip.search 专用 |
| paimai_info | JSON | {"interval":5,"deposit":20,"reserve":12,"valid_hour":20,"valid_minute":23,"mode":1} | 用于保存拍卖有关的信息 |
| outer_shop_auction_template_id | Number | 2185481 | 用户外店装修模板 id |
| newprepay | String | 1 | 是否为新消保法中的 7 天无理由退货 |
| mpic_video | JSON | 宝贝主图视频的数据信息，包括：视频 ID，视频缩略图 URL，视频时长，视频状态等信息。 | |
| locality_life | JSON | {"packageid":"1234","obs":"1","network_id":"5645746","onsale_auto_refund_ratio":80,"refund_ratio":50,"verification":"1","merchant":"56879:码商 X","choose_logis":"0","expirydate":"2012-08-06,2012-08-16","refundmafee":"b","eticket":";market:eticket;refundmafee:b;","version":"1"} | 本地生活电子交易凭证业务，目前此字段只涉及到的信息为有效期：如果有效期为起止日期类型，此值为 2012-08-06,2012-08-16 如果有效期为【购买成功日 至】类型则格式为 2012-08-16 如果有效期为天数类型则格式为 3 |
| item_weight | String | 10 | 商品的重量，用于按重量计费的运费模板。注意：单位为 kg |
| item_size | String | bulk:10 | 表示商品的体积，用于按体积计费的运费模板。该值的单位为立方米（m3）。该值支持两种格式的设置：格式 1：bulk:3,单位为立方米(m3),表示直接设置为商品的体积。格式 2：weight:10;breadth:10;height:10，单位为米（m） |
| cpv_memo | String | 1627207:28320:绿叶繁花; | 属性值的备注，格式：pid:vid:备注信息 1;pid2:vid2:备注信息 2; |
| global_stock_country | String | 美国 | 全球购商品采购地信息（地区/国家），代表全球购商品的产地信息。 |
| global_stock_type String 1 全球购商品采购地信息（库存类型），有两种库存类型：现货和代购;参数值为 1 时代表现货，值为 2 时代表代购 | |||
| withholding_money | int | 11 | 该接口扣费金额（点券） |
返回数据
响应代码
| 代码 | 代码描述 | 解决方案 |
|---|---|---|
| 0 | 成功 | |
| 100 | 请求参数错误 | 检查您的请求参数是否正确 |
| 101 | 请求超时，请重试 | 检查您的网络情况或者联系客服解决 |
| 103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
| 200 | 系统错误，请联系客服 | 检查您的接口地址填写是否正确，其他问题联系客服解决 |
| 203 | 暂不支持当前接口 | |
| 204 | 请求异常：无该接口权限，请前往官网开通正式接口。 | 前往官网开通该接口权限 |
| 204 | 请求异常：API 调用次数不足，请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
| 302 | 未授权店铺 | 根据返回链接进行扫码授权 |