一、引言
1688作为国内领先的B2B电商平台，其商品详情API接口为开发者提供了获取商品核心数据的官方通道。通过该接口，开发者可以自动化获取商品标题、价格、库存、规格参数等关键信息，广泛应用于电商系统开发、数据分析、供应链管理等场景。相比传统爬虫方案，官方API具有数据完整、调用稳定、合法合规等优势，特别适合企业级应用开发。
二、接口概述
1. 核心功能
基础信息获取：商品ID、标题、类目、品牌等基础属性。
价格体系：批发价、阶梯价格、建议零售价等。
库存状态：实时库存数量、起订量(MOQ)等。
多媒体信息：主图、详情图、3D模型及视频链接。
供应商数据：工厂资质、所在地、成立年限等。
2. 请求参数
参数名必填说明
offer_id是商品唯一标识
fields否指定返回字段，默认返回全部
include_sku否是否返回完整SKU信息
language否返回语言(zh_CN/en)
三、Python代码示例
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调用流程，包含签名生成、请求发送和异常处理。