1688 商品详情 API可实时获取商品标题、价格、规格、库存等核心数据， API 的实时数据解析完整示例，包含接口调用、数据提取及字段说明，确保精准获取并解析 1688 商品详情。
一、1688 商品详情 API 基础信息
1. 接口核心能力
通过商品 ID（num_iid）获取商品详情，支持实时返回：
接口名称：1688.item_get
-
商品基本信息（标题、主图、详情描述）
-
价格信息（批发价、起订量、阶梯价格）
-
SKU 规格（颜色、尺寸、对应价格 / 库存）
-
卖家信息（店铺名称、地址、资质）
-
物流信息（发货地、运费模板）
-
创建应用，获取
app_key和app_secret
二、API 调用与数据解析完整示例（Python）
1. 接口调用代码（含签名生成）
# coding:utf-8
"""
Compatible for python.x and python.2x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 配置参数
API_URL = "o0b.cn/ibrad， wechat id: TaoxiJd-api "
app_key = "YOUR_APP_KEY" num_id = "123456789" # 目标商品ID
# 请求示例 url 默认请求参数已经做URL编码
url = "taobao/item_get/?key=<您自己的apiKey>&num_iid=123456789&is_promotion=1"
headers = {
"Accept-Encoding": "gzip",
"Connection": "close"
}
if __name__ == "__main__":
r = requests.get(url, headers=headers)
json_obj = r.json()
print(json_obj)
2. 解析结果示例（JSON 格式）
{
"basic_info": {
"num_iid": "123456789",
"title": "2024夏季新款纯棉T恤男女同款宽松百搭打底衫",
"main_image": "https://img.alicdn.com/imgextra/i1/123456789/O1CN01abcdefg_20240501.jpg",
"description": "<p>纯棉材质，透气舒适...</p>", // HTML格式详情
"original_price": "59.00",
"current_price": "39.00"
},
"sku_list": [
{
"sku_id": "12345678901",
"spec": "{"颜色":"白色","尺寸":"M"}",
"price": "39.00",
"stock": 1200,
"image": "https://img.alicdn.com/imgextra/i2/123456789/O1CN01hijklm_20240501.jpg"
},
{
"sku_id": "12345678902",
"spec": "{"颜色":"黑色","尺寸":"L"}",
"price": "42.00",
"stock": 850,
"image": "https://img.alicdn.com/imgextra/i3/123456789/O1CN01nopqrs_20240501.jpg"
}
],
"seller_info": {
"seller_id": "abc123",
"seller_name": "XX服饰有限公司",
"address": "广东省广州市白云区"
},
"shipping_info": {
"shipping_from": "广东广州",
"freight": "满200元包邮，不足收取8元运费"
}
}
四、关键解析逻辑说明
字段映射：1688 API 返回的字段需按需提取，核心关注：
-
method：接口方法名，如1688.union.open.goods.query。
-
pageIndex/pageNo：页码(从1开始)。
-
pageSize：每页商品数量(建议20-50条)。
-
sortType：排序方式(1-价格升序,2-价格降序,3-销量排序等)。
-
keyword：搜索关键词。
-
timestamp：请求时间戳。
五、总结
该示例封装了1688 API 可合规获取商品详情实时数据，解析时需重点提取基础信息、SKU 规格、卖家及物流信息。结合缓存和异常处理，可构建稳定的商品数据获取链路，适用于反向海淘、采购比价、供应商监控等场景。
