一、接口参数说明:
提取1688商品详情页各项数据,包含skuid、价格、收藏数、加购数、月销售量、主图、标题、详情页图片,价格低至几厘,量大甚至免费,详情请加我,或者私聊我,或者是点击注册账号获取key和secret,直接获取免费测试。
二、建议使用场景
1、商品销售情况分析,根据销量调整活动方案,关联销售,库存准备等等
2、获取商品详情页数据信息
3、商城系统建设
4、代购系统商城建设
5、ERP系统商品选品
…
三、公共参数说明:
名称 类型 必须 描述
key String 是 调用key(必须以GET方式拼接在URL中)
secret String 是 调用密钥
api_name String 是 API接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等]
cache String 否 [yes,no]默认yes,将调用缓存的数据,速度比较快
result_type String 否 [json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读
lang String 否 [cn,en,ru]翻译语言,默认cn简体中文
version String 否 API版本
四、API请求参数说明:
参数说明:num_iid:1688商品ID
sales_data:&sales_data=1 获取近30天成交数据
agent:&agent=1 获取1688分销代发价格数据
五、响应参数
\
item item[] 宝贝详情数据
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 detail.1688.com/offer/61094… 宝贝链接
pic_url String cbu01.alicdn.com/img/ibank/2… 宝贝图片
brand String MAJE 品牌
brandId Int 8879363 品牌id
rootCatId Int 0 顶级分类ID
cid Int 124264005
desc String
item_imgs Mix item_imgs[] 商品图片
url string cbu01.alicdn.com/img/ibank/2…
item_weight String
post_fee Float 9.00 邮费
express_fee Float 9.00 EMS费用
ems_fee Float 9.00 物流费用
shipping_to String 广东广州白云区 发货至
video video[] 商品视频
pic string img.alicdn.com/imgextra/i4…!!1795410438.jpg 视频预览图
url string //cloud.video.taobao.com/play/u/1795410438/p/1/e/1/t/8/218504165570.swf 视频路径
type string item 视频类型
sample_id String
props_name String 0:0:机身内存:64GB;1:0:颜色:铁灰色;1:1:颜色:瓷白色 商品属性名
prop_imgs prop_imgs[] 商品属性图片列表
prop_img prop_img[]
property_alias String 0:0:64GB;1:0:铁灰色;1:1:瓷白色 属性别名
props Mix [{"name": "品牌", "value": "other"}] 商品详情
total_sold Int 1
scale Int
sellUnit Int
skus skus[] 商品规格信息列表
sku sku[]
price string 799
total_price string
sales string 150
properties string 0:0;1:1
properties_name string 0:0:机身内存:64GB;1:1:颜色:瓷白色
quantity string 63828b15ad641fdb131775f32e4c050c
sku_id string 4309097072612
seller_id Int 2206619673102 卖家ID
sales Int 100 销售额
shop_id Int 151372205 店铺ID
props_list Mix {"0:0": "机身内存:64GB"} 商品属性
seller_info seller_info[] 卖家信息
nick string qin多亲科技
user_num_id Bigint 2206619673102
sid Bigint 127203758
title string qin多亲科技
zhuy string winport.m.1688.com/page/index.…
shop_name string 深圳多亲科技实力卖场
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 [{"cbu01.alicdn.com/img/ibank/2…"}] 详情图片列表
shop_item Mix
relate_items Mix
\
六、请求示例:(CURL、PHP 、PHPsdk 、Java 、C# 、Python)
\
$method = "GET"; $url = "[https://注册获取请求链接/1688/item_get/?key=](https://xn--26qr9c5yx8liwxa941hpcmj6q/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)); ?>\
响应示例
\
{
"item": {
"num_iid": "610947572360",
"title": "厂家直销小米有品Qin2 Pro智能手机学生机老人机备用机小爱同学4G",
"desc_short": "",
"price": "799.00",
"total_price": 0,
"suggestive_price": 0,
"orginal_price": "799.00",
"nick": "qin多亲科技",
"num": "1763",
"detail_url": "detail.1688.com/offer/61094…",
"pic_url": "cbu01.alicdn.com/img/ibank/2…",
"brand": "",
"brandId": "",
"rootCatId": "",
"cid": "50903",
"desc": "<div id="offer-template-0">
深圳市多亲科技有限公司(简称“多亲科技”)成立于2014年9月是国内领先的人工智能硬件解决方案供应商。多亲科技积极推动人工智能技术的创新研发,在人工智能终端设备、系统软件的研发和生产领域,具有深厚的技术沉淀与实力。
多亲产品销售网络覆盖全国各地乃至远销海外,欢迎企业定制、团购、经销代理。
优质的产品、过硬的技术、完善的服务、是我们合作双赢的开篇。
欢迎有意向者实地考察,垂询电话:13662284449.
温馨提示:
1、可定制--承接各种订单订制!为客户定制机身、开机画面、预装软件、包装等定制!
2、质量保证--本公司专注通讯行业10年,线下线下百花齐放,客户复购率达30%以上。
3、价格实惠--本店是工厂直供,没有中间商差价,一站到客,薄利多销。
4、售后服务--本店出售的所有产品均提供1年的质保。因质量原因退换货(非人为因素)30天内换新。
<img alt="undefined" height="446.22866894197955" src="[cbu01.alicdn.com/img/ibank/2…" width="790" />
<img alt="undefined" height="457.5154730327144" src="[cbu01.alicdn.com/img/ibank/2…" width="790" />
<img alt="undefined" height="443.2365499573014" src="[cbu01.alicdn.com/img/ibank/2…" width="790" />
<img alt="undefined" height="440.350569675723" src="[cbu01.alicdn.com/img/ibank/2…" width="790" />
<img alt="undefined" src="[cbu01.alicdn.com/img/ibank/2…" />
<img alt="undefined" src="[cbu01.alicdn.com/img/ibank/2…" />
<img alt="undefined" src="[cbu01.alicdn.com/img/ibank/2…" />
<img alt="undefined" src="[cbu01.alicdn.com/img/ibank/2…" />
<img alt="undefined" src="[cbu01.alicdn.com/img/ibank/2…" />
<img alt="undefined" src="[cbu01.alicdn.com/img/ibank/2…" />
<img alt="undefined" src="[cbu01.alicdn.com/img/ibank/2…" />
<img alt="undefined" src="[cbu01.alicdn.com/img/ibank/2…" />
<img alt="undefined" src="[cbu01.alicdn.com/img/ibank/2…" />
<img alt="undefined" src="[cbu01.alicdn.com/img/ibank/2…" />
<img alt="undefined" src="[cbu01.alicdn.com/img/ibank/2…" />
<img alt="undefined" src="[cbu01.alicdn.com/img/ibank/2…" />
<img alt="undefined" src="[cbu01.alicdn.com/img/ibank/2…" />
<img alt="undefined" src="[cbu01.alicdn.com/img/ibank/2…" />
<img alt="undefined" src="[cbu01.alicdn.com/img/ibank/2…" />
<img alt="undefined" src="[cbu01.alicdn.com/img/ibank/2…" />
<img alt="undefined" src="[cbu01.alicdn.com/img/ibank/2…" />
<img alt="undefined" src="[cbu01.alicdn.com/img/ibank/2…" />
<img alt="undefined" src="[cbu01.alicdn.com/img/ibank/2…" />
<img alt="undefined" src="[cbu01.alicdn.com/img/ibank/2…" />
<img alt="undefined" src="[cbu01.alicdn.com/img/ibank/2…" />
<img alt="undefined" src="[cbu01.alicdn.com/img/ibank/2…" />
<img alt="undefined" src="[cbu01.alicdn.com/img/ibank/2…" />
<img alt="undefined" src="[cbu01.alicdn.com/img/ibank/2…" />
<img alt="undefined" src="[cbu01.alicdn.com/img/ibank/2…" />
<img alt="undefined" src="[cbu01.alicdn.com/img/ibank/2…" />
<img alt="undefined" src="[cbu01.alicdn.com/img/ibank/2…" />
<img alt="undefined" src="[cbu01.alicdn.com/img/ibank/2…" />
<img alt="undefined" src="[cbu01.alicdn.com/img/ibank/2…" />
<img alt="undefined" src="[cbu01.alicdn.com/img/ibank/2…" />
<img alt="undefined" src="[cbu01.alicdn.com/img/ibank/2…" />
<img alt="undefined" src="[cbu01.alicdn.com/img/ibank/2…" />
<img alt="undefined" src="[cbu01.alicdn.com/img/ibank/2…" />
<img alt="undefined" src="[cbu01.alicdn.com/img/ibank/2…" />
"item_imgs": [
{
"url": "cbu01.alicdn.com/img/ibank/2…"
},
{
"url": "cbu01.alicdn.com/img/ibank/2…"
},
{
"url": "cbu01.alicdn.com/img/ibank/2…"
},
{
"url": "cbu01.alicdn.com/img/ibank/2…"
},
{
"url": "cbu01.alicdn.com/img/ibank/2…"
}
],
"item_weight": "",
"post_fee": "",
"express_fee": "",
"ems_fee": "",
"shipping_to": "",
"video": [],
"sample_id": "",
"props_name": "0:0:机身内存:64GB;1:0:颜色:铁灰色;1:1:颜色:瓷白色",
"prop_imgs": {
"prop_img": []
},
"property_alias": "0:0:64GB;1:0:铁灰色;1:1:瓷白色",
"props": [
{
"name": "品牌",
"value": "多亲"
},
{
"name": "型号",
"value": "Qin 2 Pro"
},
{
"name": "手机类型",
"value": "老人手机"
},
{
"name": "外形",
"value": "直板"
},
{
"name": "主屏尺寸",
"value": "大屏幕(5.0英寸—5.9英寸)"
},
{
"name": "网络制式",
"value": "移动4G(TD-LTE),联通/电信4G(FDD-LTE)"
},
{
"name": "操作系统",
"value": "Android 9.0系统"
},
{
"name": "电池容量",
"value": "2100"
},
{
"name": "摄像头像素",
"value": "1200万-1999万"
},
{
"name": "存储卡",
"value": "支持存储卡"
},
{
"name": "处理器核心",
"value": "八核"
},
{
"name": "运行内存",
"value": "2GB"
},
{
"name": "手机版本",
"value": "大陆行货"
},
{
"name": "售后类型",
"value": "全国联保"
},
{
"name": "上市时间",
"value": "2019"
},
{
"name": "适用送礼场合",
"value": "员工福利,颁奖纪念,广告促销,节日,展销会,公关策划,生日,商务馈赠"
},
{
"name": "3C证书编号",
"value": "2019161606319519"
},
{
"name": "CPU品牌",
"value": "展讯"
},
{
"name": "运营商",
"value": "中国移动,中国电信,中国联通"
},
{
"name": "网络模式",
"value": "单卡单模"
},
{
"name": "机身内存",
"value": "64GB"
},
{
"name": "颜色",
"value": "铁灰色,瓷白色"
},
{
"name": "电信设备进网许可证编号",
"value": "02-B613-192425"
}
],
"total_sold": "1",
"scale": "",
"sellUnit": "",
"skus": {
"sku": [
{
"price": "799.00",
"total_price": 0,
"sales": "55",
"properties": "0:0;1:1",
"properties_name": "0:0:机身内存:64GB;1:1:颜色:瓷白色",
"quantity": "932",
"sku_id": "4309097072612",
"spec_id": "63828b15ad641fdb131775f32e4c050c"
},
{
"price": "799.00",
"total_price": 0,
"sales": "159",
"properties": "0:0;1:0",
"properties_name": "0:0:机身内存:64GB;1:0:颜色:铁灰色",
"quantity": "831",
"sku_id": "4302217872901",
"spec_id": "0eb631954bfe8fb00a45824fc6193f2f"
}
]
},
"seller_id": "2206619673102",
"sales": 30,
"shop_id": "",
"props_list": {
"0:0": "机身内存:64GB",
"1:0": "颜色:铁灰色",
"1:1": "颜色:瓷白色"
},
"seller_info": {
"nick": "qin多亲科技",
"user_num_id": "2206619673102",
"sid": "b2b-2206619673102e9470",
"title": "深圳多亲科技实力卖场",
"zhuy": "winport.m.1688.com/page/index.…",
"shop_name": "qin多亲科技"
},
"tmall": "",
"data_from": "1688app",
"error": "",
"unit": "部",
"is_support_mix": null,
"mix_amount": null,
"mix_begin": null,
"mix_number": null,
"min_num": "2",
"sales_data": "",
"location": "广东省 深圳市",
"props_img": [],
"sales_info": {
"seller_num": "",
"repeat_rate_purchase": "",
"per_capita_purchases": "",
"comment_num": "",
"comment_url": ""
},
"desc_img": [
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…",
"cbu01.alicdn.com/img/ibank/2…"
],
"shop_item": [],
"relate_items": []
},
"secache": "f75c59301daa3fc1610a8563c998f851",
"secache_time": 1608276252,
"secache_date": "2020-12-18 15:24:12",
"translate_status": "",
"translate_time": 0,
"language": {
"default_lang": "cn",
"current_lang": "cn"
},
"error": "",
"reason": "",
"error_code": "0000",
"cache": 0,
"api_info": "today:12 max:10000",
"execution_time": 6.65,
"server_time": "Beijing/2020-12-18 15:24:17",
"client_ip": "182.111.155.89",
"call_args": {
"num_iid": "610947572360",
"area_id": "440111"
},
"api_type": "1688",
"translate_language": "zh-CN",
"translate_engine": "google_cn",
"server_memory": "4.44MB",
"request_id": "gw-2.5fdc591b3bdb0"
}
API 工具
如何开通API测试,[点击立即开通](console.open.onebound.cn/console/ind…)