电商API接口趋势，响应示例，参数说明_接口响应示例-优快云博客

本文链接：https://blog.youkuaiyun.com/api_Anzexi/article/details/128646017

本文介绍了如何通过1688商品API接口获取商品详细信息，包括商品标题、价格、主图等，并展示了接口的调用方式、请求参数和响应示例，适用于返利系统、ERP、OMS等业务场景。接口采用RESTful设计，支持多种编程语言，优化了抓取速度和稳定性。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

很多电商系统，如返利系统、ERP、OMS软件等，需要通过商品API接口获取商品详情信息，来满足业务场景需要。具体包括：商品的标题、价格、SKU、主图、评价等维度信息。

重点优化了抓取速度、及抓取稳定性，接口REST方式进行调用，支持Java、php、python等主流编程语言。

onebound.1688.item_get

公共参数

首先注册key和secret:https://console.open.onebound.cn/console/index.php?i=Anzexi

名称	类型	必须	描述
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

PHPsdk

JAVA

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": "<div id=\"offer-template-0\"></div>深圳市多亲科技有限公司（简称“多亲科技”)成立于2014年9月是国内领先的人工智能硬件解决方案供应商。多亲科技积极推动人工智能技术的创新研发，在人工智能终端设备、系统软件的研发和生产领域，具有深厚的技术沉淀与实力。         多亲产品销售网络覆盖全国各地乃至远销海外，欢迎企业定制、团购、经销代理。        优质的产品、过硬的技术、完善的服务、是我们合作双赢的开篇。        欢迎有意向者实地考察，垂询电话：13662284449. 温馨提示：1、可定制--承接各种订单订制！为客户定制机身、开机画面、预装软件、包装等定制！ 2、质量保证--本公司专注通讯行业10年，线下线下百花齐放，客户复购率达30%以上。 3、价格实惠--本店是工厂直供，没有中间商差价，一站到客，薄利多销。 4、售后服务--本店出售的所有产品均提供1年的质保。因质量原因退换货（非人为因素）30天内换新。 <img alt=\"undefined\" height=\"446.22866894197955\" src=\"https://cbu01.alicdn.com/img/ibank/2020/560/807/14112708065_979836901.jpg\" width=\"790\" /> <img alt=\"undefined\" height=\"457.5154730327144\" src=\"https://cbu01.alicdn.com/img/ibank/2020/303/507/14112705303_979836901.jpg\" width=\"790\" /> <img alt=\"undefined\" height=\"443.2365499573014\" src=\"https://cbu01.alicdn.com/img/ibank/2020/499/812/14150218994_979836901.jpg\" width=\"790\" /> <img alt=\"undefined\" height=\"440.350569675723\" src=\"https://cbu01.alicdn.com/img/ibank/2020/770/128/14199821077_979836901.jpg\" width=\"790\" /> <img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/588/942/13197249885_979836901.jpg\" /><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/778/789/13234987877_979836901.jpg\" /> <img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/109/489/13234984901_979836901.jpg\" /> <img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/156/072/13197270651_979836901.jpg\" /> <img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/270/710/13235017072_979836901.jpg\" /> <img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/735/999/13234999537_979836901.jpg\" /> <img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/549/252/13197252945_979836901.jpg\" /> <img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/409/552/13197255904_979836901.jpg\" /> <img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/247/935/13278539742_979836901.jpg\" /> <img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/355/845/13278548553_979836901.jpg\" /> <img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/917/372/13197273719_979836901.jpg\" /> <img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/969/099/13234990969_979836901.jpg\" /> <img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/175/455/13278554571_979836901.jpg\" /><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/427/386/13314683724_979836901.jpg\" /> <img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/331/365/13278563133_979836901.jpg\" /> <img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/654/500/13235005456_979836901.jpg\" /> <img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/542/110/13235011245_979836901.jpg\" /> <img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/291/020/13235020192_979836901.jpg\" /> <img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/329/635/13278536923_979836901.jpg\" /> <img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/996/155/13278551699_979836901.jpg\" /><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/230/920/13235029032_979836901.jpg\" /> <img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/464/972/13197279464_979836901.jpg\" /> <img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/380/275/13278572083_979836901.jpg\" /> <img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/999/462/13197264999_979836901.jpg\" /> <img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/868/245/13278542868_979836901.jpg\" /> <img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/843/410/13235014348_979836901.jpg\" /> <img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/897/200/13235002798_979836901.jpg\" /> <img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/914/800/13235008419_979836901.jpg\" /> <img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/709/762/13197267907_979836901.jpg\" /> <img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/427/545/13278545724_979836901.jpg\" /> <img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/741/003/13197300147_979836901.jpg\" /> <img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/175/710/13235017571_979836901.jpg\" /> <img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/410/485/13278584014_979836901.jpg\" /> <img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/863/665/13278566368_979836901.jpg\" /> ",

"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"

}