一、引言
1688作为国内领先的B2B电商平台，其商品详情API接口为开发者提供了获取商品核心数据的官方通道。通过该接口，开发者可以自动化获取商品标题、价格、库存、规格参数等关键信息，广泛应用于电商系统开发、数据分析、供应链管理等场景。相比传统爬虫方案，官方API具有数据完整、调用稳定、合法合规等优势，特别适合企业级应用开发。
二、接口概述
1. 核心功能
- 基础信息获取：商品ID、标题、类目、品牌等基础属性。
- 价格体系：批发价、阶梯价格、建议零售价等。
- 库存状态：实时库存数量、起订量(MOQ)等。
- 多媒体信息：主图、详情图、3D模型及视频链接。
- 供应商数据：工厂资质、所在地、成立年限等。
2. 请求参数
| 参数名 | 必填 | 说明 |
|---|---|---|
offer_id | 是 | 商品唯一标识 |
fields | 否 | 指定返回字段，默认返回全部 |
include_sku | 否 | 是否返回完整SKU信息 |
language | 否 | 返回语言(zh_CN/en) |
三、Python代码示例
# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 请求示例 url 默认请求参数已经做URL编码
API url=c0b.cc/R4rbK2 wechat id:Taobaoapi2014
url = "1688/item_get/?key=<您自己的apiKey>&num_iid=123456"
headers = {
"Accept-Encoding": "gzip",
"Connection": "close"
}
if __name__ == "__main__":
r = requests.get(url, headers=headers)
json_obj = r.json()
print(json_obj)
代码说明：该示例展示了完整的API调用流程，包含签名生成、请求发送和异常处理。
