万邦api博客

小红书笔记详情API介绍、应用场景及JSON返回示例

Thu, 18 Jun 2026 10:33:48 +0800

一、接口概述

小红书笔记详情API是用于获取单条小红书笔记完整数据的接口。通过传入笔记ID，可获取笔记标题、正文、图片视频、发布时间、标签、作者信息、点赞收藏评论等全部公开数据。接口采用Token鉴权、HTTPS请求，是小红书内容分析最常用的基础接口。

二、主要业务场景

爆款笔记分析：拆解热门笔记文案、标签、互动数据，总结爆款规律。
竞品监控：实时监控竞品发布的种草笔记、数据表现。
达人数据分析：统计单篇笔记互动率，判断达人带货质量。
品牌口碑采集：收集用户真实种草、评价，用于产品优化。
内容素材整理：批量获取图文素材、文案用于运营参考。

三、JSON返回实战示例（简洁标准）

成功返回

{
  "code": 200,
  "msg": "success",
  "data": {
    "note_id": "649c46ab000000002702ad36",
    "title": "秋冬保湿面霜推荐｜干皮救命神器",
    "content": "质地水润超好吸收，保湿持久不闷痘，干皮秋冬必备！",
    "create_time": 1745001234,
    "note_type": "image",
    "tags": ["护肤", "面霜", "干皮保湿"],
    "images": [
      "https://sns-img.xhscdn.com/xxx1.jpg",
      "https://sns-img.xhscdn.com/xxx2.jpg"
    ],
    "video_url": "",
    "like_count": 5200,
    "collect_count": 3100,
    "comment_count": 420,
    "share_count": 130,
    "author": {
      "user_id": "u12345678",
      "nickname": "护肤小达人",
      "fans_count": 98000
    }
  }
}

错误返回示例

// 令牌失效
{
  "code": 401,
  "msg": "token invalid"
}

// 请求限流
{
  "code": 429,
  "msg": "request too frequent"
}

// 笔记不存在
{
  "code": 400,
  "msg": "note id error"
}

四、核心字段说明

note_id：笔记唯一标识，请求必填参数
title、content：笔记标题和正文内容
note_type：笔记类型，图文/视频
images、video_url：素材地址
tags：笔记话题标签
like/collect/comment：笔记各项互动数据
author：作者账号信息与粉丝量
create_time：发布时间戳

五、开发注意事项

接口需Token鉴权，调用频率有限制，高频请求会触发429限流；图片、视频字段可能为空，开发时需做容错处理；时间戳需要格式化展示。所有数据仅可用于合规数据分析。

京东商品详情 API 介绍、业务场景与完整 JSON 返回参考

Wed, 17 Jun 2026 15:14:27 +0800

一、接口简介

京东商品详情 API（联盟接口jd.union.open.goods.detail.query、商家接口jingdong.item.read.get），通过 SKU 编号查询商品完整信息，HTTPS 签名鉴权，返回标准 JSON，可获取价格、库存、SKU 规格、图片、店铺、销量、参数等全量商品数据，是合规获取京东商品数据的核心接口。

二、主流业务实战场景

竞品价格监控
定时抓取同行商品原价、促销价、优惠券，设置降价预警，及时调整自身定价与活动。
导购 / 比价工具开发
同步商品图片、售价、佣金链接，搭建好物推荐、全网比价小程序。
商家 ERP 商品同步
店铺后台批量拉取商品参数、规格、库存，自动同步到进销存系统。
市场选品分析
依据销量、好评率、规格库存，筛选潜力爆款，辅助采购与上新。
内容带货素材采集
提取商品主图、卖点、参数，用于短视频、图文带货内容制作。

三、完整 JSON 返回示例

成功返回数据

json

{

    "code": "0",
    "msg": "success",
    "result": {
        "skuId": "100065474274",
        "title": "夏季纯棉宽松短袖女百搭纯色基础T恤",
        "brandName": "简禾",
        "categoryName": "女装>T恤",
        "shopName": "简禾官方旗舰店",
        "shopType": "第三方店铺",
        "originalPrice": "79.90",
        "discountPrice": "59.00",
        "promotionInfo": "满99减20，两件8折",
        "salesInfo": {
            "totalSales": 9650,
            "monthSales": 2360
        },
        "stockInfo": {
            "totalStock": 460,
            "isSale": true
        },
        "imageInfo": {
            "mainImg": "https://img.jd.com/imgextra/i1/xxx_main.jpg",
            "detailImgList": [
                "https://img.jd.com/imgextra/i1/xxx_1.jpg",
                "https://img.jd.com/imgextra/i1/xxx_2.jpg"
            ]
        },
        "skuList": [
            {
                "skuId": "10006547427401",
                "specText": "白色 M",
                "skuPrice": "59.00",
                "skuStock": 180
            },
            {
                "skuId": "10006547427402",
                "specText": "黑色 XL",
                "skuPrice": "59.00",
                "skuStock": 125
            }
        ],
        "productParams": [
            {"name": "面料", "value": "100%纯棉"},
            {"name": "版型", "value": "宽松常规"}
        ],
        "commentSummary": {
            "goodRate": "96.5%",
            "totalComment": 1420
        },
        "itemUrl": "https://item.jd.com/100065474274.html"
    }}

异常错误返回

json

// 接口权限未开通{

    "code": "403",
    "msg": "暂无该接口调用权限，请前往开放平台申请"}// 调用频率超限限流{
    "code": "429",
    "msg": "请求过于频繁，请间隔3秒后重试"}// SKU编号不存在{
    "code": "400",
    "msg": "skuId无效，商品已下架或编号错误"}

四、核心字段简单说明

基础信息
skuId：商品唯一标识；title商品标题；brandName品牌；shopName店铺名称
价格促销
originalPrice原价；discountPrice实时售价；promotionInfo活动说明
销量库存
totalSales总销量；totalStock总库存；isSale是否正常售卖
规格素材
skuList所有尺码颜色规格；mainImg主图；detailImgList详情多图
口碑数据
goodRate好评率；totalComment商品总评价数

五、简易开发注意事项

依靠skuId作为查询与数据去重唯一主键；
解析图片、SKU 数组时做好空值判断，防止程序报错；
接口存在 QPS 限制，批量采集需增加请求间隔；
库存数据存在轻微延迟，不能作为精准实时备货依据。

京东商品评论 API 实战：业务场景与完整 JSON 返回参考

Tue, 16 Jun 2026 17:01:03 +0800

一、接口简介

京东商品评论核心接口 jd.union.open.goods.review.list.get，基于宙斯开放平台，采用 HTTPS+OAuth2.0 鉴权，支持分页查询商品评价、晒图、追评、商家回复、评论标签与口碑统计，是合规获取京东用户口碑数据的标准接口。

二、主流实战业务场景

店铺口碑监控
实时抓取本店差评、晒单负面评价，关键词预警，客服及时介入处理，降低售后纠纷。
竞品调研分析
批量采集竞品评论，提取用户痛点、好评卖点，对比好评率、高频标签，制定产品差异化策略。
产品迭代优化
汇总评论里材质、尺寸、功能相关反馈，给研发、品控提供真实用户数据，优化商品做工与规格。
运营素材提取
收集优质晒图、好评文案、真实使用感受，用作商品详情、短视频带货素材。
数据报表统计
自动计算好评率、晒单率、追评占比，生成每日商品口碑看板。

三、完整 JSON 返回示例

1. 请求成功返回（脱敏完整版）

json

{

    "code": "0",
    "msg": "success",
    "result": {
        "skuId": "100065474274",
        "total": 1568,
        "page": 1,
        "pageSize": 10,
        "productCommentSummary": {
            "goodRateShow": 96.8,
            "commentCount": 1568,
            "goodCount": 1518,
            "generalCount": 30,
            "poorCount": 20
        },
        "hotCommentTagStatistics": [
            {"name": "物流快", "count": 860},
            {"name": "质量好", "count": 720},
            {"name": "性价比高", "count": 610}
        ],
        "comments": [
            {
                "id": 12345678901,
                "nickname": "jd_小***柚",
                "score": 5,
                "content": "做工扎实，京东物流次日达，包装完整没有破损，推荐购买",
                "creationTime": "2026-05-20 15:30:22",
                "skuName": "黑色 XL",
                "images": [
                    "https://img.jd.com/imgextra/xxx1.jpg",
                    "https://img.jd.com/imgextra/xxx2.jpg"
                ],
                "usefulVoteCount": 36,
                "isAppend": true,
                "afterContent": "使用半个月，没有掉色变形，很满意",
                "replyContent": "感谢您的认可，我们会持续把控品质！"
            },
            {
                "id": 12345678902,
                "nickname": "j***9",
                "score": 3,
                "content": "尺码偏大，面料偏薄，日常穿勉强够用",
                "creationTime": "2026-05-22 10:11:10",
                "skuName": "白色 L",
                "images": [],
                "usefulVoteCount": 12,
                "isAppend": false,
                "afterContent": "",
                "replyContent": ""
            }
        ]
    }}

2. 接口异常返回（限流 / 权限错误）

json

// 权限不足{

    "code": "403",
    "msg": "接口权限未开通，请在开放平台申请权限"}// 调用超限限流{
    "code": "429",
    "msg": "请求频率过高，请间隔一段时间重试"}

四、核心字段简要说明

汇总统计层

goodRateShow：商品好评率
commentCount：商品总评论数量
hotCommentTagStatistics：高频评价标签，用于用户痛点统计

单条评论核心

id：评论唯一 ID，用于数据去重
score：星级 1-5，1/2 差评、3 中评、4/5 好评
content：用户原始评价文字
creationTime：评论发布时间
skuName：下单规格（颜色 / 尺寸）
images：晒图地址数组
isAppend：是否存在追评
afterContent：追加评论内容
replyContent：商家回复内容

五、简单开发提示

分页依靠 page、pageSize，单页最大 50 条；
解析时判断 images、afterContent 空值，避免程序报错；
接口存在 QPS 限制，批量采集需增加间隔；
数据仅可自用分析，禁止倒卖用户评论隐私。

小红书笔记评论 API：核心场景与 JSON 返回示例

Mon, 15 Jun 2026 15:14:37 +0800

一、接口简介

小红书笔记评论 API 是开放平台核心数据接口，基于HTTPS+Token 鉴权，用游标分页获取笔记下主评论、楼中楼、用户信息与互动数据，是舆情监控、内容分析、竞品调研的合规数据渠道。

二、核心实战场景

品牌舆情监控：实时抓取品牌相关笔记评论，识别 “过敏、假货、拔草” 等负面词，触发预警；统计正负向口碑占比，生成日报。
竞品爆款拆解：批量拉取竞品热门笔记评论，提炼高频痛点与种草关键词，反推自家内容选题与产品优化方向。
达人合作评估：统计达人笔记评论量、互动率、“求链接” 转化意愿，量化合作效果，辅助达人筛选。
内容运营优化：从评论挖掘高频问题（如 “油皮能用吗”），优化笔记置顶引导与内容补充，提升转化率。
用户 FAQ 收集：整理评论区常见疑问（价格、用法、肤质适配），构建知识库，提升客服效率。

三、实战 JSON 返回示例（成功 + 失败）

1. 成功返回（完整脱敏样例）

json

{

    "code": 200,
    "msg": "success",
    "request_id": "req_202606151420001234",
    "data": {
        "note_id": "649c46ab000000002702ad36",
        "total_comment": 1256,
        "cursor": "crs_20260615_001",
        "has_more": true,
        "comments": [
            {
                "comment_id": "com_1122334455",
                "content": "油皮亲妈！上脸清爽不闷痘，已囤两瓶🥰",
                "create_time": 1744289620,
                "like_count": 326,
                "reply_count": 18,
                "is_top": true,
                "user": {
                    "user_id": "u_589abc789",
                    "nickname": "油痘肌避雷君",
                    "avatar": "https://sns-avatar-qc.xhscdn.com/avatar/abc123.jpg"
                },
                "reply_comments": [
                    {
                        "comment_id": "rpl_667788",
                        "content": "敏感肌能用吗？",
                        "create_time": 1744289700,
                        "like_count": 45,
                        "user": {
                            "nickname": "敏感肌小C"
                        }
                    }
                ]
            },
            {
                "comment_id": "com_6677889900",
                "content": "求链接！多少钱入的？",
                "create_time": 1744290100,
                "like_count": 89,
                "reply_count": 6,
                "is_top": false,
                "user": {
                    "user_id": "u_123def456",
                    "nickname": "草莓奶盖不加糖",
                    "avatar": "https://sns-avatar-qc.xhscdn.com/avatar/def456.jpg"
                },
                "reply_comments": []
            }
        ]
    }}

2. 失败返回（常见错误）

（1）Token 失效（code=401）

json

{

    "code": 401,
    "msg": "Invalid or expired token",
    "request_id": "req_202606151420005678"}

（2）接口限流（code=429）

json

{

    "code": 429,
    "msg": "Too many requests, please try again later",
    "request_id": "req_202606151420009012"}

四、关键字段说明

表格

字段	说明
`note_id`	笔记唯一 ID（请求必传）
`total_comment`	笔记总评论数
`cursor`	分页游标（下一页请求参数）
`has_more`	是否有下一页（true/false）
`comment_id`	评论唯一 ID
`content`	评论正文
`create_time`	评论时间（Unix 时间戳，需格式化）
`like_count`	评论点赞数
`reply_count`	评论回复数
`is_top`	是否置顶评论
`user.nickname`	评论者昵称（脱敏）
`reply_comments`	楼中楼子评论数组

五、开发要点

分页规则：用cursor翻页，循环至has_more=false，单页最大 50 条。
时间处理：create_time为时间戳，需转yyyy-MM-dd HH:mm:ss。
限流规避：控制 QPS，加缓存，避免高频调用触发 429。
合规提醒：仅用于授权数据采集，禁止爬虫非公开数据。

淘宝评论 API 实战场景与 JSON 返回参考

Fri, 12 Jun 2026 15:07:03 +0800

一、接口简介

淘宝评论 API（taobao.item.reviews.get）用于根据商品 ID 获取用户评价、评分、晒图、追评、卖家回复等数据，支持分页查询，是电商运营、竞品分析、口碑监控的常用接口。

二、常见实战业务场景

差评实时监控：及时发现低分评价，快速处理售后，降低店铺纠纷。
竞品口碑分析：抓取竞品评论，提取用户痛点与好评点，优化自身产品。
商品优化迭代：根据用户真实反馈，改进款式、质量、详情页描述。
晒图 / 买家秀采集：收集优质买家秀，用于详情页、短视频素材。
好评率统计：生成店铺 / 商品口碑数据，辅助运营决策。

三、真实 JSON 返回示例

json

{

    "item_reviews_get_response": {
        "total_results": 865,
        "reviews": [
            {
                "review_id": "123456789012345",
                "user_nick": "用***户",
                "content": "面料舒服，尺码标准，发货快，很满意",
                "score": 5,
                "created": "2026-06-01 14:25:33",
                "auction_sku": "颜色:灰色;尺码:L",
                "pic_urls": [
                    "https://img.alicdn.com/imgextra/i1/xxx.jpg"
                ],
                "is_append": false,
                "append_content": ""
            },
            {
                "review_id": "123456789012346",
                "user_nick": "小***红",
                "content": "有点薄，夏天穿还行，性价比一般",
                "score": 3,
                "created": "2026-06-02 10:11:22",
                "auction_sku": "颜色:白色;尺码:M",
                "pic_urls": [],
                "is_append": true,
                "append_content": "洗了没缩水，还算可以"
            }
        ]
    }}

四、关键字段说明

total_results：商品总评论条数
review_id：评论唯一 ID，可用于去重
content：评论文本内容
score：1-5 星评分
created：评论发布时间
auction_sku：用户购买的规格信息
pic_urls：买家晒图列表
is_append：是否有追评
append_content：追评内容

五、简单开发提示

按page_no和page_size分页拉取数据
对score做分类：1-2 星差评、3 星中评、4-5 星好评
注意接口限流，避免频繁调用导致失败
解析时处理空数组，防止程序报错

淘宝商品评论 API（taobao.item.reviews.get）业务场景与 JSON 返回实战

Thu, 11 Jun 2026 16:15:03 +0800

一、接口概述

淘宝评论 API（taobao.item.reviews.get）是淘宝开放平台核心数据接口，通过 HTTPS+REST 调用，按商品 ID（num_iid）获取评分、文字、晒图、追评、卖家回复等全量评论数据，支持分页与筛选，是电商数据合规采集的核心渠道。

二、核心业务场景（直接落地）

1. 商家运营：口碑监控与差评预警

实时监控本店商品1-3 星差评，关键词匹配 “质量差、掉色、破损”，触发短信 / 企业微信告警，客服快速响应，降低纠纷率。
分析高频好评词（如 “性价比高”），优化商品标题、详情页文案与卖点提炼。
统计追评率、晒图率，评估用户复购意愿与真实满意度。

2. 竞品分析：对标调研与差异化定位

批量抓取竞品爆款评论，对比评分分布、差评痛点、好评亮点，挖掘对手短板（如 “噪音大”），制定自家产品差异化策略（如 “静音设计”）。
分析竞品 SKU 对应的评论反馈，辅助定价、规格与库存决策。

3. 产品优化：用户反馈驱动迭代

从评论提取真实痛点（如 “续航短、包装漏液”），指导产品功能、工艺与包装改进，提升复购率。
统计用户提及的高频需求，为新品研发提供数据支撑。

4. 舆情与数据可视化：商业洞察输出

构建口碑仪表盘，展示好评率、差评 TOP 词、评论趋势，支撑运营决策。
结合情感分析，将评论文本转化为结构化数据，预测商品生命周期与市场热度。

5. 客服与售后：服务质量提升

快速定位高风险订单（差评 + 晒图），优先处理；分析客服回复满意度，优化话术。

三、实战 JSON 返回示例（含成功 / 失败）

1. 成功返回（完整结构）

json

{

    "item_reviews_get_response": {
        "request_id": "20260611155700123456",
        "total_results": 1258,
        "page_no": 1,
        "page_size": 20,
        "reviews": [
            {
                "review_id": "7295689452365896235",
                "user_nick": "小***柚",
                "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"
                ],
                "user_level": "V4",
                "is_append": true,
                "append_content": "穿洗一周不变形，值得回购",
                "append_time": "2026-04-19 10:15:20",
                "reply": {
                    "content": "感谢亲的认可，品质我们严格把控~",
                    "reply_time": "2026-04-12 10:05:30"
                }
            },
            {
                "review_id": "7295689452365896236",
                "user_nick": "tb87654321",
                "display_user_nick": "t***1",
                "is_anonymous": true,
                "content": "尺码偏大，洗后轻微掉色，整体一般",
                "score": 3,
                "created": "2026-05-18 16:35:10",
                "auction_sku": "颜色:白色;尺码:L",
                "useful_count": 12,
                "pic_urls": [],
                "user_level": "V3",
                "is_append": false,
                "append_content": "",
                "append_time": "",
                "reply": {}
            }
        ]
    }}

2. 失败返回（常见错误）

（1）签名错误（code=15）

json

{

    "error_response": {
        "code": 15,
        "msg": "Invalid signature",
        "request_id": "20260611155700654321"
    }}

（2）权限不足（code=22）

json

{

    "error_response": {
        "code": 22,
        "msg": "Insufficient permissions",
        "request_id": "20260611155700987654"
    }}

（3）限流（code=429）

json

{
    "error_response": {
        "code": 429,
        "msg": "Too many requests",
        "request_id": "20260611155700112233"
    }}

四、关键字段说明

表格

字段	说明
`total_results`	商品总评论数
`review_id`	评论唯一 ID
`user_nick`	用户名（脱敏）
`content`	评论正文
`score`	评分（1-5 星）
`created`	评论时间
`auction_sku`	对应 SKU（颜色 / 尺码）
`pic_urls`	晒图 URL 数组
`append_content`	追评内容
`reply`	卖家回复（内容 + 时间）

五、开发要点

分页逻辑：page_no从 1 开始，page_size最大 20，循环拉取至无数据。
空值处理：pic_urls、reply为空时返回空数组 / 对象，避免解析报错。
限流规避：基础版 QPS=1-2，建议加5-15 分钟缓存，高频商品分批拉取。
合规性：仅用于自有店铺或授权竞品数据，禁止爬虫非公开数据。

小红书笔记评论 API 简明文档（含 JSON 样例）

Tue, 09 Jun 2026 16:17:44 +0800

前言

一、接口简介

小红书笔记评论 API 用于获取单条笔记下的主评论、楼中楼子评论、用户信息、互动数据，支持分页与排序，是舆情分析、内容调研、用户反馈采集的常用接口。

接口采用 HTTPS 请求，基于 Token 鉴权，使用游标分页，不依赖传统页码。

二、基础调用信息

接口地址：/api/v1/note/comment/list
请求方式：POST
鉴权方式：请求头携带 Authorization: Bearer 访问令牌
分页规则：使用 cursor 游标翻页，has_more 判断是否还有下一页
单页条数：默认 20 条，最大支持 50 条

三、请求入参示例

json

{

    "note_id": "649c46ab000000002702ad36",
    "cursor": "",
    "page_size": 20,
    "sort": "hot",
    "need_sub_comment": true}

参数说明

note_id：笔记唯一 ID，必填
cursor：分页游标，第一页传空字符串
page_size：单页评论数量
sort：排序方式，hot热门、time最新
need_sub_comment：是否返回楼中楼子评论

四、原始返回 JSON 示例

json

{

    "code": 200,
    "msg": "success",
    "data": {
        "note_id": "649c46ab000000002702ad36",
        "total_comment": 1256,
        "cursor": "crs_20260609_001",
        "has_more": true,
        "comments": [
            {
                "comment_id": "com_1122334455",
                "content": "使用感很棒，性价比很高，已经回购啦",
                "create_time": 1744289620,
                "like_count": 326,
                "reply_count": 18,
                "is_top": true,
                "user": {
                    "user_id": "u_589abc789",
                    "nickname": "护肤爱好者",
                    "avatar": "https://sns-avatar-qc.xhscdn.com/avatar/abc123.jpg"
                },
                "sub_comments": [
                    {
                        "comment_id": "sub_998877",
                        "content": "请问在哪里入手的？",
                        "create_time": 1744290120,
                        "like_count": 12,
                        "reply_user_id": "u_589abc789",
                        "user": {
                            "user_id": "u_321def654",
                            "nickname": "新手小白",
                            "avatar": "https://sns-avatar-qc.xhscdn.com/avatar/def456.jpg"
                        }
                    }
                ]
            }
        ]
    }}

五、核心字段说明

顶层状态

code：200 表示请求成功；非 200 为异常
total_comment：笔记评论总数
cursor：下一页分页游标
has_more：true 代表还有更多数据

主评论字段

comment_id：评论唯一标识
content：评论内容
create_time：发布时间（Unix 时间戳）
like_count：点赞数，reply_count：回复数
is_top：是否为置顶评论
user：评论者账号信息（ID、昵称、头像）

子评论字段

sub_comments：楼中楼回复列表
reply_user_id：回复目标用户 ID

六、异常返回示例

1. Token 失效

json

{

    "code": 401,
    "msg": "token已过期，请重新授权",
    "data": {}}

2. 接口限流

json

{

    "code": 429,
    "msg": "请求过于频繁，请稍后再试",
    "data": {}}

3. 无效笔记 ID

json

{

    "code": 400,
    "msg": "note_id不存在",
    "data": {}}

七、简单开发要点

时间戳需手动转换为标准日期格式，方便统计展示；
遍历解析时做好空值判断，避免子评论为空导致程序报错；
循环读取 cursor 直到 has_more=false，完成全量评论抓取；
控制调用频率，规避接口限流。

八、应用场景

笔记口碑分析、用户问答收集、竞品内容监控、评论关键词提取。

淘宝商品详情 API 技术简析（简易版 + JSON 参考）

Mon, 08 Jun 2026 15:52:30 +0800

前言

一、接口基础

接口名称：taobao.item.get

协议：HTTPS + REST 请求，支持 GET/POST

鉴权：基于 AppKey + AppSecret + MD5 签名校验，防篡改与非法调用

分页 / 筛选：通过 fields 按需指定返回字段，提升传输与解析效率

二、请求核心参数

num_iid：商品唯一 ID（必填）
app_key：应用标识
timestamp：毫秒时间戳（防重放）
sign：MD5 签名
fields：限定返回字段，精简数据体积

三、完整返回 JSON 示例

json

{

    "item_get_response": {
        "request_id": "req_20260608_145001",
        "item": {
            "num_iid": "6801234567890",
            "title": "夏季纯棉短袖T恤 男女同款",
            "price": "89.00",
            "promotion_price": "59.00",
            "sales": 15680,
            "stock": 862,
            "pic_url": "https://img.taobao.com/main.jpg",
            "location": "广东 广州",
            "nick": "品牌官方店",
            "desc": "<p>纯棉面料，透气舒适</p>",
            "skus": [
                {
                    "sku_id": "123001",
                    "properties_name": "颜色:白色;尺码:M",
                    "price": "59.00",
                    "quantity": 210
                },
                {
                    "sku_id": "123002",
                    "properties_name": "颜色:黑色;尺码:L",
                    "price": "59.00",
                    "quantity": 165
                }
            ]
        }
    }}

四、JSON 结构 & 字段简要说明

外层节点
item_get_response：统一响应根容器；request_id 用于日志排查、链路追踪。
商品基础字段

num_iid：商品主键，查询、去重唯一标识
title：商品标题
price：原价，promotion_price：活动促销价
sales：累计销量，stock：总库存
pic_url：商品主图地址
nick：店铺名称，location：发货地
desc：HTML 格式商品详情

SKU 嵌套数组（核心）
存放不同规格（颜色 / 尺码）数据：

sku_id：规格唯一 ID
properties_name：规格名称组合
price：单品售价
quantity：当前规格库存

五、常见错误返回示例

json

// 签名错误{

    "error_response": {
        "code": 15,
        "msg": "Invalid signature"
    }}// 调用限流{
    "error_response": {
        "code": 429,
        "msg": "Too many requests"
    }}// 商品不存在{
    "error_response": {
        "code": 201,
        "msg": "Item not exists"
    }}

六、技术要点小结

数据为多层嵌套 JSON，解析重点处理 skus 数组；
价格、库存均为字符串格式，业务使用需转为数值类型；
接口有 QPS 与每日调用额度限制，高频场景建议增加本地缓存；
签名、参数排序是对接最易出错环节。

淘宝拍立淘按图搜索 API 接口技术文档（完整JSON样例）

Sun, 07 Jun 2026 15:13:14 +0800

前言

一、接口概述

淘宝拍立淘按图搜索接口（item_search_img），是淘宝开放平台核心图像检索接口。通过上传图片URL/图片二进制，可实现以图搜同款、以图搜相似款，返回全网相似商品、匹配度、价格、销量、店铺、主图、商品链接等数据。

常用于：同款比价、货源找货、图片识别商品、侵权排查、铺货匹配、同款竞品分析、图像检索系统开发。

二、接口基础信息

接口名称：item_search_img（拍立淘按图搜索）
请求地址：o0b.cn/anzexi
请求方式：GET / POST
数据格式：JSON
核心能力：图片检索、相似度匹配、同款/相似商品批量返回
分页能力：支持 page_no / page_size 分页，最大每页100条

三、核心请求参数

参数名	是否必填	说明
img_url	是	待检索图片网络地址（必须可公网访问）
page_no	否	页码，默认1
page_size	否	每页数量，最大100
similar	否	1=优先同款，0=优先相似款

四、接口原始返回 JSON（完整真实样例）

以下为官方原生完整返回数据，包含相似度分数、天猫标识、价格、销量、商品链接、主图、店铺信息等全部核心字段。

{
    "item_search_img_response": {
        "request_id": "2026060715023600123",
        "total_results": 68,
        "items": {
            "item": [
                {
                    "num_iid": "68952314567890123",
                    "title": "2026夏季新款纯棉短袖T恤女宽松百搭纯色简约上衣",
                    "price": "59.90",
                    "promotion_price": "39.90",
                    "pic_url": "https://img1.taobao.com/xxx_main.jpg",
                    "detail_url": "https://item.taobao.com/item.htm?id=68952314567890123",
                    "sales": 12680,
                    "location": "广东 广州",
                    "nick": "XX女装旗舰店",
                    "is_tmall": true,
                    "match_rate": 0.96,
                    "category": "女装/女士精品>T恤"
                },
                {
                    "num_iid": "68123456789012345",
                    "title": "韩系简约纯棉短袖女夏季宽松百搭基础款纯色T恤上衣",
                    "price": "69.00",
                    "promotion_price": "45.00",
                    "pic_url": "https://img2.taobao.com/xxx_2.jpg",
                    "detail_url": "https://item.taobao.com/item.htm?id=68123456789012345",
                    "sales": 8960,
                    "location": "浙江 杭州",
                    "nick": "XX韩风服饰店",
                    "is_tmall": false,
                    "match_rate": 0.89,
                    "category": "女装/女士精品>T恤"
                }
            ]
        }
    }
}

五、核心字段详细说明

total_results：本次图片检索匹配到的商品总数
num_iid：商品唯一ID（核心主键）
title：商品标题
price：商品原价
promotion_price：实时促销价（成交价）
pic_url：商品主图地址
detail_url：商品详情真实链接
sales：商品累计销量
location：发货地
nick：店铺名称
is_tmall：是否天猫店铺（正品权重更高）
match_rate：图片相似度0~1，越高越匹配
category：商品所属类目

六、结构化清洗后标准 JSON（业务落地模型）

原生JSON嵌套深、字段冗余，开发中统一清洗为扁平化标准结构，可直接入库、比价、做同款匹配：

{
    "request_id": "2026060715023600123",
    "total": 68,
    "item_list": [
        {
            "num_iid": "68952314567890123",
            "title": "2026夏季新款纯棉短袖T恤女宽松百搭纯色简约上衣",
            "origin_price": "59.90",
            "sale_price": "39.90",
            "main_image": "https://img1.taobao.com/xxx_main.jpg",
            "item_url": "https://item.taobao.com/item.htm?id=68952314567890123",
            "sales": 12680,
            "location": "广东 广州",
            "shop_name": "XX女装旗舰店",
            "is_tmall": true,
            "similarity": 0.96,
            "category": "女装/女士精品>T恤",
            "match_level": "高度同款"
        },
        {
            "num_iid": "68123456789012345",
            "title": "韩系简约纯棉短袖女夏季宽松百搭基础款纯色T恤上衣",
            "origin_price": "69.00",
            "sale_price": "45.00",
            "main_image": "https://img2.taobao.com/xxx_2.jpg",
            "item_url": "https://item.taobao.com/item.htm?id=68123456789012345",
            "sales": 8960,
            "location": "浙江 杭州",
            "shop_name": "XX韩风服饰店",
            "is_tmall": false,
            "similarity": 0.89,
            "category": "女装/女士精品>T恤",
            "match_level": "相似款"
        }
    ]
}

七、错误返回 JSON 样例（开发排错必备）

1. 图片地址无效

{
    "error_response": {
        "code": 40026,
        "msg": "invalid img_url",
        "sub_msg": "图片链接无法访问或格式错误"
    }
}

2. 接口权限不足

{
    "error_response": {
        "code": 22,
        "msg": "Insufficient Permissions",
        "sub_msg": "未开通拍立淘搜索接口权限"
    }
}

3. 请求限流

{
    "error_response": {
        "code": 429,
        "msg": "Request Too Frequently",
        "sub_msg": "接口调用频率超限，请稍后重试"
    }
}

八、核心开发实战要点

相似度筛选：match_rate ≥ 0.9 判定为同款商品，用于精准找货
图片要求：必须公网可访问 HTTPS 图片，本地图片需先上传获取URL
去重规则：以 num_iid 作为商品唯一主键
排序策略：优先按相似度、销量、价格综合排序
分页限制：最大100页，批量采集需做分页闭环

九、业务应用场景

以图搜同款、货源精准匹配、无货源铺货
同款商品比价、全网最低价监控
商品图片侵权检测、相似商品排查
服装、箱包、饰品、3C 类视觉类商品选品
智能识图系统、小程序以图搜商品功能开发

十、总结

淘宝拍立淘按图搜索 API（item_search_img）是电商图像检索领域核心接口，依靠图片相似度算法实现精准同款匹配。原生 JSON 结构标准、数据维度完整，包含价格、销量、店铺、相似度等关键商业数据。通过结构化清洗后，可直接支撑找货、比价、侵权检测、智能识图等企业级业务，是合规、稳定、高效的视觉电商数据解决方案。

淘宝商品评论API接口技术文档（完整JSON返回样例）

Fri, 05 Jun 2026 16:05:22 +0800

一、接口简介

淘宝商品评论核心接口 taobao.item.reviews.get 是淘宝开放平台（TOP）官方评论数据接口，用于获取商品全部用户评价、晒图、追评、评分、SKU规格、用户信息。

广泛用于：差评监控、舆情分析、竞品口碑采集、商品质量分析、用户反馈挖掘等场景。相比爬虫，官方API具备合规、稳定、字段标准、更新实时的优势。

二、接口基础信息

接口名称：taobao.item.reviews.get
请求方式：HTTPS POST/GET
接口网关：o0b.cn/anzexi
分页规则：page_no / page_size（最大100条/页，最多100页）
鉴权方式：TOP标准签名机制（AppKey + AppSecret + Sign）
数据包含：主评、追评、晒图、SKU规格、评分、评价时间、脱敏用户信息、有用数

三、通用请求参数

核心业务请求参数（最简可用）：

num_iid：淘宝商品ID（必填）
page_no：页码
page_size：每页数量
fields：指定返回字段，优化性能

四、官方原始完整返回 JSON（真实可复用）

以下为淘宝评论API完整原生返回JSON样例，包含：主评论、晒图、SKU规格、用户信息、追评、点赞有用数、评价时间等全量字段。

{
    "item_reviews_get_response": {
        "total_results": 2860,
        "reviews": [
            {
                "review_id": "1456789923456789012",
                "user_nick": "tb***9876",
                "display_user_nick": "tb***9876",
                "content": "面料非常舒服，纯棉材质，上身很宽松，性价比超高，已经推荐朋友购买了！",
                "score": 5,
                "created": "2026-05-20 10:22:16",
                "auction_sku": "颜色:黑色;尺码:XL",
                "useful_count": 36,
                "pic_urls": [
                    "https://img.taobao.com/imgextra/i1/xxx1.jpg",
                    "https://img.taobao.com/imgextra/i1/xxx2.jpg"
                ],
                "user_level": "V4",
                "is_append": false,
                "append_content": "",
                "append_time": "",
                "num_iid": "6801234567890"
            },
            {
                "review_id": "1456789923456789013",
                "user_nick": "小***猫",
                "display_user_nick": "小***猫",
                "content": "尺码偏大，洗了一次轻微掉色，整体还行",
                "score": 3,
                "created": "2026-05-18 16:35:10",
                "auction_sku": "颜色:白色;尺码:L",
                "useful_count": 12,
                "pic_urls": [],
                "user_level": "V3",
                "is_append": true,
                "append_content": "穿了一周，没有变形，日常穿完全没问题",
                "append_time": "2026-05-22 09:12:00",
                "num_iid": "6801234567890"
            }
        ]
    }
}

五、核心字段详细说明

字段	说明
total_results	商品总评价数
review_id	评论唯一ID（去重主键）
content	用户主评论内容
score	评分 1~5星（1差评、5好评）
created	评论创建时间
auction_sku	用户购买的规格型号
pic_urls	晒图数组，无图为空数组
useful_count	评论被点击“有用”次数
is_append	是否包含追评
append_content	追评内容
append_time	追评时间
display_user_nick	脱敏展示昵称（合规字段）

六、标准化结构化JSON（开发落地模型）

原生JSON嵌套深、字段杂乱，业务开发需清洗为扁平化标准结构，可直接入库、做统计、舆情分析：

{
    "num_iid": "6801234567890",
    "total_review": 2860,
    "review_list": [
        {
            "review_id": "1456789923456789012",
            "user_nick": "tb***9876",
            "score": 5,
            "score_type": "好评",
            "content": "面料非常舒服，纯棉材质，上身很宽松，性价比超高，已经推荐朋友购买了！",
            "sku_spec": "颜色:黑色;尺码:XL",
            "create_time": "2026-05-20 10:22:16",
            "useful_count": 36,
            "pic_list": [
                "https://img.taobao.com/imgextra/i1/xxx1.jpg",
                "https://img.taobao.com/imgextra/i1/xxx2.jpg"
            ],
            "has_append": false,
            "append_content": "",
            "append_time": ""
        },
        {
            "review_id": "1456789923456789013",
            "user_nick": "小***猫",
            "score": 3,
            "score_type": "中评",
            "content": "尺码偏大，洗了一次轻微掉色，整体还行",
            "sku_spec": "颜色:白色;尺码:L",
            "create_time": "2026-05-18 16:35:10",
            "useful_count": 12,
            "pic_list": [],
            "has_append": true,
            "append_content": "穿了一周，没有变形，日常穿完全没问题",
            "append_time": "2026-05-22 09:12:00"
        }
    ]
}

七、接口错误返回JSON（异常处理）

{
    "error_response": {
        "code": 15,
        "msg": "Invalid signature",
        "sub_msg": "签名错误"
    }
}

{
    "error_response": {
        "code": 22,
        "msg": "Insufficient permissions",
        "sub_msg": "接口权限不足"
    }
}

{
    "error_response": {
        "code": 429,
        "msg": "Too many requests",
        "sub_msg": "调用频率超限"
    }
}

八、技术开发要点

去重逻辑：以review_id 作为唯一主键，防止重复入库
评分归类：1-2星=差评、3星=中评、4-5星=好评，用于口碑统计
追评识别：通过 is_append 区分主评/追评数据
增量更新：按评论时间分页拉取，减少API调用量
合规处理：用户昵称自动脱敏，禁止存储隐私信息

九、适用业务场景

商品差评实时监控与预警
竞品口碑、用户痛点数据挖掘
评论情感分析、好评率统计
SKU规格用户反馈分析（哪个尺码/颜色问题最多）
晒图质量、买家秀素材采集

十、总结

淘宝商品评论API是电商数据开发的核心接口，原生JSON覆盖评价内容、评分、SKU、晒图、追评、用户行为全维度数据。通过标准化结构化清洗后，可直接支撑舆情监控、产品迭代、竞品分析、数据报表等企业级业务，是合规、稳定、可长期复用的电商数据解决方案。