数据获取系列，1688商品详情API接口
onebound.1688.item_get
公共参数
注册Key和secret测试
名称 |
类型 |
必须 |
描述 |
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版本 |
请求参数
请求参数：num_iid=610947572360
参数说明：num_iid:1688商品ID
sales_data:&sales_data=1 获取近30天成交数据
agent:&agent=1 获取1688分销代发价格数据
响应参数
Version: Date:
名称 |
类型 |
必须 |
示例值 |
描述 |
item |
item[] |
0 |
宝贝详情数据 |
|
num_iid |
String |
0 |
610947572360 |
宝贝ID |
title |
String |
0 |
厂家直销小米有品Qin2 Pro智能手机学生机老人机备用机小爱同学4G |
商品标题 |
desc_short |
String |
0 |
商品简介 |
|
price |
Float |
0 |
799.00 |
价格 |
total_price |
Float |
0 |
0 |
|
suggestive_price |
Float |
0 |
0 |
|
orginal_price |
Float |
0 |
799.00 |
原价 |
nick |
String |
0 |
qin多亲科技 |
卖家昵称 |
num |
Int |
0 |
2191 |
|
detail_url |
String |
0 |
https://detail.1688.com/offer/610947572360.html |
宝贝链接 |
pic_url |
String |
0 |
https://cbu01.alicdn.com/img/ibank/2020/063/830/13235038360_979836901.jpg |
宝贝图片 |
brand |
String |
0 |
MAJE |
品牌 |
brandId |
Int |
0 |
8879363 |
品牌id |
rootCatId |
Int |
0 |
0 |
顶级分类ID |
cid |
Int |
0 |
124264005 |
|
desc |
String |
0 |
||
item_imgs |
Mix |
0 |
item_imgs[] |
商品图片 |
item_weight |
String |
0 |
||
post_fee |
Float |
0 |
9.00 |
邮费 |
express_fee |
Float |
0 |
9.00 |
EMS费用 |
ems_fee |
Float |
0 |
9.00 |
物流费用 |
shipping_to |
String |
0 |
广东广州白云区 |
发货至 |
video |
video[] |
0 |
商品视频 |
|
sample_id |
String |
0 |
||
props_name |
String |
0 |
0:0:机身内存:64GB;1:0:颜色:铁灰色;1:1:颜色:瓷白色 |
商品属性名 |
prop_imgs |
prop_imgs[] |
0 |
商品属性图片列表 |
|
property_alias |
String |
0 |
0:0:64GB;1:0:铁灰色;1:1:瓷白色 |
属性别名 |
props |
Mix |
0 |
[{"name": "品牌", "value": "other"}] |
商品详情 |
total_sold |
Int |
0 |
1 |
|
scale |
Int |
0 |
||
sellUnit |
Int |
0 |
||
skus |
skus[] |
0 |
商品规格信息列表 |
|
seller_id |
Int |
0 |
2206619673102 |
卖家ID |
sales |
Int |
0 |
100 |
销售额 |
shop_id |
Int |
0 |
151372205 |
店铺ID |
props_list |
Mix |
0 |
{"0:0": "机身内存:64GB"} |
商品属性 |
seller_info |
seller_info[] |
0 |
卖家信息 |
|
tmall |
Boolean |
0 |
false |
是否天猫 |
data_from |
String |
0 |
1688app |
错误信息 |
error |
String |
0 |
错误信息 |
|
unit |
String |
0 |
部; |
单位 |
is_support_mix |
Boolean |
0 |
true |
|
mix_amount |
Int |
0 |
30 |
|
mix_Begin |
Int |
0 |
||
mix_number |
Int |
0 |
||
sales_data |
Date |
0 |
||
location |
String |
0 |
广东省 深圳市 |
发货地 |
props_img |
Mix |
0 |
属性图片 |
|
sales_info |
Mix |
0 |
||
desc_img |
Mix |
0 |
[{"https://cbu01.alicdn.com/img/ibank/2020/560/807/14112708065_979836901.jpg"}] |
详情图片列表 |
shop_item |
Mix |
0 |
||
relate_items |
Mix |
0 |
请求示例
Curl
PHP
PHPsdk
JAVA
C#
Python
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/1688/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=610947572360"响应示例
{
"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": "https://detail.1688.com/offer/610947572360.html",
"pic_url": "https://cbu01.alicdn.com/img/ibank/2020/063/830/13235038360_979836901.jpg",
"brand": "",
"brandId": "",
"rootCatId": "",
"cid": "50903",
"desc": "深圳市多亲科技有限公司（简称“多亲科技”)成立于2014年9月是国内领先的人工智能硬件解决方案供应商。多亲科技积极推动人工智能技术的创新研发，在人工智能终端设备、系统软件的研发和生产领域，具有深厚的技术沉淀与实力。
多亲产品销售网络覆盖全国各地乃至远销海外，欢迎企业定制、团购、经销代理。
优质的产品、过硬的技术、完善的服务、是我们合作双赢的开篇。
欢迎有意向者实地考察，垂询电话：13662284449.
温馨提示：
1、可定制--承接各种订单订制！为客户定制机身、开机画面、预装软件、包装等定制！
2、质量保证--本公司专注通讯行业10年，线下线下百花齐放，客户复购率达30%以上。
3、价格实惠--本店是工厂直供，没有中间商差价，一站到客，薄利多销。
4、售后服务--本店出售的所有产品均提供1年的质保。因质量原因退换货（非人为因素）30天内换新。
",
"item_imgs": [
{
"url": "https://cbu01.alicdn.com/img/ibank/2020/063/830/13235038360_979836901.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/2020/445/748/13819847544_979836901.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/2020/487/543/13234345784_979836901.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/2020/296/695/13418596692_979836901.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/2020/167/778/13462877761_979836901.jpg"
}
],
"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": "https://winport.m.1688.com/page/index.html?memberId=b2b-2206619673102e9470",
"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": [
"https://cbu01.alicdn.com/img/ibank/2020/560/807/14112708065_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/303/507/14112705303_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/499/812/14150218994_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/770/128/14199821077_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/588/942/13197249885_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/778/789/13234987877_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/109/489/13234984901_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/156/072/13197270651_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/270/710/13235017072_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/735/999/13234999537_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/549/252/13197252945_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/409/552/13197255904_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/247/935/13278539742_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/355/845/13278548553_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/917/372/13197273719_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/969/099/13234990969_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/175/455/13278554571_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/427/386/13314683724_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/331/365/13278563133_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/654/500/13235005456_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/542/110/13235011245_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/291/020/13235020192_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/329/635/13278536923_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/996/155/13278551699_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/230/920/13235029032_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/464/972/13197279464_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/380/275/13278572083_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/999/462/13197264999_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/868/245/13278542868_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/843/410/13235014348_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/897/200/13235002798_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/914/800/13235008419_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/709/762/13197267907_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/427/545/13278545724_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/741/003/13197300147_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/175/710/13235017571_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/410/485/13278584014_979836901.jpg",
"https://cbu01.alicdn.com/img/ibank/2020/863/665/13278566368_979836901.jpg"
],
"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"
}