一、引言

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调用流程，包含签名生成、请求发送和异常处理。