当前位置：首页 > news >正文

1688 商品详情接口数据全解析（1688.item_get）

news 2025/8/22 14:06:32

一、引言

1688 作为国内知名的 B2B 电商平台，拥有海量的商品资源。其提供的商品详情接口（1688.item_get）能够让开发者方便地获取商品的详细信息，如商品标题、价格、规格、库存等。这对于电商平台开发、数据分析、商品比价等应用场景具有重要意义。本文将详细介绍 1688 商品详情接口的数据结构、调用流程及使用示例。

二、接口功能

1688 商品详情接口的主要功能是提供实时的商品详细数据获取。通过该接口，开发者可以获取到商品的以下信息：

商品基本信息：包括商品 ID、标题、价格、库存等。
图片信息：包含商品的主图、详情图等图片链接。
规格参数：商品的颜色、尺寸、材质等规格参数。
销售数据：如销量、评价等，反映商品的市场表现。
关联信息：相似商品推荐、关联搭配等信息。

三、接口调用流程

要使用 1688 商品详情接口，需要遵循以下步骤：

注册账号：在 1688 开放平台注册账号，获得 API 密钥。
获取 API 密钥：创建应用后，系统会生成 API 密钥，这是身份验证的重要依据。
查阅 API 文档：详细阅读官方提供的 API 文档，了解接口的详细说明、请求参数、返回值以及使用示例。
构建请求 URL：根据需要获取的商品详情信息，构建合适的请求 URL。
发送 HTTP 请求：使用合适的 HTTP 客户端库发送 HTTP 请求，并处理响应数据。

四、请求参数

以下是 1688 商品详情接口的必填和可选请求参数：

app_key：必填参数，用于标识应用程序，需向 1688 申请唯一的 app_key。
format：必填参数，返回数据的格式，通常为 json。
timestamp：必填参数，请求的时间戳，防止请求被缓存或重复执行。
nonce：必填参数，随机字符串，用于增加请求的安全性。
sign_method：必填参数，签名方法，目前仅支持 RSA 签名方法。
sign：必填参数，签名结果，确保请求的安全性，防止被篡改。
access_id：必填参数，1688 分配给每个开发者的唯一标识符。
fields：可选参数，商品详情页需要展示的字段，如商品名称、价格、库存、图片等，可根据需要选择。
key 或 num_iid：可选参数，商品的 key 值或 ID，用于指定获取哪个商品的详情信息。
sales_data：可选参数，设置为 1 时可获取近 30 天成交数据。
agent：可选参数，设置为 1 时可获取 1688 分销代发价格数据。

五、返回结果

成功调用接口后，将收到一个包含商品详情的 JSON 响应，响应中包含的字段与请求参数中 fields 指定的字段相对应。以下是一些常见的返回字段：

num_iid：商品 ID。
title：商品名称。
desc_short：商品简短描述。
price：商品价格。
total_price：商品总价。
suggestive_price：建议价格。
original_price：原价。
nick：卖家昵称。
num：商品库存数量。
detail_url：商品详情页的 URL。
pic_url：商品图片的 URL。
brand：品牌名称。
brandid：品牌 ID。
rootcatid：根类目 ID。
cid：类目 ID。
desc：商品详细描述。
item_imgs：商品图片列表。
item_weight：商品重量。
post_fee：邮费。
express_fee：快递费。
ems_fee：EMS 费。
shipping_to：发货地。
video：商品视频。
sample_id：样品 ID。
props_name：商品属性名称。
prop_imgs：属性图片。
property_alias：属性别名。
props：商品属性列表。

六、Python 调用示例

以下是一个使用 Python 调用 1688 商品详情接口的示例代码：

import requests
import hashlib
import time
import urllib.parse# 1688 开放平台的 app_key 和 app_secret
app_key = 'your_app_key'
app_secret = 'your_app_secret'# 商品 ID
num_iid = '123456789'# 构造请求参数
params = {'app_key': app_key,'format': 'json','timestamp': time.strftime('%Y-%m-%d %H:%M:%S', time.localtime()),'nonce': hashlib.md5(str(time.time()).encode()).hexdigest(),'sign_method': 'md5','num_iid': num_iid,'fields': 'num_iid,title,price,num,desc,pic_url'
}# 对参数进行排序并拼接
sorted_params = sorted(params.items(), key=lambda x: x[0])
query_string = urllib.parse.urlencode(sorted_params)# 计算签名
sign = hashlib.md5((app_secret + query_string + app_secret).encode()).hexdigest().upper()
params['sign'] = sign# 发送请求
url = 'https://api.1688.com/item/get_item_detail.do'
response = requests.get(url, params=params)# 输出响应内容
print(response.json())

在上述代码中，需要将 your_app_key 和 your_app_secret 替换为实际的 1688 开放平台的 app_key 和 app_secret。同时，根据需要获取的商品详情信息，可以调整 fields 参数的值。

七、注意事项

权限管理：在使用接口之前，需要确保已经申请了相应的 API 调用权限。部分接口可能需要经过阿里巴巴的审核和授权。
调用频率限制：1688 平台对 API 接口的调用频率有一定的限制。开发者需要合理安排接口调用的频率，避免因调用过于频繁而被限制服务。
数据异常处理：在接口调用过程中，可能会遇到各种数据异常情况。开发者需要在代码中添加适当的异常处理逻辑，确保程序的稳定运行。
数据安全：在使用接口时，要确保数据的安全性。不要将敏感信息（如 app_secret）泄露给他人。同时，要遵守 1688 平台的相关规定，确保合法合规地使用接口。