-
使用1688开放平台API接口获取商品详情信息
摘要：本文将介绍如何使用1688开放平台的API接口来获取商品详情信息。通过调用这些接口，您可以方便地获取商品的基本信息、价格、库存等数据，为您的业务提供强大的支持。
一、API接口简介
1688开放平台提供了丰富的API接口，帮助开发者快速实现各种业务需求。其中，商品详情信息的获取是很多业务场景中的基础功能。通过调用相应的API接口，您可以获取到商品的基本信息、价格、库存等数据，为您的业务提供强大的支持。
二、API接口请求方式
1688开放平台的API接口采用了RESTful设计风格，您可以通过HTTP协议的GET和POST方法来调用这些接口。为了确保数据的安全性，建议您使用HTTPS协议进行请求。
三、获取商品详情信息的API接口
要获取商品详情信息，您需要调用以下API接口：
- 商品详细信息查询接口（product_get）：通过商品ID获取商品的详细信息。
- 商品属性查询接口（product_attribute_get）：通过商品ID和属性ID获取商品的属性值。
- 商品图片查询接口（product_image_get）：通过商品ID和图片类型获取商品的图片信息。
四、API接口参数说明
1688.item_get
公共参数
名称
类型
必须
描述
key
String
是
调用key（前往获取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=555696089192
参数说明：num_iid:1688商品ID
sales_data:&sales_data=1 获取近30天成交数据
agent:&agent=1 获取1688分销代发价格数据响应参数
Version: Date:
名称
类型
必须
示例值
描述
item
item[]
0
宝贝详情数据
num_iid
String
0
宝贝ID
title
String
0
商品标题
desc_short
String
0
商品简介
price
Float
0
价格
total_price
Float
0
suggestive_price
Float
0
orginal_price
Float
0
原价
nick
String
0
卖家昵称
num
Int
0
detail_url
String
0
宝贝链接
pic_url
String
0
宝贝图片
brand
String
0
品牌
brandId
Int
0
品牌id
rootCatId
Int
0
顶级分类ID
cid
Int
0
desc
String
0
item_imgs
Mix
0
商品图片
item_weight
String
0
post_fee
Float
0
邮费
express_fee
Float
0
EMS费用
ems_fee
Float
0
物流费用
shipping_to
String
0
发货至
video
video[]
0
商品视频
sample_id
String
0
props_name
String
0
商品属性名
prop_imgs
prop_imgs[]
0
商品属性图片列表
property_alias
String
0
属性别名
props
Mix
0
商品详情
total_sold
Int
0
scale
Int
0
sellUnit
Int
0
skus
skus[]
0
商品规格信息列表
seller_id
Int
0
卖家ID
sales
Int
0
销售额
shop_id
Int
0
店铺ID
props_list
Mix
0
商品属性
seller_info
seller_info[]
0
卖家信息
tmall
Boolean
0
是否天猫
data_from
String
0
错误信息
error
String
0
错误信息
unit
String
0
单位
is_support_mix
Boolean
0
mix_amount
Int
0
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
详情图片列表
shop_item
Mix
0
relate_items
Mix
0
五、API接口返回结果示例
- 商品详细信息查询接口（product_get）返回结果示例：
- Result Object:
- ---------------------------------------
- {
- "item": {
- "num_iid": "555696089192",
- "title": "秋冬中长款毛衣套头女韩版宽松蝙蝠袖针织衫加厚外套高领冬季女装",
- "desc_short": "",
- "price": "65.00",
- "total_price": 0,
- "suggestive_price": 0,
- "orginal_price": "65.00",
- "nick": "彤彤毛衫工厂店",
- "num": "5111",
- "min_num": "1",
- "detail_url": "https://detail.1688.com/offer/555696089192.html",
- "pic_url": "https://cbu01.alicdn.com/img/ibank/2020/194/896/20708698491_1110747443.jpg",
- "brand": "",
- "brandId": "",
- "rootCatId": "10166",
- "cid": "127386001",
- "crumbs": [],
- "created_time": "",
- "modified_time": "",
- "delist_time": "",
- "desc": "offer-template-0\">\r\n
0\" cellpadding=\"0\" cellspacing=\"0\" >\r\n\r\n
\r\n\r\n\r\n \r\n3\">\r\n \r\n店铺推荐\r\nhttps://img.alicdn.com/imgextra/i4/36030596/TB2wVmOXi2mJKJjy0FhXXckoXXa-36030596.png\" width=\"25%\"/>
\r\n \r\n\r\n \r\n0\" cellpadding=\"0\" cellspacing=\"0\" >\r\n\r\n
\r\n\r\n \r\ncenter\"> \r\n\r\n \r\n\r\ncenter\" >抢购价￥55.00 \r\n\r\n \r\n0\" cellpadding=\"0\" cellspacing=\"0\" >\r\n\r\n
\r\n\r\n \r\ncenter\"> \r\n\r\n \r\n\r\ncenter\" >抢购价￥65.00 \r\n\r\n \r\n0\" cellpadding=\"0\" cellspacing=\"0\" >\r\n\r\n
\r\n\r\n \r\ncenter\"> \r\n\r\n \r\n\r\ncenter\" >抢购价￥55.00 \r\n\r\n \r\n\r\n \r\n0\" cellpadding=\"0\" cellspacing=\"0\" >\r\n\r\n
\r\n\r\n \r\ncenter\"> \r\n\r\n \r\n\r\ncenter\" >抢购价￥68.00 \r\n\r\n \r\n0\" cellpadding=\"0\" cellspacing=\"0\" >\r\n\r\n
\r\n\r\n \r\ncenter\"> \r\n\r\n \r\n\r\ncenter\" >抢购价￥62.00 \r\n\r\n \r\n0\" cellpadding=\"0\" cellspacing=\"0\" >\r\n\r\n
\r\n\r\n \r\ncenter\"> \r\n\r\n \r\n\r\ncenter\" >抢购价￥60.00 \r\n\r\n \r\n\r\n\r\n \r\n0\" cellpadding=\"0\" cellspacing=\"0\" >\r\n\r\n
\r\n\r\n \r\ncenter\"> \r\n\r\n \r\n\r\ncenter\" >抢购价￥63.00 \r\n\r\n \r\n0\" cellpadding=\"0\" cellspacing=\"0\" >\r\n\r\n
\r\n\r\n \r\ncenter\"> \r\n\r\n \r\n\r\ncenter\" >抢购价￥62.00 \r\n\r\n \r\n0\" cellpadding=\"0\" cellspacing=\"0\" >\r\n\r\n
\r\n\r\n \r\ncenter\"> \r\n\r\n \r\n\r\ncenter\" >抢购价￥63.00 \r\n\r\n\r\n\r\n\r\n - "desc_img": [
- "https://img.alicdn.com/imgextra/i4/36030596/TB2wVmOXi2mJKJjy0FhXXckoXXa-36030596.png",
- "https://cbu01.alicdn.com/img/ibank/2020/228/579/19656975822_1110747443.310x310.jpg",
- "https://img.alicdn.com/imgextra/i4/36030596/TB2wVmOXi2mJKJjy0FhXXckoXXa-36030596.png",
- "https://cbu01.alicdn.com/img/ibank/2019/804/385/12464583408_1110747443.310x310.jpg",
- "https://img.alicdn.com/imgextra/i4/36030596/TB2wVmOXi2mJKJjy0FhXXckoXXa-36030596.png",
- "https://cbu01.alicdn.com/img/ibank/2018/873/001/9261100378_1961146388.310x310.jpg",
- "https://img.alicdn.com/imgextra/i4/36030596/TB2wVmOXi2mJKJjy0FhXXckoXXa-36030596.png",
- "https://cbu01.alicdn.com/img/ibank/2019/126/974/12313479621_1110747443.310x310.jpg",
- "https://img.alicdn.com/imgextra/i4/36030596/TB2wVmOXi2mJKJjy0FhXXckoXXa-36030596.png",
- "https://cbu01.alicdn.com/img/ibank/2020/488/754/20495457884_1110747443.310x310.jpg",
- "https://img.alicdn.com/imgextra/i4/36030596/TB2wVmOXi2mJKJjy0FhXXckoXXa-36030596.png",
- "https://cbu01.alicdn.com/img/ibank/2020/956/251/20430152659_1110747443.310x310.jpg",
- "https://img.alicdn.com/imgextra/i4/36030596/TB2wVmOXi2mJKJjy0FhXXckoXXa-36030596.png",
- "https://cbu01.alicdn.com/img/ibank/2020/426/727/22450727624_1110747443.310x310.jpg",
- "https://img.alicdn.com/imgextra/i4/36030596/TB2wVmOXi2mJKJjy0FhXXckoXXa-36030596.png",
- "https://cbu01.alicdn.com/img/ibank/2020/194/896/20708698491_1110747443.310x310.jpg",
- "https://img.alicdn.com/imgextra/i4/36030596/TB2wVmOXi2mJKJjy0FhXXckoXXa-36030596.png",
- "https://cbu01.alicdn.com/img/ibank/O1CN01uWZKGY1MJCH63kqJf_!!6000000001413-0-cib.310x310.jpg",
- "https://img.alicdn.com/imgextra/i4/36030596/TB2wVmOXi2mJKJjy0FhXXckoXXa-36030596.png",
- "https://cbu01.alicdn.com/img/ibank/2020/043/884/20632488340_1110747443.jpg",
- "https://cbu01.alicdn.com/img/ibank/2020/273/107/20708701372_1110747443.jpg",
- "https://cbu01.alicdn.com/img/ibank/2020/919/764/20632467919_1110747443.jpg",
- "https://cbu01.alicdn.com/img/ibank/2020/194/896/20708698491_1110747443.jpg",
- "https://cbu01.alicdn.com/img/ibank/2020/188/186/20789681881_1110747443.jpg",
- "https://cbu01.alicdn.com/img/ibank/2020/588/464/20632464885_1110747443.jpg",
- "https://cbu01.alicdn.com/img/ibank/2020/162/194/20632491261_1110747443.jpg",
- "https://cbu01.alicdn.com/img/ibank/2020/898/674/20632476898_1110747443.jpg",
- "https://cbu01.alicdn.com/img/ibank/2020/774/717/20789717477_1110747443.jpg",
- "https://cbu01.alicdn.com/img/ibank/2020/780/005/20632500087_1110747443.jpg",
- "https://cbu01.alicdn.com/img/ibank/2020/390/227/20708722093_1110747443.jpg",
- "https://cbu01.alicdn.com/img/ibank/2020/189/686/20708686981_1110747443.jpg",
- "https://cbu01.alicdn.com/img/ibank/2019/424/441/12783144424_1110747443.jpg",
- "https://cbu01.alicdn.com/img/ibank/2019/617/080/12821080716_1110747443.jpg"
- ],
- "item_imgs": [
- {
- "url": "https://cbu01.alicdn.com/img/ibank/2020/194/896/20708698491_1110747443.jpg"
- },
- {
- "url": "https://cbu01.alicdn.com/img/ibank/2020/162/194/20632491261_1110747443.jpg"
- },
- {
- "url": "https://cbu01.alicdn.com/img/ibank/2020/774/717/20789717477_1110747443.jpg"
- },
- {
- "url": "https://cbu01.alicdn.com/img/ibank/2020/898/674/20632476898_1110747443.jpg"
- },
- {
- "url": "https://cbu01.alicdn.com/img/ibank/O1CN01xJUT56253lrhwwoz5_!!2669477471-0-cib.jpg"
- }
- ],
- "item_weight": "",
- "item_size": "",
- "location": "浙江省嘉兴市",
- "post_fee": 4,
- "express_fee": "",
- "ems_fee": "",
- "shipping_to": "",
- "has_discount": "",
- "video": "https://cloud.video.taobao.com/play/u/2669477471/p/2/e/6/t/1/418132488730.mp4",
- "is_virtual": "",
- "sample_id": "",
- "is_promotion": "",
- "props_name": "0:0:颜色:红色;0:1:颜色:黑色;1:0:尺码:一件可拍 均码",
- "prop_imgs": {
- "prop_img": [
- {
- "properties": "0:0",
- "url": "https://cbu01.alicdn.com/img/ibank/2020/194/896/20708698491_1110747443.jpg"
- },
- {
- "properties": "0:1",
- "url": "https://cbu01.alicdn.com/img/ibank/2020/898/674/20632476898_1110747443.jpg"
- }
- ]
- },
- "property_alias": "0:0:红色;0:1:黑色;1:0:一件可拍 均码",
- "props": [
- {
- "name": "货号",
- "show": false,
- "value": "HH-158-100"
- },
- {
- "name": "面料名称",
- "show": false,
- "value": "针织混纺"
- },
- {
- "name": "主面料成分2",
- "show": false,
- "value": "聚酯纤维（涤纶）"
- },
- {
- "name": "主面料成分",
- "show": false,
- "value": "腈纶"
- },
- {
- "name": "图案",
- "show": false,
- "value": "纯色"
- },
- {
- "name": "厚薄",
- "show": false,
- "value": "厚"
- },
- {
- "name": "组合形式",
- "show": false,
- "value": "单件"
- },
- {
- "name": "款式",
- "show": false,
- "value": "套头"
- },
- {
- "name": "版型",
- "show": false,
- "value": "宽松型"
- },
- {
- "name": "袖型",
- "show": false,
- "value": "常规袖"
- },
- {
- "name": "上市年份/季节",
- "show": false,
- "value": "2023年秋季"
- },
- {
- "name": "领型",
- "show": false,
- "value": "圆领"
- },
- {
- "name": "袖长",
- "show": false,
- "value": "长袖"
- },
- {
- "name": "流行元素",
- "show": false,
- "value": "螺纹"
- },
- {
- "name": "衣长",
- "show": false,
- "value": "中长款(65cm<衣长≤80cm)"
- },
- {
- "name": "工艺",
- "show": false,
- "value": "拼贴/拼接"
- },
- {
- "name": "颜色",
- "show": false,
- "value": "红色,黑色"
- },
- {
- "name": "尺码",
- "show": false,
- "value": "一件可拍 均码"
- },
- {
- "name": "风格类型",
- "show": false,
- "value": "气质通勤"
- },
- {
- "name": "穿着方式",
- "show": false,
- "value": "套头"
- },
- {
- "name": "主面料成分含量",
- "show": false,
- "value": "50%（不含）-70%（含）"
- },
- {
- "name": "门襟",
- "show": false,
- "value": "套头"
- },
- {
- "name": "风格",
- "show": false,
- "value": "英伦风"
- },
- {
- "name": "是否跨境货源",
- "show": false,
- "value": "否"
- }
- ],
- "total_sold": null,
- "skus": {
- "sku": [
- {
- "price": "65.00",
- "total_price": 0,
- "sales": "4297",
- "properties": "0:0;1:0",
- "properties_name": "0:0:颜色:红色;1:0:尺码:一件可拍 均码",
- "quantity": "1589",
- "sku_id": "4730262673752",
- "spec_id": "5662a10e8283586509b22afca62d332b"
- },
- {
- "price": "65.00",
- "total_price": 0,
- "sales": "2362",
- "properties": "0:1;1:0",
- "properties_name": "0:1:颜色:黑色;1:0:尺码:一件可拍 均码",
- "quantity": "3522",
- "sku_id": "4730262673753",
- "spec_id": "7cb4420f14f7a9ae00c0255d75ff75b4"
- }
- ]
- },
- "seller_id": "2669477471",
- "sales": 1790,
- "shop_id": "2669477471",
- "props_list": {
- "0:0": "颜色:红色",
- "0:1": "颜色:黑色",
- "1:0": "尺码:一件可拍 均码"
- },
- "seller_info": {
- "nick": "彤彤毛衫工厂店",
- "user_num_id": "2669477471",
- "sid": "b2b-266947747195f05",
- "title": "嘉兴市秀洲区洪合镇美彤服装厂",
- "zhuy": "https://winport.m.1688.com/page/index.html?memberId=b2b-266947747195f05",
- "shop_name": "彤彤毛衫工厂店"
- },
- "tmall": "false",
- "error": "",
- "warning": "",
- "url_log": [],
- "unit": null,
- "is_support_mix": "true",
- "mix_amount": "1",
- "mix_begin": "0",
- "mix_number": "2147483647",
- "scale": "",
- "sellUnit": "件",
- "props_img": {
- "0:0": "https://cbu01.alicdn.com/img/ibank/2020/194/896/20708698491_1110747443.jpg",
- "0:1": "https://cbu01.alicdn.com/img/ibank/2020/898/674/20632476898_1110747443.jpg"
- },
- "sales_data": null,
- "priceRange": [
- [
- "1",
- "65.00"
- ],
- [
- "10",
- "64.00"
- ],
- [
- "50",
- "62.00"
- ]
- ],
- "priceRangeOriginal": [],
- "_ddf": "ti",
- "sales_info": {
- "seller_num": "",
- "repeat_rate_purchase": "",
- "per_capita_purchases": "",
- "comment_num": "",
- "comment_url": ""
- },
- "format_check": "ok",
- "shop_item": [],
- "relate_items": []
- },
- "error": "",
- "secache": "95fc21debe6c629e941d808b214a3b07",
- "secache_time": 1700458640,
- "secache_date": "2023-11-20 13:37:20",
- "translate_status": "",
- "translate_time": 0,
- "language": {
- "default_lang": "cn",
- "current_lang": "cn"
- },
- "reason": "",
- "error_code": "0000",
-
相关阅读:
基于session实现发送短信和验证码登录注册功能
在Mac M2本地注册GitLab runner
Android12 OTA编译差分包报错问题
以太网交换机自学习、转发帧的流程
CSS垂直居中的方法
财务体验/看透人生穷富的关键
本地如何使用HTTPS进行调试
对于产业互联网的认识，直接关系着我们究竟会以怎样的心态来看待它
SSM二手交易网站
Vite前端构建工具详解
- 原文地址：https://blog.csdn.net/WBKJ_Noah/article/details/134505817
