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 规格、卖家及物流信息。结合缓存和异常处理,可构建稳定的商品数据获取链路,适用于反向海淘、采购比价、供应商监控等场景。