1688商品详情API接口深度解析

web3.08889992026-01-09 9:07

一、前言

1688作为国内主流B2B电商平台，其商品详情API（item_get接口）支持通过商品ID获取标题、价格、库存、SKU等核心数据，适用于价格监控、供应链管理、数据分析等场景。该接口返回JSON格式数据，需通过企业资质认证获取调用权限。

二、接口概述

核心功能

基础信息：商品标题、类目、品牌。

动态数据：实时价格、库存量、近30天成交记录。

多媒体：主图URL、详情图列表、视频链接。

批发属性：阶梯价格。

2.关键节点：

用 XPath/CSS 提取标题、价格（示例：//h1[@class="detail-title"]/text()）
解析 SKU 数据（页面 JSON：window.__detail_data__.offerResult）
详情页富文本

三、Python请求示例

复制代码

# coding:utf-8

""" Compatible for python2.x and python3.x requirement: pip install requests """

from __future__ import print_function

import requests

# 配置参数 API_URL = "o0b.cn/ibrad"

app_key = "YOUR_APP_KEY" q = "衣服" # 目标关键词

# 请求示例 url 默认请求参数已经做URL编码 url = "1688/item_search/?key=<您自己的apiKey>&&q=女装&page=1&sort=&price_range=" headers = { "Accept-Encoding": "gzip", "Connection": "close" } if __name__ == "__main__": r = requests.get(url, headers=headers) json_obj = r.json() print(json_obj)

四：代码说明

1.使用requests库发送HTTP GET请求，按1688规范生成签名。

2.必填参数包括app_key和商品ID。

3.通过fields控制返回数据字段，减少带宽消耗。

4.部分商品无批发价（wholesale_price 为 null），需做异常处理

5.详情页 HTML 可能包含阿里 CDN 图片，直接引用即可（无需额外解析）