全球电商数据接口&反向海淘系统

taobao.items.search 落地实战：利用淘宝商品列表 API 构建跨境电商选品系统

Fri, 09 Oct 2026 17:54:18 +0800

摘要：跨境铺货业务长期面临爬虫封禁、数据不稳定、字段缺失等痛点。本文记录项目实战，使用 taobao.items.search 淘宝商品列表 API，搭建一套自动化跨境选品数据源，实现关键词批量搜品、销量价格筛选、数据清洗、入库，对接 Ozon、Temu 等跨境平台选品需求，包含系统架构、接口参数、JSON 样例、Python 调用示例、限流与生产踩坑实录。适合后端、数据开发、跨境技术负责人阅读。

一、业务背景：跨境选品的痛点

跨境卖家选品，需要从淘宝挖掘潜力货源：筛选高销量、低退货、合适毛利的商品，拿到标题、价格、图片、类目、销量等基础信息。

早期方案：网页爬虫。

缺点：频繁验证码、IP 封禁、页面结构改版导致代码失效；数据不稳定，维护成本高。

选型方案：taobao.items.search 商品列表 API 优势：官方结构化数据，字段稳定、返回 JSON，支持关键词、类目、价格区间、销量排序，适合做跨境批量货源挖掘。

业务目标

输入关键词列表，批量拉取淘宝商品列表；
按销量、价格自动过滤，筛选具备跨境潜力的商品；
结构化数据存入数据库，后续可对接商品详情 API 做深度字段提取；
搭建定时任务，周期性更新商品榜单，监控价格、销量变动。

二、系统整体架构

关键词任务调度模块 → taobao.items.search API请求层 → 限流&重试中间件 → 原始JSON存储 → 数据清洗模块 → 选品指标计算 → MySQL入库 → 前端选品看板/跨境刊登系统

调度层：定时任务，批量遍历关键词池（根据海外市场需求生成中文搜索词）
API 请求层：封装 OpenAPI 签名、appkey、timestamp，统一请求入口
限流控制：控制 QPS，处理接口返回限流错误，指数退避重试
清洗层：清洗商品标题、人民币价格、销量，过滤禁售品、预售商品
选品计算：计算预估毛利、物流成本评分，输出候选货源清单
存储：原始 JSON 归档，结构化数据入库，供跨境运营人员筛选

三、taobao.items.search 接口核心参数说明

参数	是否必填	说明
method	是	taobao.items.search（前往Taobaoapi2014体验）
q	是	搜索关键词，跨境业务一般使用国内货源关键词
url	是	http://c0b.cc/R4rbK2
sort	可选	sales_desc按销量降序，price_asc价格升序
page_no	可选	页码，从 1 开始
page_size	可选	每页返回条数，根据接口配额设置
cid	可选	类目 ID，限定类目搜索，缩小选品范围

业务要点：跨境选品优先使用 sales_desc 销量排序，优先挖掘市场验证过的爆款货源。

四、请求示例 & JSON 返回样例

请求参数示例

{  "method": "taobao.items.search",  "q": "户外便携水杯",  "sort": "sales_desc",  "page_no": 1,  "page_size": 20,  "fields": "num_iid,title,price,sold,pic_url,shop_name,item_url"}

返回 JSON 样例

{  "items_search_response": {    "total_results": 1268,    "items": [      {        "num_iid": "723456789123",        "title": "户外便携大容量水杯 运动塑料随行杯",        "price": "29.90",        "sold": "23456",        "pic_url": "https://gw.alicdn.com/xxx.jpg",        "shop_name": "XX户外用品店",        "item_url": "https://item.taobao.com/item.htm?id=723456789123"      },      {        "num_iid": "723456789124",        "title": "简约随手杯防摔便携水杯学生旅行杯",        "price": "19.80",        "sold": "18920",        "pic_url": "https://gw.alicdn.com/yyy.jpg",        "shop_name": "XX家居专营店",        "item_url": "https://item.taobao.com/item.htm?id=723456789124"      }    ],    "page_no": 1,    "page_size": 20  }}

五、Python 简易调用示例（伪代码）

import requestsimport time
def taobao_items_search(keyword, page_no=1):    params = {        "method": "taobao.items.search",        "appkey": "你的appkey",        "timestamp": str(int(time.time()*1000)),        "q": keyword,        "sort": "sales_desc",        "page_no": page_no,        "page_size": 20,        "fields": "num_iid,title,price,sold,pic_url,shop_name,item_url"    }    # 此处省略签名生成逻辑    resp = requests.get("https://gw.api.taobao.com/router/rest", params=params)    return resp.json()
# 跨境选品批量拉取keywords = ["户外水杯","宠物拾便袋","厨房收纳盒"]for kw in keywords:    data = taobao_items_search(kw)    # 数据清洗、入库、选品评分逻辑    time.sleep(1) # 限流休眠

六、跨境选品业务过滤逻辑（核心）

拿到列表数据后，增加筛选规则，自动过滤不适合出海的商品：

销量阈值：最低月销，过滤新品无验证商品；
价格区间：过滤过低易破损、过高毛利不足的商品；
标题关键词过滤：剔除带电、液体、禁售、侵权敏感品类；
图片校验：过滤白底图缺失、水印严重的商品（跨境刊登需要主图）；
后续联动：拿到商品 ID 后，调用商品详情 API 获取 SKU、属性，用于多语言翻译上架至跨境店铺。

七、生产环境踩坑实录

接口 QPS 配额限制开放平台有调用频次限制，高并发批量搜品会触发限流。解决方案：任务队列 + 令牌桶，指数退避重试，错峰调度。
分页深度限制部分场景不能无限翻页，不要一次性拉取几百页，关键词拆分，多任务分批采集。
字段返回差异天猫商品、淘宝 C 店返回字段略有区别，代码需要做判空处理，防止入库报错。
商品状态过滤 API 仍会返回下架商品，业务层需要过滤失效商品，避免选品拿到无效货源。
跨境合规前置校验拿到商品列表后，提前做类目筛查，规避侵权、带电、危险品，减少后期刊登损失。

淘宝图片搜索 API 落地实战：基于以图搜货搭建跨境电商选品系统

Thu, 08 Oct 2026 11:36:53 +0800

摘要

跨境电商选品传统方式高度依赖关键词检索，海外竞品标题翻译误差、类目语言差异，经常出现漏找货源的问题。本文记录项目落地全过程，使用淘宝拍立淘图片搜索 API（taobao.item_search_img），直接使用海外平台竞品主图反向检索国内同款货源，搭建一套自动化跨境选品系统。文章包含整体架构、图片预处理、接口参数、JSON 返回样例、业务过滤逻辑、Python 简易调用代码，以及生产环境踩坑实录。

一、业务背景与痛点

在做 Temu、Ozon、Coupang 等跨境铺货业务时，常规选品流程：

海外平台挖掘潜力爆款，保存商品主图；
人工翻译标题关键词，到淘宝搜索国内货源；
人工对比款式、核算拿货成本、评估跨境毛利。

现存痛点

翻译关键词不准确，同款商品标题用词差异大，大量货源检索不到；
人工比对图片效率极低，批量选品时人力成本高；
无法快速识别外观高度相似但标题完全不同的竞品。

方案选型放弃纯关键词检索，采用图像检索方案：使用淘宝图片搜索 API，上传海外竞品原图，直接返回淘宝 / 天猫同款、相似款商品，再联动taobao.item_get商品详情接口拉取 SKU、价格、发货地，自动计算跨境毛利，筛选可上架候选品。

对比爬虫逆向图搜：官方 TOP 接口稳定性更高，规避页面结构变动、IP 封禁、验证码等问题，适合长期稳定的业务系统。

二、系统整体架构

整套跨境选品系统分为四层：

图片预处理层：下载海外竞品图片，裁剪、去水印、压缩、转 JPG，统一图片尺寸；
API 调用层：TOP 签名生成，调用taobao.item_search_img图搜接口，控制 QPS 限流、异步队列；
数据业务层：解析返回 JSON，按相似度阈值过滤，调用商品详情 API 获取完整货源信息；
选品输出层：自动核算毛利、筛选发货地址、过滤禁运品类，输出候选选品清单入库，支持运营后台查看。

业务完整链路海外竞品图片 → 图片预处理 → 调用淘宝图片搜索 API → 获取相似商品列表 → 过滤低相似度结果 → 调用商品详情 API 获取 SKU、重量、价格 → 跨境成本自动计算 → 筛选高毛利货源 → 存入数据库，运营复核。

三、接口基础信息

接口名称：taobao.item_search_img（拍立淘图片搜索 API）能力：传入公网图片 URL 或 Base64 图片，返回淘宝 / 天猫同款、相似商品，附带相似度分值、商品标题、价格、主图、商品 ID。

核心请求参数

参数	是否必填	说明
接口名称	是	taobao.item_search_img（前往Taobaoapi2014体验）
接口网关	是	c0b.cc/R4rbK2
sign	是	TOP 签名，所有参数按字典序拼接生成
img	是	图片 Base64 编码，或公网可访问图片 URL
search_type	可选	检索类型，1 = 同款优先，2 = 相似款优先
cat_id	可选	类目 ID，传入类目可提升匹配精度

图片要求：推荐 JPG 格式，图片主体居中，去除多余背景、水印，单边尺寸不要过大，图片体积压缩，否则会降低匹配准确率，甚至返回图片无效错误。

四、返回 JSON 样例（简化）

{  "request_id": "abc123456789",  "items": {    "item": [      {        "num_iid": "723456789123",        "title": "2026新款户外便携折叠水杯硅胶旅行随手杯",        "pic_url": "https://img.alicdn.com/imgextra/i2/xxxx.jpg",        "price": "29.80",        "sales": "1200",        "similar_score": 0.92,        "location": "浙江金华",        "seller_nick": "xxx家居工厂店",        "is_tmall": false      },      {        "num_iid": "723456789456",        "title": "硅胶折叠伸缩水杯旅行便携随身杯",        "pic_url": "https://img.alicdn.com/imgextra/i3/xxxx.jpg",        "price": "32.50",        "sales": "860",        "similar_score": 0.85,        "location": "浙江义乌",        "seller_nick": "xxx日用百货",        "is_tmall": false      }    ]  }}

关键字段释义

similar_score：相似度分值，0~1，业务层建议阈值 0.7，低于 0.7 直接过滤，减少无效数据；
num_iid：淘宝商品 ID，用于调用taobao.item_get获取 SKU、重量、详情等完整货源信息；
is_tmall：区分天猫 / 淘宝店铺，可按需过滤。

五、图片预处理（提升匹配精度关键）

实测发现，图片质量直接决定检索结果好坏，预处理步骤：

裁剪：裁掉多余背景，商品主体居中；
去水印：图片角落水印、平台 Logo 会干扰图像特征匹配；
压缩：统一转为 JPG，压缩率 80，控制图片大小；
方向校正：清除图片旋转信息。

坑点：海外网站图片存在防盗链，直接传入远程 URL 会出现图片无法下载报错，优先下载图片本地预处理后，使用 Base64 方式上传。

六、Python 简易调用示例（伪代码）

import base64import requests
# 图片转base64def img_to_base64(img_path):    with open(img_path, "rb") as f:        data = f.read()    return base64.b64encode(data).decode("utf-8")
# 构造TOP请求，生成sign签名（省略签名实现）img_base64 = img_to_base64("overseas_product.jpg")params = {    "appkey": "your_appkey",    "timestamp": "xxx",    "img": img_base64,    "search_type":1}# 调用接口res = requests.post(top_gateway_url, data=params)result = res.json()
# 业务过滤：相似度 >=0.7candidate_list = []for item in result["items"]["item"]:    if float(item["similar_score"]) >= 0.7:        candidate_list.append(item)

七、跨境选品业务过滤规则

拿到图搜返回商品列表之后，不能直接作为选品结果，业务层二次过滤：

相似度过滤：similar_score >=0.7；
地域过滤：优先筛选支持一件代发、可跨境发货的货源地；
价格过滤：拿货价、重量，自动计算头程 + 尾程物流、平台佣金，保留毛利满足阈值的商品；
品类过滤：剔除海外平台禁售、敏感品类；
销量过滤：过滤销量过低的小众款，降低滞销风险。

八、生产环境踩坑实录

限流 429：接口 QPS 限制严格，批量图搜不能同步循环，必须使用 Redis + 异步任务队列，设置请求间隔；
签名报错：图片 Base64 内容需要参与签名计算，很多开发会遗漏，同时服务器时间戳不能偏差过大；
图片匹配不准：背景杂乱、多物体、反光图片，检索结果大量无关商品，预处理必不可少；
权限问题：个人开发者权限有限，企业项目需要在开放平台申请图像检索接口权限；
分页限制：图搜接口返回商品数量有限，不能无限翻页，业务上以高相似度优先。

九、总结

这套基于淘宝图片搜索 API 的以图搜货方案，解决跨境选品关键词检索的短板，把海外竞品图片作为检索入口，自动溯源国内货源，大幅降低人工选品工作量。

这套系统适合跨境 ERP、铺货选品、竞品供应链监控场景。开发重点在于图片预处理、限流队列控制、相似度阈值调优，并且需要和商品详情 API 联动，拿到完整货源数据，才能完成自动毛利核算。

taobao.item_get 落地实战：淘宝商品详情 API 完成电商店铺数据搬家

Mon, 28 Sep 2026 16:18:40 +0800

摘要

电商业务经常遇到店铺搬迁、系统迁移、多站点铺货等数据搬家需求：把淘宝店铺商品批量迁移到新独立站、ERP 系统、代购商城、跨境店铺。很多项目初期选择网页爬虫抓取商品信息，但爬虫会遇到页面改版、IP 封禁、脏数据、SKU 解析错乱等问题，一旦商品量大，很容易造成搬家中断、数据丢失。

本文从工程实战角度，讲解使用淘宝开放平台 taobao.item_get（淘宝商品详情 API），完成店铺商品结构化数据搬家完整流程，包含接口选型、数据模型映射、批量迁移策略、异常处理、生产踩坑总结，替代爬虫实现合规、稳定的商品数据迁移。

一、业务场景与痛点

业务场景

电商店铺数据搬家：将淘宝店铺内商品标题、价格、SKU、图片、属性、详情、库存等结构化数据，批量迁移到新系统（自研商城、ERP、跨境铺货后台、代购集运系统）。分为两种迁移模式：

全量搬家：一次性拉取店铺全部商品，初始化导入新系统
增量同步：搬家完成后，持续同步源店商品修改、上下架变动

传统爬虫方案痛点

页面 DOM 结构一旦改版，解析代码直接失效，中断搬家任务；
大批量抓取极易触发平台反爬，IP 被限制，迁移任务中断；
HTML 源码混杂大量无用标签，SKU、规格、价格提取容易出错，迁移后数据错乱；
图片防盗链，迁移后图片无法正常展示；
商用场景存在数据抓取合规风险。

API 方案优势

taobao.item_get 返回标准化 JSON 结构化数据，字段由平台统一维护，不需要解析 HTML，适合大规模店铺数据搬家。

字段稳定，页面改版不影响接口返回结构
结构化 SKU、价格、属性，迁移映射简单
可控制调用频率，风险可控
数据质量高，减少搬家后人工校对成本

二、taobao.item_get 接口基础信息

接口名称：taobao.item.get（前往 Taobaoapi2014 体验）

请求网关：c0b.cc/R4rbK2
请求方式：POST
鉴权：app_key + app_secret + 请求签名 sign

核心入参：

num_iid：淘宝商品 ID，单次请求单个商品
fields：按需选择返回字段，数据搬家场景按需勾选，减少报文体积，节约调用配额

三、整体架构设计（店铺数据搬家）

整套数据搬家服务分为 4 层：

接口调度层：读取商品 ID 列表，调用 taobao.item_get，实现签名、请求、重试、限流控制；

数据转换清洗层：对返回 JSON 做字段清洗、格式转换，完成【淘宝字段】→【目标系统字段】映射；
数据存储层：临时缓存原始 API 数据，校验后写入目标业务库；
任务监控层：记录迁移进度、失败商品清单、错误日志，支持断点续传。

迁移策略：
先拉取店铺商品 ID 清单；
分批调用 item_get，单批次控制并发，防止超限；
校验数据合法性；
写入目标系统；
记录失败商品，支持重试。

闲鱼商品详情 API 接口解析（附 JSON 样例）

Thu, 24 Sep 2026 13:47:11 +0800

摘要

在二手 ERP、鱼小铺店铺管理、二手货源监控、商品素材归档等项目开发中，很多开发者希望获取闲鱼商品结构化详情数据。这里有一个核心前提：闲鱼 TOP 开放平台没有对外提供可以随意读取全网任意陌生人商品的通用详情接口。

本文完整解析官方goodfish.item_get接口，包含接口基础信息、请求参数、返回 JSON 样例、字段释义、错误码、开发流程和线上踩坑经验。

一、接口基础信息

1.公共请求参数

参数名
类型
必填
说明
method
string
是
固定值 alibaba.idle.isv.item.query
app_key
string
是
TOP 开放平台分配的 ISV 应用密钥
timestamp
string
是
GMT+8 时区，格式yyyy‑MM‑dd HH:mm:ss；时间误差不可超过 10 分钟
v
string
是
协议版本，固定2.0
sign_method
string
是
签名算法，hmac‑sha256 /md5
sign
string
是
加密生成的签名字符串
session
string
是
店铺托管授权 OAuth session，必填，无托管授权调用直接报错

参数名	类型	必填	说明
method	string	是	固定值 alibaba.idle.isv.item.query
app_key	string	是	TOP 开放平台分配的 ISV 应用密钥
timestamp	string	是	GMT+8 时区，格式yyyy‑MM‑dd HH:mm:ss；时间误差不可超过 10 分钟
v	string	是	协议版本，固定2.0
sign_method	string	是	签名算法，hmac‑sha256 /md5
sign	string	是	加密生成的签名字符串
session	string	是	店铺托管授权 OAuth session，必填，无托管授权调用直接报错

2.接口基础信息

项目
说明
接口 Method
goodfish.item_get（前往Taobaoapi2014体验）
请求网关
c0b.cc/R4rbK2
请求方式
GET / POST，生产环境推荐 POST
鉴权方式
app_key + app_secret + OAuth session 授权；必须完成店铺托管授权
签名算法
md5 /hmac‑sha256；参数按 ASCII 字典序升序生成 sign 签名
协议版本
v2.0
返回格式
JSON / XML，项目开发优先 JSON
硬性边界
只能查询该应用托管的闲鱼 / 鱼小铺商品；外部陌生人商品直接返回查询失败；需要闲管家 ISV 服务商资质。

项目	说明
接口 Method	goodfish.item_get（前往Taobaoapi2014体验）
请求网关	c0b.cc/R4rbK2
请求方式	GET / POST，生产环境推荐 POST
鉴权方式	app_key + app_secret + OAuth session 授权；必须完成店铺托管授权
签名算法	md5 /hmac‑sha256；参数按 ASCII 字典序升序生成 sign 签名
协议版本	v2.0
返回格式	JSON / XML，项目开发优先 JSON
硬性边界	只能查询该应用托管的闲鱼 / 鱼小铺商品；外部陌生人商品直接返回查询失败；需要闲管家 ISV 服务商资质。

3.业务入参

参数名
类型
必填
说明
item_id
long
是
闲鱼商品 ID，来自托管店铺商品列表接口alibaba.idle.isv.item.list.query返回
need_sku
boolean
否
是否返回 SKU 信息，不需要传 false，减少接口响应耗时

参数名	类型	必填	说明
item_id	long	是	闲鱼商品 ID，来自托管店铺商品列表接口alibaba.idle.isv.item.list.query返回
need_sku	boolean	否	是否返回 SKU 信息，不需要传 false，减少接口响应耗时

二、返回 JSON 样例

代码语言：txt
AI代码解释
{
    "alibaba_idle_isv_item_query_response": {
        "request_id": "req‑20260924101200345678",
        "item_info": {
            "item_id": "3100123456789",
            "title": "95新 无线蓝牙耳机 降噪长续航",
            "sub_title": "个人闲置，几乎无磨损，配件齐全",
            "status": "on_sale",
            "quality": "95新",
            "price": "189.00",
            "original_price": "399.00",
            "is_fish_treasure": true,
            "is_personal": true,
            "main_images": [
                "https://img1.taobao.org/imgextra/i2/O1CN01xxx1.jpg",
                "https://img1.taobao.org/imgextra/i2/O1CN01xxx2.jpg"
            ],
            "desc": "<p>自用蓝牙耳机，95新，功能全部正常，无维修史。</p>",
            "delivery_from": "广东深圳",
            "freight_type": "buyer_pay",
            "freight_fee": 12.00,
            "browse_count": 1240,
            "want_count": 86,
            "created_time": "2026‑07‑10 15:30:22",
            "modified_time": "2026‑08‑02 09:10:11"
        }
    }
}

异常返回示例（查询非托管外部商品 / 权限不足）

代码语言：txt
AI代码解释
{
    "error_response": {
        "code":15,
        "msg":"调用失败",
        "sub_code":"TOP_NOT_CURRENT_INSPECT_ITEM",
        "sub_msg":"非当前服务商托管的商品，禁止查询",
        "request_id":"req‑20260924101300876543"
    }
}

三、核心返回字段释义

字段
释义
业务处理提示
item_id
闲鱼商品 ID
业务主键，用于和商品列表接口做数据关联
title
商品标题
二手商品标题，用于展示、本地关键词检索
sub_title
商品副标题
部分商品为空字符串，代码需要判空
status
商品状态
on_sale在售；off_sale下架；delete已删除
quality
成色
全新、99 新、95 新、9 成新、85 新等二手特有字段，部分商品为空
price
售卖价格，字符串类型
业务层转为 Decimal 做成本、利润计算
original_price
原价 / 购入价
二手划线参考价
is_fish_treasure
是否验货宝商品
二手业务核心筛选标识
is_personal
是否个人闲置
区分个人闲置商品与鱼小铺商家货源
main_images
主图图片数组
CDN 防盗链，图片链接不可直接对外引用，需下载转自有对象存储
desc
商品详情 HTML 文本
业务层清洗 HTML 标签，提取纯文本描述
delivery_from
发货地
用于评估物流时效、运费成本预估
freight_type
运费类型
seller_pay包邮，buyer_pay买家承担运费
freight_fee
运费金额
仅买家付运费场景有效
browse_count
浏览量
平台脱敏数据，仅作参考，不能当作真实访问量
want_count
想要数量
用户标记想要人数，用于评估商品热度，脱敏值
created_time
商品发布时间

modified_time
商品最后编辑时间
用于判断商品是否发生变更，做增量同步

字段	释义	业务处理提示
item_id	闲鱼商品 ID	业务主键，用于和商品列表接口做数据关联
title	商品标题	二手商品标题，用于展示、本地关键词检索
sub_title	商品副标题	部分商品为空字符串，代码需要判空
status	商品状态	on_sale在售；off_sale下架；delete已删除
quality	成色	全新、99 新、95 新、9 成新、85 新等二手特有字段，部分商品为空
price	售卖价格，字符串类型	业务层转为 Decimal 做成本、利润计算
original_price	原价 / 购入价	二手划线参考价
is_fish_treasure	是否验货宝商品	二手业务核心筛选标识
is_personal	是否个人闲置	区分个人闲置商品与鱼小铺商家货源
main_images	主图图片数组	CDN 防盗链，图片链接不可直接对外引用，需下载转自有对象存储
desc	商品详情 HTML 文本	业务层清洗 HTML 标签，提取纯文本描述
delivery_from	发货地	用于评估物流时效、运费成本预估
freight_type	运费类型	seller_pay包邮，buyer_pay买家承担运费
freight_fee	运费金额	仅买家付运费场景有效
browse_count	浏览量	平台脱敏数据，仅作参考，不能当作真实访问量
want_count	想要数量	用户标记想要人数，用于评估商品热度，脱敏值
created_time	商品发布时间
modified_time	商品最后编辑时间	用于判断商品是否发生变更，做增量同步

四、常见错误码说明

sub_code
错误说明
处理方案
TOP_NOT_CURRENT_INSPECT_ITEM
不是当前服务商托管的商品
官方接口不能访问外部陌生人店铺商品
isv.invalid‑permission
ISV 服务商权限未开通
需要申请闲管家 ISV 服务商资质，普通账号无权限调用
TOP_ITEM_QUERY_FAIL
商品查询失败，商品已删除 / 下架
捕获异常，标记本地商品为失效，停止监控
isv.missing‑parameter:itemId
缺少 item_id 入参
入参校验，保证必传参数不为空
isv.missing‑parameter:session
缺少托管授权 session
引导卖家完成店铺托管授权，获取有效 session 令牌

sub_code	错误说明	处理方案
TOP_NOT_CURRENT_INSPECT_ITEM	不是当前服务商托管的商品	官方接口不能访问外部陌生人店铺商品
isv.invalid‑permission	ISV 服务商权限未开通	需要申请闲管家 ISV 服务商资质，普通账号无权限调用
TOP_ITEM_QUERY_FAIL	商品查询失败，商品已删除 / 下架	捕获异常，标记本地商品为失效，停止监控
isv.missing‑parameter:itemId	缺少 item_id 入参	入参校验，保证必传参数不为空
isv.missing‑parameter:session	缺少托管授权 session	引导卖家完成店铺托管授权，获取有效 session 令牌

五、业务拓展联动其他 ISV 接口

goodfish.item_search_shop：托管店铺商品列表接口，批量获取店铺全部 item_id，批量拉取商品详情；

闲鱼 ISV 订单接口：读取托管店铺订goodfish.item_get

单，完成 ERP 进销存业务闭环；

AI 文本处理：对商品标题、描述进行改写，生成二手商品上架文案。

一文吃透闲鱼 API：关键词搜品 + 单品详情，搭建二手商品监控平台

Thu, 24 Sep 2026 10:09:06 +0800

摘要

很多开发者想要搭建闲鱼二手商品监控、二手选品系统，会优先寻找「关键词搜品、单品详情、整店抓取」三类能力。但很多人踩坑：混淆闲鱼 ISV 官方接口和逆向抓包接口。

整店商品列表（整店抓取：拉取本托管店铺全部商品 ID）

单品详情查询（alibaba.idle.isv.item.query 根据 item_id 获取单品详情）

店铺内关键词过滤（在自己店铺商品集合内做本地关键词筛选）

本文完整拆解闲鱼 ISV 三大合法能力，对比逆向方案，给出接口参数、JSON 样例、系统架构、开发流程、线上踩坑，帮助开发者正确评估二手监控平台可行性。

一、三大 ISV 能力接口基础信息

三大接口基础信息

能力	接口 Method	能力说明
①整店商品列表（整店抓取）	alibaba.idle.isv.item.list.query	获取当前 session 托管店铺下全部商品基础列表，拿到item_id
②单品详情查询	alibaba.idle.isv.item.query	根据item_id查询单品完整详情、成色、图片、运费等
③店铺内关键词搜品	无平台搜索 API	拿到整店商品列表后，业务服务本地内存 / 数据库做标题关键词过滤

公共请求基础信息

项目	说明
接口名称	goodfish.item_get (前往Taobaoapi2014体验)
请求方式	GET / POST，生产环境推荐 POST
请求网关	c0b.cc/R4rbK2
签名算法	md5 /hmac‑sha256；参数按 ASCII 字典序升序生成 sign 签名
协议版本	v2.0
返回格式	JSON / XML，项目优先 JSON

【整店商品列表】业务入参

参数名	类型	必填	说明
page_no	int	否	页码，起始为 1
page_size	int	否	每页最大 20 条，不可超限
status	string	否	筛选状态：on_sale在售 / off_sale下架；不传返回全部状态

整店列表 JSON 样例

{
    "alibaba_idle_isv_item_list_query_response": {
        "request_id": "req‑20260924141000123456",
        "total":42,
        "page_no":1,
        "page_size":20,
        "item_list":[
            {
                "item_id":"3100123456789",
                "title":"95新无线蓝牙耳机降噪长续航",
                "status":"on_sale",
                "quality":"95新",
                "price":"189.00",
                "is_fish_treasure":true,
                "created_time":"2026‑07‑10 15:30:22"
            },
            {
                "item_id":"3100123456790",
                "title":"机械键盘青轴游戏办公键盘",
                "status":"on_sale",
                "quality":"9成新",
                "price":"129.00",
                "is_fish_treasure":false,
                "created_time":"2026‑07‑12 10:20:11"
            }
        ]
    }
}

【单品详情】业务入参

参数名	类型	必填	说明
item_id	long	是	商品 ID，来自整店列表接口返回
need_sku	boolean	否	是否返回 SKU 信息，不需要传 false 减少耗时

单品详情 JSON 样例

{
    "alibaba_idle_isv_item_query_response": {
        "request_id": "req‑20260924141200345678",
        "item_info": {
            "item_id": "3100123456789",
            "title": "95新 无线蓝牙耳机 降噪长续航",
            "sub_title": "个人闲置，几乎无磨损",
            "status": "on_sale",
            "quality": "95新",
            "price": "189.00",
            "original_price": "399.00",
            "is_fish_treasure": true,
            "is_personal": true,
            "main_images": [
                "https://img1.taobao.org/imgextra/i2/O1CN01xxx1.jpg",
                "https://img1.taobao.org/imgextra/i2/O1CN01xxx2.jpg"
            ],
            "desc": "<p>自用蓝牙耳机，95新，功能全部正常，配件齐全。</p>",
            "delivery_from": "广东深圳",
            "freight_type": "buyer_pay",
            "freight_fee": 12.00,
            "browse_count": 1240,
            "want_count": 86,
            "created_time": "2026‑07‑10 15:30:22",
            "modified_time": "2026‑08‑02 09:10:11"
        }
    }
}

二、核心返回字段释义

字段	释义	业务处理提示
item_id	闲鱼商品 ID	业务主键，列表与详情接口关联主键
title	商品标题	用于本地关键词过滤、展示
status	商品状态	on_sale在售；off_sale下架；delete已删除
quality	成色	全新、99 新、95 新、9 成新等二手特有字段，部分商品为空，需要判空
price	售卖价格字符串	业务层转为 Decimal 做成本计算
is_fish_treasure	是否验货宝商品	二手业务重要筛选标识
main_images	主图数组	CDN 防盗链，必须下载转自有对象存储，不可直接对外引用
freight_type	运费类型	seller_pay包邮，buyer_pay买家付运费
browse_count/want_count	浏览、想要数	平台脱敏数据，仅做参考，不能当作绝对真实热度

三、常见错误码说明

sub_code	错误说明	处理方案
TOP_NOT_CURRENT_INSPECT_ITEM	不是当前服务商托管商品	官方接口不能访问外部陌生人店铺商品
isv.invalid‑permission	ISV 服务商权限未开通	需要闲管家 ISV 服务商资质，普通账号无权限
TOP_ITEM_QUERY_FAIL	商品查询失败，已删除 / 下架	捕获异常，标记本地商品失效，停止监控该商品
isv.missing‑parameter:session	缺少托管授权 session	必须完成店铺托管授权拿到有效 token

四、业务拓展联动其他 ISV 接口

闲鱼 ISV 订单接口：读取托管店铺订单，完成 ERP 进销存闭环；

商品变更消息回调：订阅商品上下架、价格变更推送，减少轮询调用；

AI 能力：标题、描述改写，生成二手商品上架文案。

淘宝天猫商品评论 API 接口解析（附 JSON 样例）

Wed, 23 Sep 2026 15:16:52 +0800

摘要

在竞品调研、商品口碑分析、选品系统、产品优化分析业务中，需要获取淘宝、天猫商品用户评价、晒图、追评、商家回复数据。很多项目会尝试爬虫抓取评论区，但页面动态渲染、签名加密、IP 风控、分页规则频繁变更，爬虫维护成本极高，还存在合规风险。

淘宝开放平台 TOP 提供taobao.item.reviews.get商品评论接口，可以合规获取商品公开评价数据，返回评分、评论文本、晒图、SKU 规格、追评、商家回复等脱敏结构化数据。本文从方案选型、接口基础、请求参数、Json样例、字段释义、错误码、开发流程、生产踩坑完整解析。

一、接口基础信息

1.接口简介

项目	说明
接口 Method	taobao.item.reviews.get（前往Taobaoapi2014体验）
请求网关	c0b.cc/R4rbK2
请求方式	GET / POST，生产环境推荐 POST
鉴权方式	app_key + app_secret；部分店铺私有评价需要 OAuth session 授权
签名算法	md5 /hmac‑sha256，参数按 ASCII 字典序升序生成 sign 签名
协议版本	v2.0
返回格式	JSON / XML，项目开发优先 JSON
硬性数据边界	仅返回近 180 天评论；基础权限 page_size 最大 20；单商品存在最大可拉取页数上限；用户昵称脱敏输出

2.公共请求参数

参数名	类型	必填	说明
method	string	是	固定值 taobao.item.reviews.get
app_key	string	是	开放平台分配的应用密钥
timestamp	string	是	GMT+8 时区，格式yyyy‑MM‑dd HH:mm:ss；时间误差不可超过 10 分钟
v	string	是	协议版本，固定2.0
sign_method	string	是	签名算法，hmac‑sha256 /md5
sign	string	是	加密生成的签名字符串
session	string	否	读取店铺私有评价时需要 OAuth 授权 session，公开商品评价一般不需要

3.业务入参

参数名	类型	必填	说明
num_iid	long	是	淘宝 / 天猫商品宝贝 ID，从商品链接提取
page_no	int	否	分页页码，起始为 1
page_size	int	否	单页条数，基础权限最大 20，不可超限

二、返回 JSON 样例

{
    "item_reviews_get_response": {
        "request_id": "req‑20260923162000789456",
        "total_results": 856,
        "page_no": 1,
        "page_size": 20,
        "reviews": [
            {
                "review_id": "7295689452365896235",
                "display_user_nick": "小***柚",
                "is_anonymous": false,
                "content": "面料柔软，尺码标准，做工精细，性价比很高",
                "score": 5,
                "created": "2026‑04‑12 09:22:36",
                "auction_sku": "颜色:黑色;尺码:XL",
                "useful_count": 36,
                "pic_urls": [
                    "https://img.alicdn.com/imgextra/i1/O1CN01xxxxxx1.jpg",
                    "https://img.alicdn.com/imgextra/i1/O1CN01xxxxxx2.jpg"
                ],
                "is_append": false,
                "append_content": "",
                "append_time": "",
                "seller_reply": "感谢亲的认可，我们会继续把控产品品质，期待您再次光临！"
            },
            {
                "review_id": "7295689452365896236",
                "display_user_nick": "用***户",
                "is_anonymous": false,
                "content": "面料偏薄，夏天穿尚可，包装比较简单",
                "score": 3,
                "created": "2026‑04‑15 16:10:22",
                "auction_sku": "颜色:白色;尺码:L",
                "useful_count": 12,
                "pic_urls": [],
                "is_append": true,
                "append_content": "使用半个月，没有起球，整体还行。",
                "append_time": "2026‑04‑25 11:30:10",
                "seller_reply": "非常抱歉没能让您完全满意，我们会优化包装工艺。"
            }
        ]
    }
}

异常返回示例（商品不存在 / 无权限）

{
    "error_response": {
        "code":15,
        "msg":"调用失败",
        "sub_code":"isv.invalid‑permission",
        "sub_msg":"接口权限不足，请申请taobao.item.reviews.get接口权限",
        "request_id":"req‑20260923162100123456"
    }
}

三、核心返回字段释义

字段	释义	业务处理提示
review_id	评论唯一 ID	去重、增量采集主键
display_user_nick	脱敏买家昵称	全部脱敏，无法拿到完整昵称
is_anonymous	是否匿名评价	布尔值
content	评价正文	用于文本分析、口碑统计
score	评价评分，1‑5 分	统计好评、中评、差评分布
created	评价创建时间	注意：仅近 180 天数据有效
auction_sku	对应购买 SKU 规格	关联商品 SKU 做维度分析
useful_count	评论点赞有用数	辅助判断评论参考价值
pic_urls	晒图图片数组	CDN 防盗链，需要下载转自有存储
is_append	是否存在追评	true 代表存在追加评价
append_content	追评内容	追评为空则为空字符串
append_time	追评时间	无追评时为空
seller_reply	商家回复内容	为空代表商家未回复

四、生产环境高频踩坑总结

权限单独申请：该接口不是应用默认开通，必须手动提交权限申请，未申请直接返回权限不足错误。

分页终止条件：不要只依赖 total_results，以reviews数组为空作为循环结束条件。

180 天时间限制：接口不会返回 180 天之前的历史评价，业务不要做超期数据预期。

晒图防盗链：pic_urls图片链接不能直接对外引用，必须下载转自有对象存储。

追评判空：is_append为 false 时，append_content、append_time为空字符串，代码做空判断。

严格控制 QPS：评论接口配额较低，高频批量采集极易 429 限流，建议引入任务队列。

用户隐私脱敏：返回昵称全部脱敏，不会返回手机号、完整用户 ID，业务不要做逆向解析。

商品下架处理：商品删除 / 下架，捕获ITEM_NOT_FOUND错误，标记本地商品，停止该商品评论采集。

五、业务拓展：多接口联动

taobao.item.get商品详情接口：商品基础信息与评论数据做关联分析；

NLP 大模型：对评论文本做情感分析、提取用户痛点关键词；

定时增量任务：定时拉取新增评论，只同步新产生评价，减少接口调用消耗。

六、适用业务场景

竞品口碑分析：抓取竞品评论，挖掘用户痛点、好评亮点，辅助产品差异化定位。

选品系统：根据评分、差评占比辅助货源筛选。

产品优化：提取评论高频反馈，用于产品、包装改良。

舆情监控：自有店铺商品差评预警。

NLP 文本分析：对评论做情感分析，构建商品口碑仪表盘。

淘宝天猫商品详情 API 接口解析（附 JSON 样例）

Wed, 23 Sep 2026 14:25:41 +0800

摘要

在电商 ERP 开发、竞品监控、货源选品、跨平台铺货等业务中，经常需要获取淘宝、天猫商品完整结构化信息。很多项目初期选择网页爬虫抓取详情页，但会遇到页面 DOM 改版、验证码拦截、IP 风控、HTML 脏数据清洗困难等一系列问题，长期维护成本很高。

淘宝开放平台 TOP 提供taobao.item.get商品详情API，支持获取淘宝、天猫公开商品的标题、价格、SKU、图集、属性、店铺、销量等标准化 JSON数据。本文完整解析接口基础信息、请求参数、返回字段，附带正常 / 异常 JSON 样例、调用流程、错误码与生产踩坑经验。

一、接口基础信息

1. 接口介绍

taobao .item_get（淘宝天猫商品详情 API），输入参数为商品唯一 ID num_iid，返回完整商品详情结构化 JSON 数据。

接口简介

接口名称：taobao.item_get（淘宝商品详情API，taobaoapi2014前往体验）

请求网关： c0b.cc/R4rbK2 （HTTPS，支持 GET/POST）

接口版本：2.0

调用限制：存在单秒频次、每日调用配额，高频场景需做限流、缓存处理。

核心作用：根据商品 ID，获取商品标题、价格、SKU、库存、图文、类目、销量、规格属性等全量详情数据。

接口能力覆盖

商品基础元数据：标题、售价、划线价、销量、库存、发货地

多媒体资源：主图、轮播图、HTML 详情描述

SKU 规格集合：多规格价格、库存、规格文本

商品属性参数：材质、尺码、品牌等类目属性

店铺信息：店铺 ID、店铺昵称、店铺类型

营销促销信息：活动价、优惠券标签

2.适用业务场景

ERP 系统：定时同步商品，监控价格、库存变动
竞品分析：采集竞品商品基础信息，做价格波动监测
货源选品：提取标题、规格、图片做市场品类分析
跨平台铺货：清洗商品素材用于其他平台刊登
电商数据中台：对外输出标准化商品数据源

二、请求核心参数

公共请求参数

参数名	类型	是否必填	说明
method	string	是	固定taobao.item.get
app_key	string	是	开放平台分配应用密钥
timestamp	string	是	GMT+8 时区，格式yyyy‑MM‑dd HH:mm:ss；时间误差不可超过 10 分钟
v	string	是	协议版本，固定2.0
sign_method	string	是	签名算法，hmac‑sha256 /md5
sign	string	是	加密生成签名字符串
session	string	否	商家私有数据，需要 OAuth 授权获取 session

业务入参

参数名	类型	是否必填	说明
num_iid	long	是	淘宝 / 天猫商品宝贝 ID，从商品链接提取淘宝开放平...
fields	string	是	指定返回字段，逗号分隔；按需配置，不要全量获取，减少报文体积

三、完整 JSON 样例

{
    "item_get_response": {
        "request_id": "req‑20260923141000123456",
        "item": {
            "num_iid": "721456789234",
            "title": "夏季速干运动短袖男士透气健身T恤",
            "cid": 50015261,
            "pic_url": "https://img.alicdn.com/imgextra/i1/xxxx.jpg",
            "item_imgs": [
                {"url":"https://img.alicdn.com/imgextra/i1/xxx1.jpg"},
                {"url":"https://img.alicdn.com/imgextra/i1/xxx2.jpg"}
            ],
            "price": "69.00",
            "orginal_price": "129.00",
            "num": 5200,
            "sales": 3680,
            "seller_nick": "运动服饰旗舰店",
            "seller_id": "234567891",
            "location": "浙江杭州",
            "list_time": "2026‑03‑15 10:20:00",
            "desc": "<p>面料采用速干面料，适合跑步健身运动</p>",
            "props": "面料:聚酯纤维;版型:宽松",
            "skus": {
                "sku": [
                    {
                        "sku_id": "3214567890123",
                        "properties": "颜色:黑色;尺码:L",
                        "price": "69.00",
                        "quantity": 1200
                    },
                    {
                        "sku_id": "3214567890124",
                        "properties": "颜色:白色;尺码:XL",
                        "price": "69.00",
                        "quantity": 860
                    }
                ]
            }
        }
    }
}

四、核心返回字段释义

字段	释义	业务处理提示
num_iid	商品宝贝 ID	业务主键，用于重复调用，关联商品列表接口
title	商品标题	展示、AI 翻译、生成铺货标题
cid	商品类目 ID	类目筛选、市场统计分析
pic_url	商品主图	阿里 CDN 图片带防盗链，需下载转存自有对象存储
item_imgs	商品轮播图集	多图素材来源
price	销售价格	字符串类型，业务层转为 Decimal 做成本计算
orginal_price	划线原价	市场价展示使用
num	商品总库存	汇总库存；SKU 粒度库存读取 skus 数组
sales	商品销量	选品热度评估指标
seller_nick	卖家店铺昵称	店铺标识
location	发货地	供应链评估发货时效
desc	商品详情 HTML	业务清洗 HTML 标签提取纯文本
skus.sku	SKU 规格数组	循环解析；下架、特殊类目务必判空，防止数组越界

五、常见错误码说明

sub_code	错误说明	处理方案
isv.item‑get‑service‑error:ITEM_NOT_FOUND	未找到宝贝，商品删除 / 违规下架	捕获错误，本地标记商品失效，不再重试
isv.missing‑parameter:iid‑or‑numIid	缺少 num_iid 参数	入参校验，保证必传字段不为空
isp.system‑busy	调用频率过高，系统繁忙	降低 QPS，增加休眠、队列限流
isv.invalid‑permission	接口权限不足	检查应用是否申请该接口权限

六、生产环境高频踩坑总结

fields 参数必填：忘记填写 fields 直接返回空数据，不要请求无用字段。
签名调试困难：参数排序错误、时区时间戳偏差，是签名失败最高发原因，时间必须 GMT+8，误差不超过 10 分钟。
图片防盗链：alicdn 图片链接不可直接对外引用，必须下载转存自有存储。
SKU 判空容错：下架、特殊类目商品 skus 节点结构会变化，代码做空判断，避免数组越界崩溃。
QPS 调用超限：超过应用配额返回限流错误；批量同步做队列休眠、流量控制。
商品下架删除：捕获ITEM_NOT_FOUND错误码，标记本地缓存数据失效，避免无效循环重试。

微店商品列表 API 接口解析（附 JSON 样例）

Tue, 22 Sep 2026 11:18:57 +0800

摘要

在私域 ERP 系统、多店铺统一管理、店铺商品搬家、分销货源同步业务场景，需要批量获取微店店铺下全部商品清单，拿到商品 ID 之后再调用商品详情接口获取完整 SKU、图文、分销佣金等信息。

很多开发人员前期会直接抓取 H5 网页，但是微店前端页面频繁迭代、JS 动态渲染、账号风控、图片防盗链，爬虫维护成本高，并且存在合规风险。微店开放平台提供官方店铺商品列表接口weidian.item.shop.list.get，通过商家 OAuth 授权，分页返回店铺商品基础列表数据，是生产环境替代爬虫的标准化方案。

一、接口基础信息

micro.item_search 微店商品列表搜索接口，作为商品批量检索入口，输入关键词或类目 ID 获取微店商品摘要集合。

接口标识：micro.item_search （微店京东商品列表api，taobaoapi2014前往体验）

请求网关： c0b.cc/R4rbK2 （HTTPS，支持 GET/POST）

接口版本：2.0

接口能力覆盖

商品基础元数据：标题、售卖价、划线价、销量

店铺信息：店铺 ID、店铺名称，区分自营 / POP 店铺

辅助标记：广告商品标识、类目信息、发货地、自营标识

接口能力：获取指定店铺 / 类目下商品 SPU、SKU 列表，包含商品标题、SKU 编号、上下架状态、主图、价格、类目等基础信息。

适用业务场景

私域 ERP：定时同步授权店铺全部商品，监控上下架、价格变动

店铺搬家导出：批量获取店铺product_id，后续调用详情接口导出完整商品，迁移到其他平台

分销选品系统：拉取分销店铺商品列表，筛选高佣金货源

多店铺管理后台：聚合多家微店商品档案，做统一商品巡检

联动微店商品详情 API：列表拿到product_id入任务队列，异步拉取完整商品详情

二、请求核心参数

参数名	类型	是否必填	说明
app_key	string	是	开放平台应用密钥
method	string	是	固定`weidian.item.shop.list.get`
timestamp	long	是	13 位毫秒时间戳
version	string	是	固定`1.0`
format	string	是	固定`json`
access_token	string	是	店铺 OAuth 授权令牌，token 与店铺一一绑定
sign	string	是	HMAC‑SHA256 生成大写签名串
param_json	string	是	业务参数 JSON 字符串

三、完整 JSON 返回样例

{
    "code": 0,
    "msg": "success",
    "request_id": "wd20260922100500992233",
    "data": {
        "total": 86,
        "page_no": 1,
        "page_size": 10,
        "total_page": 9,
        "item_list": [
            {
                "product_id": "726589421001",
                "title": "复古棉麻文艺连衣裙 女夏季宽松中长款裙子",
                "sub_title": "透气棉麻｜多色可选",
                "shop_id": "158923601",
                "is_on_sale": 1,
                "publish_time": "2026‑04‑10 14:20:30",
                "price_cent": 12900,
                "market_price_cent": 19900,
                "total_stock": 2600,
                "total_sales": 3280,
                "is_free_shipping": false,
                "commission_rate": 12,
                "main_image": "https://img.weidian.com/kf/Haa1xxx.jpg"
            },
            {
                "product_id": "726589421002",
                "title": "简约帆布手提包 学生大容量托特包",
                "sub_title": "耐磨防水 多颜色可选",
                "shop_id": "158923601",
                "is_on_sale": 1,
                "publish_time": "2026‑05‑02 09:15:10",
                "price_cent": 4900,
                "market_price_cent": 8900,
                "total_stock": 5200,
                "total_sales": 6120,
                "is_free_shipping": true,
                "commission_rate": 10,
                "main_image": "https://img.weidian.com/kf/Hbb2xxx.jpg"
            }
        ]
    }
}

四、高频开发踩坑实录

价格单位混淆：列表接口返回价格单位是分，忘记除以 100，业务价格放大 100 倍；

token 跨店铺调用：A 店铺 access_token 不能读取 B 店铺，返回空数据；

时间戳错误：必须 13 位毫秒时间戳，秒级时间戳直接签名校验失败；

业务参数放外层：业务分页、状态参数必须放在param_json字符串内部，不能散落在外层公共参数；

分页超限：page_size最大 50，传入大于 50 的值会被平台截断；

token 过期失效：access_token 具备有效期，业务系统必须做预刷新，不能硬编码 token；

列表库存为汇总值：列表返回total_stock是汇总库存，想要每个 SKU 真实库存，必须调用商品详情接口；

下架商品字段残缺：is_on_sale=2下架商品部分字段为空，代码增加判空逻辑；

QPS 限流：批量全店同步任务，需要增加请求间隔，避免 429 限流报错。

五、业务拓展联动其他接口

拿到商品列表product_id集合之后，可以联动：

微店商品详情 API weidian.item.detail.get：获取 SKU、完整图文、分销详情；

AI 大模型：对商品标题、素材做改写、翻译，生成分销文案。

全球电商数据接口&反向海淘系统

taobao.items.search 落地实战：利用淘宝商品列表 API 构建跨境电商选品系统

一、业务背景：跨境选品的痛点

二、系统整体架构

三、taobao.items.search 接口核心参数说明

四、请求示例 & JSON 返回样例

请求参数示例

返回 JSON 样例

五、Python 简易调用示例（伪代码）

六、跨境选品业务过滤逻辑（核心）

七、生产环境踩坑实录

淘宝图片搜索 API 落地实战：基于以图搜货搭建跨境电商选品系统

摘要

一、业务背景与痛点

二、系统整体架构

三、接口基础信息

核心请求参数

四、返回 JSON 样例（简化）

五、图片预处理（提升匹配精度关键）

六、Python 简易调用示例（伪代码）

七、跨境选品业务过滤规则

八、生产环境踩坑实录

九、总结

taobao.item_get 落地实战：淘宝商品详情 API 完成电商店铺数据搬家

摘要

一、业务场景与痛点

业务场景

传统爬虫方案痛点

API 方案优势

二、taobao.item_get 接口基础信息

三、整体架构设计（店铺数据搬家）

闲鱼商品详情 API 接口解析（附 JSON 样例）

摘要

一、接口基础信息

1.公共请求参数

2.接口基础信息

3.业务入参

二、返回 JSON 样例

三、核心返回字段释义

四、常见错误码说明

五、业务拓展联动其他 ISV 接口

一文吃透闲鱼 API：关键词搜品 + 单品详情 ，搭建二手商品监控平台

摘要

一、三大 ISV 能力接口基础信息

三大接口基础信息

公共请求基础信息

【整店商品列表】业务入参

整店列表 JSON 样例

【单品详情】业务入参

单品详情 JSON 样例

二、核心返回字段释义

三、常见错误码说明

四、业务拓展联动其他 ISV 接口

淘宝天猫商品评论 API 接口解析（附 JSON 样例）

摘要

一、接口基础信息

1.接口简介

2.公共请求参数

3.业务入参

二、返回 JSON 样例

三、核心返回字段释义

四、生产环境高频踩坑总结

五、业务拓展：多接口联动

六、适用业务场景

淘宝天猫商品详情 API 接口解析（附 JSON 样例）

摘要

一、接口基础信息

1. 接口介绍

2.适用业务场景

二、请求核心参数

公共请求参数

业务入参

三、完整 JSON 样例

四、核心返回字段释义

五、常见错误码说明

六、生产环境高频踩坑总结

微店商品列表 API 接口解析（附 JSON 样例）

摘要

一、接口基础信息

一文吃透闲鱼 API：关键词搜品 + 单品详情，搭建二手商品监控平台