一、item_get-获得1688商品详情接口接入说明
点击注册获取key和secret测试账号
二、建议使用场景
1、获得1688商品详情接口
2、获取商品详情页数据信息
3、商城系统建设
4、代购系统商城建设
5、ERP系统商品选品
三、公共参数说明：
请求参数：num_iid=610947572360
参数说明：num_iid:1688商品ID
sales_data:&sales_data=1 获取近30天成交数据
agent:&agent=1 获取1688分销代发价格数据
四、响应参数
名称 类型 示例值 描述
num_iid String 610947572360 宝贝ID
title String 厂家直销小米有品Qin2 Pro智能手机学生机老人机备用机小爱同学4G 商品标题
desc_short String 商品简介
price Float 799.00 价格
total_price Float 0
suggestive_price Float 0
orginal_price Float 799.00 原价
nick String qin多亲科技 卖家昵称
num Int 2191
detail_url String https://detail.1688.com/offer/610947572360.html 宝贝链接
pic_url String https://cbu01.alicdn.com/img/ibank/2020/063/830/13235038360_979836901.jpg 宝贝图片
brand String MAJE 品牌
brandId Int 8879363 品牌id
rootCatId Int 0 顶级分类ID
cid Int 124264005
desc String
item_imgs Mix [{“url”: “https://cbu01.alicdn.com/img/ibank/2020/063/830/13235038360_979836901.jpg”}] 商品图片列表
item_weight String
post_fee Float 9.00 邮费
express_fee Float 9.00 EMS费用
ems_fee Float 9.00 物流费用
shipping_to String 广东广州白云区 发货至
video Mix [{“pic”: “https://img.alicdn.com/imgextra/i4/1795410438/O1CN01ZORTQ01F6dyavtEur_!!1795410438.jpg”, “url”: “//cloud.video.taobao.com/play/u/1795410438/p/1/e/1/t/8/218504165570.swf”,“type”: “item”}] 商品视频
sample_id String
props_name String 0:0:机身内存:64GB;1:0:颜色:铁灰色;1:1:颜色:瓷白色 商品属性名
prop_imgs Mix {“prop_img”: [ {“properties”: “1627207:1347647754”, “url”: “//gd2.alicdn.com/imgextra/i3/2596264565/TB2.XeblVXXXXXkXpXXXXXXXXXX_!!2596264565.jpg”}]} 商品属性图片列表
property_alias String 0:0:64GB;1:0:铁灰色;1:1:瓷白色 属性别名
props Mix [{“name”: “品牌”, “value”: “other”}] 商品详情
total_sold Int 1
scale Int
sellUnit Int
skus Mix {“sku”: [{“price”: “799.00”,“total_price”: “”,“sales”: “159”,“properties”: “0:0;1:0”, “properties_name”: “0:0:机身内存:64GB;1:0:颜色:铁灰色”, “quantity”: 716, “sku_id”: 3184603612387,“spec_id”:“0eb631954bfe8fb00a45824fc6193f2f” }]} 商品规格信息列表
seller_id Int 2206619673102 卖家ID
sales Int 100 销售额
shop_id Int 151372205 店铺ID
props_list Mix {“0:0”: “机身内存:64GB”} 商品属性
seller_info Mix {“nick”: “qin多亲科技”,“user_num_id”: “2206619673102”,“sid”: “b2b-2206619673102e9470”,“title”: “深圳多亲科技实力卖场”, “zhuy”: “https://winport.m.1688.com/page/index.html?memberId=b2b-2206619673102e9470”,“shop_name”: “深圳多亲科技实力卖场” } 卖家信息
tmall Boolean false 是否天猫
data_from String 1688app 错误信息
error String 错误信息
unit String 部; 单位
is_support_mix Boolean true
mix_amount Int 30
mix_Begin Int
mix_number Int
sales_data Date
location String 广东省 深圳市 发货地
props_img Mix 属性图片
sales_info Mix
desc_img Mix [{“https://cbu01.alicdn.com/img/ibank/2020/560/807/14112708065_979836901.jpg”}] 详情图片列表
shop_item Mix
relate_items Mix
五、请求示例：（CURL、PHP 、PHPsdk 、Java 、C# 、Python…)
<?php
// 请求示例 url 默认请求参数已经URL编码处理
// 本示例代码未加密secret参数明文传输，若要加密请参考：https://api.onebound.cn/taobao/demo/sdk2020/demo-sign.php
$method = "GET";
$url = "https://api-gw.onebound.cn/1688/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=610947572360";
$curl = curl_init();
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST,FALSE);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER,FALSE);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, true);
curl_setopt($curl, CURLOPT_ENCODING, "gzip");
var_dump(curl_exec($curl));
?>
API 工具
API SDK调用示例
APISDK下载
API测试工具
如何开通API测试，点击立即开通