欢迎来到我的博客

JD商品详情 API 接口 ——JD.item_get 完整解析

Thu, 16 Apr 2026 15:16:14 +0800

一、前言

京东开放平台的 JD.item_get 接口全流程解析，包含核心参数、标准返回结构、开发落地要点、常见错误处理，可直接用于数据采集、解析与入库。

二、接口概述

1. 核心接口信息

项⽬说明

接口名称商品详情查询（JD.item_get）

请求方式GET/POST（推荐 POST，避免参数暴露）

接口地址正式环境：http://o0b.cn/ibrad (前往体验接口测试， TaoxiJd-api 添加V获取）。

响应格式JSON

三、核心请求参数（必填 + 可选）

1. 必传参数

参数名	类型	说明	示例
app_key	String	京东开放平台分配的应用 ID	23456789abcdef
method	String	固定接口名，值为 jingdong.item.read.get	jingdong.item.read.get
item_id	String	商品 SKU ID（从商品 URL 提取，如 http://item.jd.com/100012345678.html 中的 100012345678）	100012345678
timestamp	String	时间戳，格式为 yyyy-MM-dd HH:mm:ss（需与服务器时间一致，避免签名失效）	2026-04-16 15:20:00
v	String	接口版本号，固定值 2.0	2.0
sign	String	签名（按规则生成，防止参数篡改）	3F2A1B...（MD5 加密后字符串）

四. 可选参数（优化请求）

参数名类型说明

app_keyString京东开放平台分配的应用 ID（创建应用后获取）

methodString接口方法名，固定值：jingdong.item.get

access_tokenString用户授权令牌（无需用户授权的场景可传空，需提前配置应用权限）

item_idString京东商品 ID（商品详情页 URL 中http://item.jd.com/xxxx.html的xxxx部分）

timestampString时间戳（格式：yyyy-MM-dd HH:mm:ss，如 2026-01-14 10:00:00）

vString接口版本号，固定值：2.0

signString接口签名（根据 appsecret + 参数拼接加密生成，京东有固定签名规则）

五. 接口核心信息

项目	详情
接口名称	JD.item_get（官方标准名：jingdong.item.read.get）
核心功能	通过商品 SKU ID 获取京东商品全量详情（价格、库存、SKU 规格、图片、销量、店铺信息等）
请求方式	推荐 POST（避免参数暴露），支持 GET
响应格式	JSON
数据时效	分钟级更新，与京东主站同步
适用场景	电商比价、商品监控、选品分析、代购数据采集

总结

调用京东商品详情 API 的核心是获取有效的app_key/app_secret，并按规则生成sign签名；

Python 请求示例中，签名生成、参数构造、异常处理是保证接口调用成功的关键；

使用 API 时需遵守平台规范，优先做缓存优化，避免接口封禁或调用成本过高。

闲鱼商品详情API数据解析

Tue, 14 Apr 2026 10:15:35 +0800

下面给你一份可直接用于开发、解析、入库的闲鱼商品详情 API 完整解析，包含标准返回结构、关键字段、解析要点、常见坑。

一、接口基本信息

接口名：xianyu.item.get / goodfish.item_get（不同服务商命名略有差异）
作用：通过 ** 商品 ID（num_iid）** 获取闲鱼商品完整详情
必传参数：

num_iid：闲鱼商品唯一 ID（链接中一串数字）
key / app_key：API 密钥

{
  "status": 200,
  "message": "成功",
  #前往体验API：o0b.cn/ibrad
  "data": {
    "item": {
      "num_iid": "750828541223",
      "title": "二手iPhone 14 256G 99新",
      "price": "3899.00",
      "original_price": "6999.00",
      "currency": "CNY",
      "location": "广东 深圳",
      "created_time": "2025-09-20 14:30:00",
      "condition": "99新",
      "post_type": "包邮",
      "description": "个人自用，无拆无修，电池健康95%...",

      "images": [
        "https://img.xianyu.com/xxx1.jpg",
        "https://img.xianyu.com/xxx2.jpg"
      ],
      "video_url": "https://video.xianyu.com/xxx.mp4",
      "category_id": "50100001",
      "category_name": "手机",
      "brand": "Apple",
      "model": "iPhone 14",
      "status": "on_sale"
    },
    "seller": {
      "seller_id": "加密ID",
      "nick": "数码优品店",
      "credit_level": "极好",
      "good_rate": "99.2%",
      "sales_count": 1280,
      "seller_type": "个人"
    }
  }
}

二、关键字段解析（开发必存）

1. 状态层（外层）

status：状态码（200 = 成功，400 = 参数错误，403 = 无权限，500 = 服务器异常）
message：状态描述（成功 / 失败原因）

2. 商品核心信息（item）

num_iid：商品唯一 ID（主键，用于关联、去重）
title：商品标题（关键词提取、搜索匹配）
price：当前售价（单位：元，字符串 / 浮点）
original_price：原价（用于计算折扣）
condition：成色（99 新 / 95 新 / 九成新 / 八成新 / 七成新 / 六成新及以下）
location：发货地（影响运费、物流时效）
created_time：发布时间（判断商品新鲜度）
post_type：配送方式（包邮 / 自提 / 运费到付）
status：商品状态（on_sale = 在售，sold = 已售出，offline = 下架）

3. 商品内容

description：商品描述（含 HTML / 富文本，需清洗）
images：图片列表（主图 + 详情图，数组）
video_url：商品视频（如有）
category_id / category_name：分类 ID 与名称（用于分类统计）
brand / model：品牌、型号（二手核心属性）

三、解析与开发要点

实现了签名生成函数，使用MD5算法对请求参数进行加密。
封装了商品详情获取函数，包含错误处理逻辑。
使用requests库发送HTTP GET请求，支持gzip压缩。
主程序演示了API调用和基本数据处理。

四、与 1688 / 淘宝 API 对比（快速区分）

闲鱼：二手属性强（condition 成色、post_type 配送、seller 信用更关键）
1688：批发属性强（min_order 起批量、sku 多规格、商家信息更全）
淘宝：零售属性强（sku、库存、销量、评价体系更完善）

b2b商品详情及关键字API接口解析

Sat, 11 Apr 2026 14:34:22 +0800

1688 商品详情 API + 关键词搜索 API 完整解析
包含：接口名、入参、返回结构、关键字段说明、开发注意点。

一、1688 两个核心 API

1）商品详情接口：1688.item_get

作用：根据商品 ID（offer_id/num_iid）获取完整商品信息（SKU、价格、库存、详情图、属性、商家信息等）

2）关键词搜索接口：1688.item_search

作用：根据关键词搜索商品列表，支持分页、价格区间、发货地筛选等

二、1688.item_get 商品详情接口解析

1. 必传参数

num_iid：商品 ID（1688 商品链接里的 id）
key：你的 API 密钥

2. 标准返回示例结构

# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 请求示例 url 默认请求参数已经做URL编码
# 封装好API demo url=o0b.cn/ibrad， wechat id:  TaoxiJd-api 复制链接获取测试
url = "https://api-gw.cn/1688/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&imgid=http://g-search3.alicdn.com/img/bao/uploaded/i4/O1CN01IDpcD81zHbpHs1YgT_!!2200811456689.jpg"
headers = {
    "Accept-Encoding": "gzip",
    "Connection": "close"
}
if __name__ == "__main__":
    r = requests.get(url, headers=headers)
    json_obj = r.json()
    print(json_obj)

3. 关键字段解析（开发必存）

num_iid：商品唯一 ID
title：标题
price：单价
min_order：最小起订量（MOQ）
unit：计价单位
pic_url：主图
item_imgs：图集
skus.sku：SKU 规格、价格、库存
props：商品属性（材质、风格、适用人群等）
seller：商家信息、店铺类型、所在地
desc：商品详情描述

三、1688.item_search 关键词搜索接口解析

1. 必传参数

q：搜索关键词
page：页码
page_size：每页条数（默认 20~40）

2. 可选常用参数

sort：排序（default /sale/price-asc /price-desc）
start_price / end_price：价格区间
is_supply：是否实力商家
ship_location：发货地

4. 关键字段解析

total_results：总商品数（用于分页）
items：商品列表
sales：销量
min_order：起批量
price：批发价
location：发货地

四、两个接口如何配合使用（最常用业务逻辑）

先用 item_search 关键词搜索 → 拿到一批 num_iid
循环调用 item_get → 逐个获取SKU、库存、详情图、属性
存入数据库 / 用于铺货、选品、比价、上架、亚马逊。

五、你如果需要，我可以直接给你：

可直接运行的 Python/PHP 调用代码
Excel 字段映射表（给前端 / 产品看）
统一返回格式封装（适配你自己系统）
批量采集脚本

淘宝、京东、1688 拍立淘图搜 API 均返回 JSON 格式

Sat, 11 Apr 2026 10:40:44 +0800

一：简述

淘宝、京东、1688的拍立淘按图搜索API主要通过图像识别技术返回与上传图片相似的商品信息，通常以JSON格式返回，包含商品标题、图片、价格、销量等关键字段。以下是淘宝、京东、1688拍立淘按图搜索API的JSON数据返回示例及关键字段说明：

二、核心接口与参数

1. 基础接口信息

请求方式：POST/GET。

请求地址：http://c0b.cc/R4rbK2（获取体验）。

返回格式：JSON

2. 关键入参说明

imgBase64：待检索图片Base64编码，单张图片大小≤3M，二选一必填（与imgUrl）。

imgUrl：待检索图片在线地址，公网可正常访问，二选一必填（与imgBase64）。

imageKeywords：辅助检索关键词，可提升匹配精准度，非必填。

filter：结果过滤参数，可筛选商品类型、价格区间等，按需配置。

必填系统参数：_aop_signature（签名）、access_token（授权令牌），保障接口调用安全。

三：各平台数据返回明细

淘宝拍立淘按图搜索API的JSON数据返回示例

json[{"title": "詹姆斯纯棉毛巾底精英袜加厚专业运动中筒吸汗防滑篮球训练袜子男","pic_url": "https://img.alicdn.com/img/bao/uploaded/i4/TB29baudgxlpuFjy0FoXXa.lXXa_!!3003995184.jpg","promotion_price": "22.00","price": "22.00","sales": 700,"num_iid": "544603032967","seller_nick": "Gene Bolt 棉品社","is_tmall": "false","area": "浙江 杭州","detail_url": "//item.taobao.com/item.htm?id=544603032967"},{"title": "时尚女士手提包 简约百搭单肩斜挎包","pic_url": "https://img.example.com/product/123456.jpg","price": "199.00","promotion_price": "159.00","sales": "1234","seller_id": "7890","seller_name": "时尚女包专卖店","detail_url": "https://example.com/product/123456"}]

关键字段说明：

title：商品标题或描述。
pic_url：商品图片链接。
promotion_price：商品优惠价格（如有）。
price：商品原价或现价。
sales：商品销量或购买人数。
num_iid：商品唯一标识。
seller_nick：商品卖家昵称。
is_tmall：标识商品是否来自天猫商城。
area：商品卖家的店铺所在地。
detail_url：商品详细页面链接。

1688拍立淘按图搜索API的JSON数据返回示例

json{"code": 200,"message": "success","data": {"search_id": "123e4567-e89b-12d3-a456-426614174000","total_results": 5,"items": [{"item_id": "678901234567","title": "夏季新款纯棉T恤 男士短袖宽松款","price": "¥29.90","min_order": "2件起批","image_url": "https://img.alicdn.com/img/item/678901234567.jpg","shop_name": "XX服饰旗舰店","shop_url": "https://shop.1688.com/shop/xx.html","similarity_score": 0.95},{"item_id": "678901234568","title": "男士纯棉短袖T恤 百搭基础款","price": "¥35.00","min_order": "1件起批","image_url": "https://img.alicdn.com/img/item/678901234568.jpg","shop_name": "YY服饰专营店","shop_url": "https://shop.1688.com/shop/yy.html","similarity_score": 0.92}]}}

关键字段说明：

code：状态码，通常为200表示请求成功。
message：请求状态描述信息。
search_id：请求的唯一标识符。
total_results：搜索结果的总商品数量。
items：商品列表，包含搜索到的商品信息。
item_id：商品ID。
similarity_score：相似度得分，表示上传图片与商品的相似程度。

京东拍立淘按图搜索API（假设性示例）

京东的拍立淘按图搜索API可能包含以下字段（具体字段可能因京东API更新而有所变化）：

json[{"product_name": "京东自营 纯棉T恤 男士短袖","image_url": "https://img.jd.com/img/item/123456789.jpg","price": "99.00","promotion_price": "79.00","sales_volume": "1000+","product_id": "123456789","shop_name": "京东自营旗舰店","detail_url": "https://item.jd.com/123456789.html"}]

关键字段说明：

product_name：商品名称。
image_url：商品图片链接。
price：商品原价。
promotion_price：商品促销价。
sales_volume：商品销量。
product_id：商品唯一标识。
shop_name：店铺名称。
detail_url：商品详情页链接。

四、调用与解析要点

请求方式：均支持 POST/GET，入参为 imgUrl（图片链接）或 imgBase64（图片 Base64 编码），二选一必填。
返回格式：统一 JSON，便于解析。
相似度过滤：可通过相似度字段（如 similarity_score>0.8）筛选高匹配商品。
分页处理：利用 page_no/page_size 实现翻页获取全量结果。
错误处理：通过 code/success 字段判断调用状态，message 给出异常原因。

淘宝 item_search_shop（店铺商品全量）接口完整规范：功能、参数、返回字段、分页全量、调用示例、合规与风控

Tue, 07 Apr 2026 11:17:31 +0800

淘宝 item_search_shop（店铺商品全量）接口完整规范：功能、参数、返回字段、分页全量、调用示例、合规与风控，直接对接可用。

一、接口核心信息

接口名：taobao.item_search_shop_pro（第三方通用标准名，官方无同名公开接口，多为第三方封装 / 开放平台权限接口）
核心功能：按 seller_id/shop_id 获取店铺全量上架商品，支持分页、字段筛选、类目过滤
适用场景：店铺商品同步、竞品监控、ERP / 选品、数据报表
请求方式：GET/POST
数据范围：仅返回在售 (onsale) 商品；下架 / 删除 / 预售需额外接口
官方 vs 第三方：

官方开放平台：需企业认证、应用权限、seller 授权，接口为taobao.items.onsale.get（仅自家店铺）
第三方（如万邦、API 平台）：item_search_shop_pro，支持任意公开店铺全量抓取，无需店铺授权

二、完整请求参数（必选 + 可选）

公共测试参数

参数名	类型	必填	说明	示例
key	String	是	API 密钥 / Token	your_app_key
secret	String	是	签名密钥	your_app_secret
method	String	是	固定值	taobao.item_search_shop
format	String	否	返回格式，默认 json	json
v	String	否	版本，默认 2.0	2.0

如何获取 seller_id/shop_id

店铺首页 URL：https://shopxxx.taobao.com → shop_id=xxx
商品详情页：F12 / 源码搜sellerId或userNumId
第三方工具 / 接口直接解析

商品 items 核心字段（全量明细）

字段名	类型	说明	示例
num_iid	String	商品唯一 ID（主键）	583975606695
title	String	商品标题	华为 Mate60 Pro 5G 手机
price	Float	现价（促销价）	5999.00
original_price	Float	划线价 / 原价	6999.00
sales	Int	总销量	12000
volume	Int	月销量	3000
pic_url	String	主图 URL	https://img.alicdn.com/xxx.jpg
item_imgs	Array	多图列表（最多 5 张）	["https://...1.jpg",...]
detail_url	String	商品详情链接	https://item.taobao.com/item.htm?id=xxx
category_id	String	类目 ID	50012081
category_name	String	类目名称	3C 数码 / 手机
location	String	发货地	广东深圳
post_fee	Float	运费（0 = 包邮）	0.00
is_on_sale	Bool	是否在售	true
seller_nick	String	卖家昵称	XX 数码旗舰店
shop_title	String	店铺名	XX 旗舰店
props	Array	规格属性	[{"name":"颜色","value":"黑色"},...]
sku	Array	SKU 信息（部分平台返回）	规格、价格、库存

三、全量获取店铺商品（分页遍历逻辑）

核心步骤（必做）

第 1 页请求：page=1，page_size=40，获取total_results和page_count
循环遍历：page 从 2 到 page_count，依次请求
合并所有 items 数组，得到店铺全量商品列表
风控控制：每页间隔 1-3 秒，单 IP≤50 次 / 分钟

全量示例（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 demo url=o0b.cn/ibrad 复制链接获取测试
url = "https://api-gw.cn/taobao/item_search_shop_pro/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&shop_id=440688975&seller_id=4273827547&page=1&sort="
headers = {
    "Accept-Encoding": "gzip",
    "Connection": "close"
}
if __name__ == "__main__":
    r = requests.get(url, headers=headers)
    json_obj = r.json()
    print(json_obj)

四、总结

taobao.item_search_shop_pro接口为店铺全量商品数据获取提供了标准化、合规化的解决方案，其核心在于掌握签名生成规则、权限申请流程与分页遍历逻辑。通过本文的技术解析与实战示例，开发者可快速完成接口对接，实现商品数据的高效同步。在实际开发中，需重点关注签名正确性、调用频率控制与数据合规性，避免常见错误，确保接口稳定运行.

Goodfish｜ item_get（商品详情）接口完整数据明细

Fri, 03 Apr 2026 14:11:41 +0800

闲鱼 item_get（商品详情）接口完整数据明细、字段说明、JSON 示例、调用参数与合规提示，直接对接可用。

一、接口基础信息

接口名：goodfish.item_get（第三方通用命名，闲鱼无官方公开商品详情 API）
功能：传入商品 ID（item_id/num_iid），返回商品全量结构化详情
请求方式：GET/POST
必传参数：item_id（闲鱼商品唯一 ID，从链接中提取，如https://2.taobao.com/item.htm?id=750828541223 → id=750828541223）
认证：第三方服务商一般需app_key+sign签名，部分需 token / 账号授权

二、完整返回数据结构（JSON）+ 字段明细

# 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， wechat id:  TaoxiJd-api 复制链接获取测试 "
app_key = "YOUR_APP_KEY" num_id = "123456" # 目标商品ID
# 请求示例 url 默认请求参数已经做URL编码 url = "goodfish/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)

2. 商品核心信息（item）

字段名	类型	示例	说明
item_id / num_iid	String	"750828541223"	商品唯一 ID，主键
title	String	"iPhone 15 Pro Max 256G 银色 99 新无拆修"	商品标题
sub_title	String	"个人自用原装无修功能全好"	副标题 / 卖点
price	Float	7800.00	当前售价（元）
original_price	Float	9999.00	原价 / 专柜价（二手常用）
condition	String	"99 新"	成色：全新 / 99 新 / 95 新 / 九成新 / 八成新 / 七成新及以下
status	String	"onsale"	商品状态：onsale (在售)/sold (已售)/offline (下架)
desc	String	"个人一手，无拆无修，电池健康 92%..."	商品描述（含 HTML / 换行）
desc_plain	String	"纯文本描述（去标签）"	纯文本版描述
category_id	String	"50012081"	类目 ID
category_name	String	"手机 / 数码 / 手机"	类目名称
brand	String	"Apple"	品牌
model	String	"iPhone 15 Pro Max"	型号
created	String	"2025-10-20 14:30:00"	发布时间
location	String	"广东深圳"	发货地 / 所在地
post_fee	Float	0.00	运费（0 = 包邮）
post_type	String	"快递"	配送方式：快递 / 自提 / 同城配送

3. 图片 / 视频（item_imgs）

字段名	类型	示例	说明
pic_url	String	"https://img.alicdn.com/imgextra/i4/xxx.jpg"	主图 URL
item_imgs	Array	["https://...1.jpg","https://...2.jpg"]	多图列表（最多 9 张）
video_url	String	"https://cloud.video.taobao.com/play/u/xxx/p/1/e/6/t/1/xxx.mp4"	商品视频直链（有则返回）

4. 扩展标签 / 属性（extend）

字段名	类型	示例	说明
tags	Array	["包邮","可小刀","原装","无拆修"]	商品标签
props	Array	[{"name":"容量","value":"256G"},{"name":"颜色","value":"银色"}]	规格属性
service_tags	Array	["7 天无理由","正品保障"]	服务标签
is_new	Bool	false	是否全新
is_free_shipping	Bool	true	是否包邮

三、完整 JSON 返回示例（精简版）

{
  "code": 200,
  "msg": "success",
  "data": {
    "item": {
      "item_id": "750828541223",
      "title": "iPhone 15 Pro Max 256G 银色 99新",
      "price": 7800.00,
      "original_price": 9999.00,
      "condition": "99新",
      "status": "onsale",
      "desc": "个人自用，无拆无修，电池92%，功能全好，配件齐全",
      # 封装好API demo url=o0b.cn/ibrad
      "created": "2025-10-20 14:30:00",
      "location": "广东 深圳",
      "post_fee": 0.00,
      "category_name": "手机/数码/手机"
    },
    "seller": {
      "nick": "小鱼数码",
      "credit_level": "极好",
      "good_rate": "99.2%",
      "seller_type": "personal"
    },
    "item_imgs": [
      "https://img.alicdn.com/imgextra/i4/xxx.jpg",
      "https://img.alicdn.com/imgextra/i4/xxx_2.jpg"
    ],
    "trade": {
      "stock": 1,
      "collect_num": 89,
      "want_num": 5,
      "can_bargain": true
    },
    "extend": {
      "tags": ["包邮","可小刀","原装"],
      "props": [{"name":"容量","value":"256G"},{"name":"颜色","value":"银色"}]
    }
  }
}

四、调用与合规要点（必看）

无官方公开 API：闲鱼未开放商品详情官方接口，市面均为第三方封装 / 爬虫封装，存在风控、限流、封号、数据不准风险
频率限制：单 IP / 账号建议1/ 秒/ 次，批量需加代理、资源池，避免 403 / 封禁
字段差异：不同第三方服务商返回字段命名可能略有差异（如 num_iid/item_id、price/current_price），以对接的服务商文档为准

从客户需求到 API 实施：淘宝商品详情高并发调用

Tue, 31 Mar 2026 13:43:15 +0800

在电商数据分析、竞品监控等场景中，批量获取商品详情数据是高频需求。本文将完整还原一次技术落地过程 —— 从接收客户 “传商品 ID 即得详情” 的需求，到用 Python 实现爬虫核心逻辑，最终封装成可直接调用的 API，为类似需求提供可复用的技术方案。

一、需求拆解：明确核心目标与约束

客户是一家电商代运营公司，需要批量获取淘宝商品的标题、价格、库存、规格、详情图等信息，核心诉求有三个：

易用性：无需关心技术细节，仅传入商品 ID（如淘宝商品链接中的id=123456）即可返回数据；
稳定性：避免频繁被反爬拦截，确保批量请求时数据获取成功率；
结构化：返回 JSON 格式数据，方便直接导入 Excel 或接入客户内部系统。

同时需注意淘宝的反爬规则，避免使用高频请求、固定 IP 等易触发拦截的操作，这是技术实现的核心约束。

二、技术选型：轻量且高效的工具组合

针对需求特点，选择 “爬虫 + 后端框架” 的轻量组合，兼顾开发效率与运行稳定性，具体选型如下：

技术模块	工具 / 框架	选型理由
网络请求	Requests + Playwright	Requests 处理接口请求，Playwright 应对动态渲染页面
数据解析	BeautifulSoup + JSON	解析 HTML 静态内容，直接处理接口返回的 JSON 数据
后端 API	FastAPI	高性能、支持自动生成接口文档，开发效率远超 Flask
数据存储（可选）	SQLite	轻量级文件数据库，无需部署，适合小批量数据缓存
反爬应对	随机 User-Agent + 延时	降低请求特征，避免触发淘宝反爬机制

三、核心实现：从爬虫到数据结构化

3.1 第一步：分析淘宝商品页面数据来源

淘宝商品详情页分为 “静态渲染” 和 “动态加载” 两部分，直接爬取页面 HTML 会丢失部分数据，需先通过浏览器抓包定位真实数据接口：

打开淘宝商品页（如https://item.taobao.com/item.htm?id=123456），按 F12 打开 “开发者工具”；
切换到 “Network” 标签，刷新页面，筛选 “XHR” 类型请求，查找包含 “item_get”“detail” 等关键词的接口；
分析接口请求参数（如id为商品 ID）和返回结果，确认该接口包含标题、价格、库存等核心字段（返回格式为 JSON）。

关键提醒：淘宝接口需携带登录后的 Cookie（包含用户身份信息），否则会返回登录拦截页，需提前获取并在请求头中配置。

3.2 第二步：编写爬虫核心代码

核心逻辑分为 “请求数据”“解析数据”“异常处理” 三部分，代码如下（含关键注释）：

import requestsimport randomimport timefrom typing import Dict, Optional# 1. 配置请求头（模拟浏览器，避免被识别为爬虫）def get_headers() -> Dict:
    user_agents = [        "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36",        "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Firefox/115.0"
    ]    return {        "User-Agent": random.choice(user_agents),        "Cookie": "你的淘宝登录Cookie（从浏览器复制）",  # 需替换为真实Cookie
        "Referer": "https://item.taobao.com/"
    }# 2. 爬取单个商品详情def crawl_taobao_item(item_id: str) -> Optional[Dict]:    # 淘宝商品详情接口（示例，实际需抓包确认最新接口）
    url = f"https://h5api.m.taobao.com/h5/mtop.taobao.detail.getdetail/6.0/?id={item_id}"
    headers = get_headers()    
    try:        # 加随机延时（1-3秒），降低反爬风险
        time.sleep(random.uniform(1, 3))
        response = requests.get(url, headers=headers, timeout=10)
        response.raise_for_status()  # 触发HTTP错误（如403、500）
        
        # 解析JSON数据，提取核心字段（字段名需按实际接口调整）
        data = response.json()
        item_info = data["data"]["itemInfoModel"]["itemInfo"]        
        # 结构化返回结果（只保留客户需要的字段）
        return {            "item_id": item_id,            "title": item_info["title"],            "price": item_info["price"],            "stock": item_info["totalStock"],            "sales_count": item_info["sellCount"],            "shop_name": data["data"]["sellerInfoModel"]["sellerName"],            "detail_images": [img["url"] for img in data["data"]["itemImageModel"]["largeImages"]]
        }    
    except Exception as e:        print(f"爬取商品{item_id}失败：{str(e)}")

四、API 封装：Python请求示例

# coding:utf-8

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

from __future__ import print_function

import requests

# 假设 API 封装接口地址 API demo url=o0b.cn/ibrad， wechat id:  TaoxiJd-api 

# 请求示例 url 默认请求参数已经做URL编码 url = "tb/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=12345" 
headers = { "Accept-Encoding": "gzip", "Connection": "close" } if __name__ == "__main__": r = requests.get(url, headers=headers) json_obj = r.json() 
print(json_obj)

五、落地优化：稳定性与可维护性提升

反爬策略升级：若频繁被拦截，可增加 “IP 代理池”（如使用阿布云、芝麻代理），替换固定 IP；
接口监控：添加日志记录（如用 loguru），记录请求成功 / 失败次数，方便排查问题；
批量请求支持：新增/taobao/item/batch_detail接口，支持传入多个商品 ID（如{"item_ids": ["123", "456"]}），批量返回数据；
Cookie 自动更新：通过 Playwright 模拟登录，定期自动更新 Cookie，避免手动替换的麻烦。

总结

从客户需求到 API 落地，核心是 “以易用性为目标，以稳定性为基础”。通过 “爬虫逻辑模块化 + FastAPI 轻量封装”，既解决了淘宝反爬与数据结构化问题，又让客户无需关心技术细节，仅通过商品 ID 即可快速获取数据。这种方案不仅可复用于淘宝，稍作调整后也适用于京东、拼多多等其他电商平台的商品数据爬取。

淘宝天猫商品评论 API接口，采集评论详细数据

Fri, 27 Mar 2026 14:22:32 +0800

简述：

淘宝天猫商品评论API是淘宝开放平台提供的核心数据接口，用于获取指定商品的用户评价信息，包括评分、内容、晒图、追评等数据。该接口广泛应用于电商数据分析、竞品监控、用户反馈挖掘等场景，支持开发者构建商品口碑分析系统或优化营销策略。通过该接口，可以高效获取结构化的评论数据，实现从海量文本到商业洞察的转化。

一、官方 API：淘宝 / 天猫评论接口（合规首选）

1. 核心接口

淘宝天猫商品评论：taobao.item.review.
返回字段：

评分（1–5 星）、评论内容、追评
晒图 / 视频、用户昵称（脱敏）
评论时间、SKU 规格、
评价标签
质量好 / 物流快等

2. Python 调用示例

# coding:utf-8

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

from __future__ import print_function

import requests

# 配置参数 "API demo url=o0b.cn/ibrad "

app_key = "YOUR_APP_KEY" q = "商品ID" # 商品ID

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

二、第三方聚合 API（最适合你：少量、快速、免审核）

你现在是商品、轻量调用、不想走官方审核，第三方 API 最适合：

不用企业认证、不用审核、即用即充、按条计费
可直接复制的第三方 API 接入接口调用
统一接口：同时支持淘宝 + 天猫 + 京东
返回结构和官方一致：评论、评分、SKU、图片、追评全有

三、结语

电商团队稳定采集评论数据用于产品优化和竞品分析。如需进一步了解情感分析、关键词提取等进阶玩法。

希望以上内容能帮助您快速了解和使用淘宝天猫商品评论API。

OpenClaw + 飞书打造 AI 电商选品系统，无缝对接三方数据服务商

Tue, 24 Mar 2026 14:58:27 +0800

OpenClaw + 飞书是一套低成本、轻量、可落地的 AI 电商选品系统：

OpenClaw：负责数据抓取、AI 分析、三方 API 对接、自动化执行
飞书：负责协作、多维表格（数据中台）、机器人预警、团队审批
整体：自动拉取三方数据 → AI 打分选品 → 自动入库飞书 → 实时预警 → 团队协同

下面从架构、实操步骤、三方数据对接、完整流程、优化点，一次性讲透可直接落地的方案。

一、系统架构（一句话看懂）

OpenClaw（AI 执行层） + 飞书（协作 / 数据层） + 三方数据服务商（数据源）

1. OpenClaw 核心定位（选品大脑）

开源 AI Agent 网关（本地 / 云端部署）
能力：批量爬虫、API 拉取、AI 分析、规则筛选、定时任务、写入飞书
可对接：电商平台 API、销量数据、舆情、供应链、1688 / 淘宝 / 拼多多 / 亚马逊等三方数据

2. 飞书核心定位（协作与数据中台）

多维表格：结构化存储：商品、竞品、销量、评分、供应链、爆款概率
机器人 / 自建应用：接收 OpenClaw 预警、选品推荐、库存 / 舆情告警
群聊 / 审批 / 文档：选品评审、供应链对接、运营协作

3. 三方数据服务商（常用）

电商销量 / 榜单：淘宝 / 天猫 / 京东 / 拼多多 / 亚马逊官方 / 第三方 API
舆情 / 评论 / 热度：蝉妈妈、新抖、灰豚、飞瓜、社交媒体 API
供应链 / 货源 / 价格：1688 API、淘货源、工厂数据、物流成本
趋势 / 搜索：百度指数、谷歌趋势、平台搜索热度 API

二、环境部署（5 步落地）

1. OpenClaw 部署（云端 / 本地）

配置：2 核 4G 云服务器（支持 2000 并发）
系统：Linux / Windows 均可
安装：Node.js 22+ + OpenClaw Gatewaydocs.openclaw.ai
配置：

大模型 API Key（豆包 / Kimi / GPT 等）
飞书自建应用凭证（App ID / App Secret / Webhook）
三方数据服务商 API Key

2. 飞书配置（企业自建应用）

1）开发者后台 → 自建应用

开通：机器人、多维表格、通讯录、消息推送 API
获取：

App ID / App Secret
机器人 Webhook
多维表格 App Token

2）多维表格设计（选品库）
建议字段：

商品 ID、标题、类目、平台、链接
销量、价格、评分、评论数、好评率
货源价、供应链、利润率、爆款概率（AI 打分）
状态：待分析→待审核→已选→运营中

3. 三方数据对接（OpenClaw 配置）

OpenClaw 自动：拉取 → 清洗 → 去重 → AI 分析 → 写入飞书多维表格

4. OpenClaw ↔ 飞书打通

配置飞书机器人 Webhook：OpenClaw 推送选品预警、爆款提醒、库存告警
配置多维表格写入：AI 分析结果自动写入
群指令：在飞书群 @机器人选品女装 → OpenClaw 执行并返回结果

5. 数据源初始化

批量导入：竞品链接、类目、平台清单 → 飞书多维表格
OpenClaw 一次性全量抓取历史数据，建立基线

三、AI 选品完整自动化流程

1. 数据采集（OpenClaw）

定时任务：每日 / 每小时自动拉取：

平台榜单、热搜、潜力新品
竞品：销量、价格、评分、评论、卖点
供应链：1688 同款、成本、库存、发货时效

无 API 场景：OpenClaw 用浏览器模拟 + 视觉识别抓取

2. AI 分析与选品打分（核心）

OpenClaw 调用大模型做多维度评分：

选品打分规则（可自定义） 1. 销量增长趋势 ↑ 2. 利润率 ≥30% 3. 差评率 <5% 4. 供应链稳定（现货/48小时发货） 5. 无侵权/合规风险 6. 季节性/趋势热度 ↑ → 综合：爆款概率 0–100 分

输出：爆款概率、风险点、推荐理由、对标竞品、运营建议

3. 自动入库飞书多维表格

字段自动映射：商品信息、销量、价格、成本、利润率、爆款概率、AI 评语
去重：同款 / 同链接自动合并

4. 飞书协作与预警

机器人推送：

今日新品：【AI 选品】爆款概率 85% 商品：xxx
竞品降价 / 爆单 / 舆情风险
库存低于阈值：【补货提醒】xxx 库存不足

多维表格视图：

待审核、高潜力、已选品、运营中、淘汰品

团队审批：选品 → 运营审核 → 采购对接 → 上线

5. 持续监控（闭环）

OpenClaw 每日更新：销量、价格、评论、库存
异动预警：价格战、差评激增、断货、竞品上新
月度复盘：AI 生成选品效果报告 → 飞书文档

四、三方数据服务商对接清单（直接用）

1. 电商销量 / 榜单
淘宝 / 天猫：淘宝 API 网关 / o0b.cn/ibrad
拼多多：多多进宝 / 第三方数据 API
京东 / 抖音 / 亚马逊：对应平台或第三方数据服务商
OpenClaw：配置 API Key → 定时拉取 → 解析入库

2. 舆情 / 评论 / 内容分析

蝉妈妈、新抖、飞瓜、灰豚：评论 API
OpenClaw：提取差评关键词、卖点、投诉点 → AI 生成风险报告

3. 供应链 / 货源

1688 API：商品、价格、库存、供应商
淘货源、工厂数据、物流成本 API
OpenClaw：同款匹配、成本核算、利润率自动计算

五、优势（为什么这套方案强）

零代码 / 低代码：不用自建后台，飞书多维表格即数据中台
全自动化：采集→分析→选品→入库→预警→监控闭环
隐私安全：OpenClaw 可本地部署，数据不经过第三方
团队协作原生：飞书内完成：讨论→审批→运营→复盘
低成本：开源 + 飞书基础版 + 三方 API 按需付费
可扩展：后续延伸：自动文案、自动上架、库存预警、广告分析

六、落地避坑点

三方 API 限流：OpenClaw 做重试 + 队列 + 限速
反爬：用代理 + 浏览器模拟 + IP 池
数据脏：OpenClaw 做清洗 + 去重 + 规则校验
模型成本：优先用国内低价模型（豆包 / DeepSeek 等）做批量分析

淘宝商品详情｜商品属性｜包装规格信息 API接口

Mon, 23 Mar 2026 11:49:14 +0800

淘宝开放平台（TOP）提供 taobao.item.get（标准版）与 taobao.item.get_pro（高级版）两个核心 API 接口，可一次性获取商品详情、完整属性、SKU 规格及包装规格信息，是官方推荐的合规数据方案。

一、核心接口：taobao.item.get/taobao.item.get_pro

接口标识

API 名称: taobao.item.get (基础) / taobao.item.get_pro (高级)
请求地址: https://o0b.cn/ibrad
返回格式: JSON
必填参数: num_iid (商品 ID)

可获取数据（含包装与规格）

表格

数据模块	关键字段	包装 / 规格相关
商品基础信息	num_iid, title, price, pic_url	-
商品标准属性	props_name, prop_list	品牌、材质、尺寸、重量、产地、包装方式
SKU 规格	sku_list → properties_name, quantity, price	颜色、尺码、规格组合、单 SKU 包装
包装 / 物流信息	packing_list, weight, size, volume	包装清单、毛重、长宽高、包装体积
商品详情	desc (HTML)	详情页内包装说明

二、专用规格接口（辅助）

taobao.item.desc.get：获取商品规格组与可选值（如颜色 / 尺码）
taobao.item.sku.get：查询 SKU 的价格、库存、属性、条码

三、调用流程（极简）

入驻：淘宝开放平台注册 → 创建应用 → 获取 AppKey / AppSecret
授权：申请 item.get / item.get_pro 接口权限
构造请求

公共参数：method, app_key, timestamp, sign, format=json
业务参数：num_iid=商品ID

四、返回示例（包装规格）

{
  "item_get_response": {
    "item": {
      "num_iid": 678901234567,
      "title": "XX品牌 500ml 瓶装矿泉水",
      "props_name": "品牌:XX;材质:PET;净含量:500ml;包装种类:瓶装;包装规格:1瓶/份,24瓶/箱",
       # 封装好API供应商demo url=o0b.cn/ibrad， wechat id:  TaoxiJd-api 复制链接获取测试
      "weight": 0.55, // 千克（含瓶）
      "size": "6.5x6.5x23 cm",
      "packing_list": "矿泉水×1, 瓶身×1",
      "sku_list": [
        {
          "properties_name": "包装规格:单瓶",
          "price": "2.00",
          "quantity": 1000
        },
        {
          "properties_name": "包装规格:24瓶整箱",
          "price": "45.00",
          "quantity": 100
        }
      ]
    }
  }
}

五、关键说明

包装规格：通常在 props_name、size、weight、packing_list 及 SKU 属性中返回。
权限：item.get 基础可用；整箱 / 批发包装需企业认证 + 类目权限。
频率：个人≈500 次 / 天；企业可申请更高 QPS。

六、推荐方案

全量信息：优先使用 taobao.item.get_pro（一次拿到详情 + 属性 + 包装 + SKU）。
仅规格：用 taobao.item.spec.get + taobao.item.sku.get。