万邦api博客

淘宝商品评论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、晒图、追评、用户行为全维度数据。通过标准化结构化清洗后，可直接支撑舆情监控、产品迭代、竞品分析、数据报表等企业级业务，是合规、稳定、可长期复用的电商数据解决方案。

TikTok 视频详情 & 列表 API 接口技术文档（带全套 JSON 样例・核心章节）

Thu, 04 Jun 2026 17:07:23 +0800

一、接口整体说明

TikTok 视频接口分两类：①用户作品列表接口（批量拉取多视频）、②单条视频详情接口（指定 aweme_id 查单品），通用cursor游标分页，不使用 page 页码；鉴权统一 Header：Authorization: Bearer ApiKey，单页上限 20~35 条，QPS 官方限流 3 次 /s。

1. 接口地址与入参

（1）用户作品列表（批量列表）

请求：GET /api/v1/tiktok/user/post/list

json

// 请求入参JSON{

    "sec_user_id": "MS4wLjABAAAA8fKxxxxxxx",
    "max_cursor": "0",
    "limit": 20,
    "region": "US"}

表格

参数	必填	释义
sec_user_id	是	创作者唯一安全 ID，主页链接提取
max_cursor	否	分页游标，首次 = 0，下一页用上轮返回 max_cursor
limit	否	单页条数，1~35
region	否	地区码 US/GB/JP 等

（2）单视频详情接口

请求：GET /api/v1/tiktok/video/detail

json

{

    "aweme_id":"7528963259874125698"}

二、接口原生返回 JSON（脱敏真实原版・列表 + 单详情）

1. 用户作品列表原始返回 JSON

原生嵌套层级深：作者信息、视频资源、音乐、互动统计多层内嵌，含大量冗余扩展字段，无法直接入库。

json

{

    "code":0,
    "msg":"success",
    "request_id":"tk_req_95632187",
    "data":{
        "has_more":true,
        "max_cursor":"1750236985000",
        "min_cursor":"0",
        "aweme_list":[
            {
                "aweme_id":"7528963259874125698",
                "desc":"Summer daily outfit✨ #fashion #ootd #summerlook",
                "create_time":1750212365,
                "is_private":false,
                "author":{
                    "uid":"6952369874521",
                    "unique_id":"lily_fashion_us",
                    "nickname":"Lily Fashion",
                    "avatar":"https://p3.tiktokcdn.com/tos-maliva-avt/xxx.jpg",
                    "signature":"Daily fashion sharing | US blogger",
                    "is_verified":true
                },
                "video":{
                    "duration":12800,
                    "width":1080,
                    "height":1920,
                    "cover":{
                        "url_list":["https://p3.tiktokcdn.com/tos-maliva-video/cover1.jpg"]
                    },
                    "play_addr":{
                        "url_list":["https://v16-web.tiktok.com/xxx.mp4"]
                    }
                },
                "music":{
                    "music_id":"7489562135987",
                    "title":"Sunny Day Vibe",
                    "author":"DJ Mark",
                    "cover":"https://p3.tiktokcdn.com/tos-maliva-music/msc.jpg"
                },
                "statistics":{
                    "digg_count":12589,
                    "comment_count":892,
                    "share_count":326,
                    "collect_count":1563,
                    "play_count":215689
                },
                "text_extra":[
                    {"hashtag_name":"fashion","hashtag_id":"523698"},
                    {"hashtag_name":"ootd","hashtag_id":"256987"}
                ]
            },
            {
                "aweme_id":"7528959874125369852",
                "desc":"Affordable casual clothes haul🛒 #clothes #shopping",
                "create_time":1750198652,
                "is_private":false,
                "author":{
                    "uid":"6952369874521",
                    "unique_id":"lily_fashion_us",
                    "nickname":"Lily Fashion",
                    "avatar":"https://p3.tiktokcdn.com/tos-maliva-avt/xxx.jpg",
                    "signature":"Daily fashion sharing | US blogger",
                    "is_verified":true
                },
                "video":{
                    "duration":9600,
                    "width":1080,
                    "height":1920,
                    "cover":{"url_list":["https://p3.tiktokcdn.com/tos-maliva-video/cover2.jpg"]},
                    "play_addr":{"url_list":["https://v16-web.tiktok.com/xxx2.mp4"]}
                },
                "music":{
                    "music_id":"7489561236954",
                    "title":"Shopping Mood",
                    "author":"Luna Band",
                    "cover":"https://p3.tiktokcdn.com/tos-maliva-music/msc2.jpg"
                },
                "statistics":{
                    "digg_count":9856,
                    "comment_count":632,
                    "share_count":215,
                    "collect_count":986,
                    "play_count":159632
                },
                "text_extra":[
                    {"hashtag_name":"clothes","hashtag_id":"326985"},
                    {"hashtag_name":"shopping","hashtag_id":"159874"}
                ]
            }
        ]
    }}

2. 单条视频详情原生 JSON（精简）

json

{

    "code":0,
    "msg":"success",
    "data":{
        "aweme_detail":{
            "aweme_id":"7528963259874125698",
            "desc":"Summer daily outfit✨ #fashion #ootd #summerlook",
            "create_time":1750212365,
            "author":{
                "unique_id":"lily_fashion_us",
                "nickname":"Lily Fashion",
                "is_verified":true
            },
            "statistics":{
                "digg_count":12589,
                "comment_count":892,
                "share_count":326,
                "collect_count":1563,
                "play_count":215689
            },
            "video":{
                "duration":12800,
                "cover":{"url_list":["https://p3.tiktokcdn.com/cover1.jpg"]},
                "play_addr":{"url_list":["https://v16-web.tiktok.com/xxx.mp4"]}
            },
            "music":{
                "title":"Sunny Day Vibe","author":"DJ Mark"
            }
        }
    }}

三、原生 JSON 现存痛点

时间是 Unix 时间戳，无法直接展示、按日期统计；
话题标签text_extra为数组嵌套，标签和 ID 混存，关键词提取繁琐；
视频封面、播放地址放在url_list数组内，多链接冗余，仅取首图即可；
作者信息深度内嵌，不利于创作者、视频分表存储；
空字段（无音乐 / 无话题）字段结构不一致，遍历易空指针异常；
分页游标分散在顶层 data，批量采集需单独存储max_cursor。

四、结构化解析后标准 JSON（业务落地模型，可直接入库 MySQL/ES）

扁平化字段、时间格式化、标签数组提取、资源精简，是竞品分析、爆款筛选、达人数据统计标准格式：

json

{

    "next_cursor":"1750236985000",
    "has_more":true,
    "video_list":[
        {
            "aweme_id":"7528963259874125698",
            "video_desc":"Summer daily outfit✨ #fashion #ootd #summerlook",
            "publish_ts":1750212365,
            "publish_time":"2025-03-19 14:06:05",
            "is_private":false,
            "author_info":{
                "uid":"6952369874521",
                "unique_id":"lily_fashion_us",
                "nickname":"Lily Fashion",
                "avatar":"https://p3.tiktokcdn.com/tos-maliva-avt/xxx.jpg",
                "signature":"Daily fashion sharing | US blogger",
                "is_verified":true
            },
            "video_resource":{
                "duration_ms":12800,
                "duration_sec":12.8,
                "width":1080,
                "height":1920,
                "cover_img":"https://p3.tiktokcdn.com/tos-maliva-video/cover1.jpg",
                "play_url":"https://v16-web.tiktok.com/xxx.mp4"
            },
            "music_info":{
                "music_id":"7489562135987",
                "music_name":"Sunny Day Vibe",
                "music_author":"DJ Mark",
                "music_cover":"https://p3.tiktokcdn.com/tos-maliva-music/msc.jpg"
            },
            "stats":{
                "play":215689,
                "like":12589,
                "comment":892,
                "share":326,
                "collect":1563
            },
            "hashtags":["fashion","ootd","summerlook"]
        },
        {
            "aweme_id":"7528959874125369852",
            "video_desc":"Affordable casual clothes haul🛒 #clothes #shopping",
            "publish_ts":1750198652,
            "publish_time":"2025-03-19 09:37:32",
            "is_private":false,
            "author_info":{
                "uid":"6952369874521",
                "unique_id":"lily_fashion_us",
                "nickname":"Lily Fashion",
                "avatar":"https://p3.tiktokcdn.com/tos-maliva-avt/xxx.jpg",
                "signature":"Daily fashion sharing | US blogger",
                "is_verified":true
            },
            "video_resource":{
                "duration_ms":9600,
                "duration_sec":9.6,
                "width":1080,
                "height":1920,
                "cover_img":"https://p3.tiktokcdn.com/tos-maliva-video/cover2.jpg",
                "play_url":"https://v16-web.tiktok.com/xxx2.mp4"
            },
            "music_info":{
                "music_id":"7489561236954",
                "music_name":"Shopping Mood",
                "music_author":"Luna Band",
                "music_cover":"https://p3.tiktokcdn.com/tos-maliva-music/msc2.jpg"
            },
            "stats":{
                "play":159632,
                "like":9856,
                "comment":632,
                "share":215,
                "collect":986
            },
            "hashtags":["clothes","shopping"]
        }
    ]}

五、异常返回 JSON（错误码参考，异常捕获必备）

json

// Token失效{

    "code":401,
    "msg":"ApiKey invalid or expired",
    "request_id":"tk_err_125698",
    "data":{}}// 接口限流{
    "code":429,
    "msg":"Request frequency limit, wait 15s",
    "data":{}}// 无效用户ID{
    "code":400,
    "msg":"sec_user_id not found",
    "data":{}}

六、核心解析实战要点

时间标准化：create_time时间戳转yyyy-MM-dd HH:mm:ss，新增秒数字段duration_sec便于筛选短视频；
话题标签提取：遍历text_extra数组，只提取hashtag_name生成纯标签数组；
资源地址精简：封面、播放链接只取url_list[0]首地址，剔除冗余备用 CDN 链接；
空值容错：无音乐时music_info设为空对象，无话题hashtags=[]，规避索引报错；
分页采集逻辑：has_more=true则带入max_cursor循环翻页，直到 false 结束全量抓取。

七、极简 Python 解析示例（配套实战代码）

python

运行

import timedef parse_tiktok_video(raw_json):
    res = {}
    resp = raw_json.get("data",{})
    res["next_cursor"] = resp.get("max_cursor","")
    res["has_more"] = resp.get("has_more",False)
    video_arr = []
    for item in resp.get("aweme_list",[]):
        video = {}
        video["aweme_id"] = item["aweme_id"]
        video["video_desc"] = item["desc"]
        ts = item["create_time"]
        video["publish_ts"] = ts
        video["publish_time"] = time.strftime("%Y-%m-%d %H:%M:%S",time.localtime(ts))
        video["is_private"] = item["is_private"]
        #作者信息
        au = item["author"]
        video["author_info"] = au        #视频资源
        vd = item["video"]
        video["video_resource"] = {
            "duration_ms":vd["duration"],
            "duration_sec":round(vd["duration"]/1000,1),
            "width":vd["width"],
            "height":vd["height"],
            "cover_img":vd["cover"]["url_list"][0],
            "play_url":vd["play_addr"]["url_list"][0]
        }
        #互动数据
        st = item["statistics"]
        video["stats"] = {
            "play":st["play_count"],
            "like":st["digg_count"],
            "comment":st["comment_count"],
            "share":st["share_count"],
            "collect":st["collect_count"]
        }
        #话题标签
        tags = [i["hashtag_name"] for i in item.get("text_extra",[])]
        video["hashtags"] = tags
        video_arr.append(video)
    res["video_list"] = video_arr    return res

八、落地业务场景

海外达人监控：批量抓取博主作品播放 / 点赞，筛选潜力达人；
爆款内容挖掘：按播放、互动率筛选高流量短视频，复盘爆款标签；
跨境选品分析：穿搭 / 好物类视频统计热门品类、关键词，辅助选品；
竞品账号跟踪：定时拉取竞品作品数据，监控上新与流量变化。

小红书笔记评论 API 接口深度解析（带全套 JSON 示例・技术实战版）

Wed, 03 Jun 2026 10:04:21 +0800

一、接口基础说明

1. 接口基础信息

接口路径：/api/v1/note/comment/list（小红书开放平台标准评论接口）

请求方式：POST

鉴权规则：Header 携带Authorization: Bearer access_token（OAuth2.0 令牌鉴权）

分页规则：游标 cursor 分页（弃用传统 page 页码），首次请求 cursor 传空字符串，下一页使用上一页返回 cursor 字段；sort支持hot热门排序 /time时间倒序；page_size单页 1~50 条，官方 QPS 限流 5 次 /s。

请求入参（JSON 入参示例）

json

{

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

表格

参数	必填	说明
note_id	是	笔记唯一 ID（32 位字符串，从笔记链接提取）
cursor	否	分页游标，空 = 第一页
page_size	否	单页评论条数，默认 20
sort	否	hot = 热门优先，time = 最新优先
need_sub_comment	否	true 返回楼中楼子评论

二、接口原生返回完整 JSON（真实脱敏样例）

原生 JSON 层级深、嵌套子评论数组、时间为时间戳、用户信息内嵌，无法直接入库 / 数据分析：

json

{

    "code": 200,
    "msg": "success",
    "request_id": "req_987654321abc",
    "data": {
        "note_id": "649c46ab000000002702ad36",
        "total_comment": 1256,
        "cursor": "crs_20260603_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",
                    "is_creator": false
                },
                "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"
                        }
                    }
                ]
            },
            {
                "comment_id": "com_5566778899",
                "content": "@小丸子 敏感肌能用吗？",
                "create_time": 1744291200,
                "like_count": 45,
                "reply_count": 0,
                "is_top": false,
                "user": {
                    "user_id": "u_789ghi123",
                    "nickname": "护肤小白日常",
                    "avatar": "https://sns-avatar-qc.xhscdn.com/avatar/ghi789.jpg",
                    "is_creator": false
                },
                "sub_comments": []
            }
        ]
    }}

顶层字段释义

code：200 = 请求成功；401=token 失效；403 = 权限不足；429 = 接口限流
request_id：请求唯一标识，接口异常排查日志用
data.total_comment：笔记全量评论总数
data.has_more：true = 存在下一页数据，继续游标翻页

三、原生 JSON 痛点

时间为Unix 时间戳，业务需要格式化yyyy-MM-dd HH:mm:ss；
主评论、子评论分层嵌套，子评论归属关系不直观；
用户信息内嵌在 comment 对象内，字段分散不利于分表存储（评论表 + 用户表）；
置顶标识is_top零散，批量筛选置顶评论需额外遍历；
@关联用户无结构化字段，原文 content 混 @文本，关键词提取困难。

四、结构化解析后标准 JSON（落地入库模型）

扁平化结构，拆分主评论 / 子评论、格式化时间、规整用户信息，可直接存入 MySQL/ES，用于舆情分析、竞品评论统计：

json

{

    "note_id": "649c46ab000000002702ad36",
    "total_comment": 1256,
    "next_cursor": "crs_20260603_001",
    "has_more": true,
    "main_comments": [
        {
            "comment_id": "com_1122334455",
            "comment_type": "main",
            "content": "油皮亲妈！上脸清爽不闷痘，已经囤两瓶啦🥰",
            "create_time_stamp": 1744289620,
            "create_time": "2025-06-10 15:53:40",
            "like_count": 326,
            "reply_count": 18,
            "is_top": true,
            "user_info": {
                "user_id": "u_589abc789",
                "nickname": "油痘肌避雷君",
                "avatar": "https://sns-avatar-qc.xhscdn.com/avatar/abc123.jpg"
            },
            "sub_comments": [
                {
                    "comment_id": "sub_998877",
                    "comment_type": "sub",
                    "parent_comment_id": "com_1122334455",
                    "content": "想问多少钱入手的？",
                    "create_time_stamp": 1744290120,
                    "create_time": "2025-06-10 16:02:00",
                    "like_count": 12,
                    "reply_target_uid": "u_589abc789",
                    "user_info": {
                        "user_id": "u_321def654",
                        "nickname": "奶茶不加冰",
                        "avatar": "https://sns-avatar-qc.xhscdn.com/avatar/def456.jpg"
                    }
                }
            ]
        },
        {
            "comment_id": "com_5566778899",
            "comment_type": "main",
            "content": "@小丸子 敏感肌能用吗？",
            "create_time_stamp": 1744291200,
            "create_time": "2025-06-10 16:13:20",
            "like_count": 45,
            "reply_count": 0,
            "is_top": false,
            "user_info": {
                "user_id": "u_789ghi123",
                "nickname": "护肤小白日常",
                "avatar": "https://sns-avatar-qc.xhscdn.com/avatar/ghi789.jpg"
            },
            "sub_comments": []
        }
    ]}

五、核心解析实战要点

时间格式化：create_time时间戳统一转为标准日期字符串，便于按日 / 月做评论量统计；
父子评论绑定：子评论新增parent_comment_id字段，绑定所属主评论 ID，数据库关联查询；
用户信息剥离：统一封装user_info对象，适配用户画像库关联；
空值容错：sub_comments无回复时默认空数组，避免数组遍历空指针报错；
分页闭环：保存返回cursor，循环遍历至has_more=false完成全量评论抓取。

六、接口异常返回 JSON 示例（错误处理参考）

json

{

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

json

{
    "code": 429,
    "msg": "接口调用超限，限流冷却10s",
    "request_id": "req_limit_789",
    "data": {}}

七、落地业务场景

品牌舆情监控：抓取评论关键词，统计好评 / 差评占比，分析产品痛点；
竞品数据分析：对标同品类笔记评论量、互动率，测算种草热度；
用户问答收集：筛选带价格、使用方法的评论，整理 FAQ 知识库。

八、精简 Python 解析代码（配套实战）

python

运行

import timedef parse_xhs_comment(raw_json):

    res = {}
    resp_data = raw_json.get("data", {})
    res["note_id"] = resp_data.get("note_id")
    res["total_comment"] = resp_data.get("total_comment",0)
    res["next_cursor"] = resp_data.get("cursor","")
    res["has_more"] = resp_data.get("has_more",False)
    main_list = []
    #遍历主评论
    for item in resp_data.get("comments",[]):
        main = {
            "comment_id":item["comment_id"],
            "comment_type":"main",
            "content":item["content"],
            "create_time_stamp":item["create_time"],
            "create_time":time.strftime("%Y-%m-%d %H:%M:%S",time.localtime(item["create_time"])),
            "like_count":item["like_count"],
            "reply_count":item["reply_count"],
            "is_top":item["is_top"],
            "user_info":item["user"],
            "sub_comments":[]
        }
        #解析子评论
        subs = []
        for sub in item.get("sub_comments",[]):
            sub_item = {
                "comment_id":sub["comment_id"],
                "comment_type":"sub",
                "parent_comment_id":main["comment_id"],
                "content":sub["content"],
                "create_time_stamp":sub["create_time"],
                "create_time":time.strftime("%Y-%m-%d %H:%M:%S",time.localtime(sub["create_time"])),
                "like_count":sub["like_count"],
                "reply_target_uid":sub.get("reply_user_id",""),
                "user_info":sub["user"]
            }
            subs.append(sub_item)
        main["sub_comments"] = subs
        main_list.append(main)
    res["main_comments"] = main_list    return res

淘宝 API 详情类 JSON 结构化解析实战（核心章节）

Tue, 02 Jun 2026 15:47:05 +0800

前言

（可直接放入你的技术文章，纯技术、带代码、带解析、带踩坑点）

一、前言：为什么结构化解析是核心？

淘宝商品详情 API 返回的是多层嵌套 JSON，包含商品基础信息、SKU、图片、价格、营销、物流、服务等数十个字段。

直接使用原始数据会出现：

字段缺失导致程序崩溃
SKU 解析混乱
价格类型不统一
图片防盗链无法展示
HTML 详情无法直接复用

结构化解析 = 把杂乱嵌套 JSON → 干净、统一、可直接入库 / 前端使用的标准数据模型

二、解析目标

把淘宝 API 原始返回，解析成统一结构：

商品基础信息（ID、标题、类目、状态）
价格体系（原价、促销价、券后价）
SKU 规格（规格名、规格值、价格、库存）
图片资源（主图、详情图、去防盗链处理）
商品详情（HTML 清洗、文本提取）
销售信息（销量、发货地、服务）

三、原始 JSON 结构回顾（简化版）

json

{
    "item_get_response": {
        "item": {
            "num_iid": "680123456789",
            "title": "夏季纯棉短袖T恤",
            "price": "89.00",
            "promotion_price": "59.00",
            "pic_url": "https://img.taobao.com/xxx.jpg",
            "item_imgs": [ {"url":"https://img.taobao.com/xxx1.jpg"}, ... ],
            "skus": {
                "sku": [
                    {
                        "sku_id": "123456",
                        "price": "59.00",
                        "quantity": 100,
                        "properties_name": "颜色:白色;尺码:M"
                    }
                ]
            },
            "desc": "<p>商品详情HTML</p>",
            "sales": 12345,
            "free_ship": true
        }
    }}

四、结构化解析实战（分步 + 代码 + 说明）

1. 根节点解析：提取 item 主体

技术点：淘宝 API 固定包裹在 item_get_response → item 下

python运行

# 解析入口def parse_item(json_data):

    # 1. 提取根节点
    response = json_data.get("item_get_response", {})
    item = response.get("item", {})
    if not item:
        raise Exception("商品数据为空")
    return item

2. 基础字段解析（最稳定、必用）

python运行

num_iid = item.get("num_iid", "") # 商品唯一IDtitle = item.get("title", "") # 标题cid = item.get("cid", "") # 类目IDcategory_name = item.get("category_name", "") # 类目名称location = item.get("location", "") # 发货地seller_nick = item.get("nick", "") # 卖家昵称shop_name = item.get("shop_name", "") # 店铺名detail_url = item.get("detail_url", "") # 商品链接

踩坑点：

num_iid 必须字符串类型，不能转数字（避免超长精度丢失）

3. 价格体系解析（重点）

淘宝价格字段多，必须统一结构化：

python

运行

# 价格统一格式化price_data = {

    "origin_price": float(item.get("price", 0)),        # 原价
    "sale_price": float(item.get("promotion_price", 0)),# 促销价
    "final_price": 0.0}# 最终价 = 促销价优先，无促销则用原价price_data["final_price"] = price_data["sale_price"] or price_data["origin_price"]

业务价值：价格监控、比价系统核心字段

4. 图片资源解析（去防盗链）

技术点：淘宝图片有防盗链，需标准化处理

python

运行

# 主图main_pic = item.get("pic_url", "")# 详情图列表item_imgs = item.get("item_imgs", [])img_list = [img.get("url", "") for img in item_imgs if img.get("url")]# 清洗：去掉协议头，兼容HTTPS/HTTPimg_list = [

    url.replace("http:", "https:") for url in img_list]

实战用途：自有商城、小程序、APP 商品展示

5. SKU 规格结构化解析（最复杂、最核心）

目标：

把 颜色:白色;尺码:M 解析为：

plaintext

{

    "specs": {"颜色":"白色","尺码":"M"},
    "price":59,
    "stock":100
}

解析代码

python

运行

sku_list = []sku_array = item.get("skus", {}).get("sku", [])for sku in sku_array:

    sku_id = sku.get("sku_id", "")
    price = float(sku.get("price", 0))
    stock = sku.get("quantity", 0)
    props_name = sku.get("properties_name", "")
    
    # 拆分规格：颜色:白色;尺码:M
    specs = {}
    if props_name:
        prop_arr = props_name.split(";")
        for p in prop_arr:
            if ":" in p:
                k, v = p.split(":", 1)
                specs[k] = v
    
    sku_info = {
        "sku_id": sku_id,
        "price": price,
        "stock": stock,
        "specs": specs    }
    sku_list.append(sku_info)

这是电商系统必备结构：下单、库存、规格选择全靠它

6. 商品详情 HTML 解析与清洗

python

运行

desc_html = item.get("desc", "")# 清洗：去掉淘宝无用标签、懒加载、内链def clean_html(html):

    html = html.replace("data-src", "src")   # 懒加载替换
    html = html.replace("taobao.com", "")    # 可按需过滤
    return html

用途：同步到自有商城、小程序详情页

7. 销售与服务结构化

python

运行

sales_info = {

    "sales": item.get("sales", 0),               # 销量
    "free_shipping": item.get("free_ship", False), # 是否包邮
    "service": item.get("service", ""),           # 服务：七天无理由
    "is_on_sale": True  # 可根据字段判断上下架}

五、最终输出：标准结构化商品模型

json

{

    "num_iid": "680123456789",
    "title": "夏季纯棉短袖T恤",
    "price": {
        "origin": 89.00,
        "sale": 59.00,
        "final": 59.00
    },
    "images": {
        "main": "https://img.taobao.com/xxx.jpg",
        "list": [ "https://img.taobao.com/xxx1.jpg", ... ]
    },
    "skus": [
        {
            "sku_id": "123456",
            "price": 59.00,
            "stock": 100,
            "specs": { "颜色": "白色", "尺码": "M" }
        }
    ],
    "sales": 12345,
    "free_shipping": true,
    "desc": "<p>清洗后的HTML</p>"}

这就是企业级标准结构：可直接入库、给前端、给 ERP、给小程序

六、本章技术总结（可直接放文章结尾）

淘宝商品详情 API 的 JSON 结构化解析，是电商数据开发中最关键、最实用、最容易踩坑的环节。

核心价值：

统一字段，消除 API 嵌套混乱
SKU 规格化，支撑下单、库存、规格选择
价格标准化，支撑比价、监控、营销
图片 / 详情清洗，支持多端展示
输出标准模型，可直接用于业务系统

探索淘宝 API 接口：淘宝商品详情数据接口的深度解析

Mon, 01 Jun 2026 16:50:59 +0800

一、引言

在电商数据驱动的时代，商品详情数据是价格监控、竞品分析、选品决策、内容铺货的核心基础。淘宝开放平台提供的taobao.item.get（商品详情 API），是官方唯一合规、稳定、可规模化获取全维度商品数据的入口。相比爬虫，它具备数据全、更新快、结构标准、风控安全、合法合规五大优势，是企业级电商数据中台的首选方案。

本文从接口能力、接入流程、数据结构、调用机制、实战案例、避坑要点六个方面，对淘宝商品详情 API 做一次完整的深度解析。

二、淘宝商品详情 API 核心能力

2.1 核心接口（最常用）

taobao.item.get：获取单个商品全量详情（基础信息、价格、SKU、库存、图文描述、物流售后）。
taobao.item.get_batch：批量获取（最多 50 个商品 / 次），适合竞品批量采集。
taobao.item.sku.get：单独获取 SKU 规格、价格、库存。

2.2 能拿到哪些核心数据

基础信息：商品 ID（num_iid）、标题、主图、类目、卖家昵称、店铺 ID。
价格体系：一口价、促销价、券后价、价格区间、是否包邮。
SKU 与库存：SKU ID、规格名、单价、库存、属性（颜色 / 尺寸 / 型号）。
图文详情：详情 HTML、卖点、包装清单、视频链接。
销售与服务：销量、发货地、运费模板、售后类型（七天无理由等）。

三、接入流程（极简但完整）

3.1 必备条件

注册淘宝开放平台账号并完成实名认证（个人 / 企业均可）。
创建应用，获得AppKey、AppSecret。
申请接口权限（item_get），审核通过后即可调用。

3.2 调用流程（标准 TOP API 流程）

构造参数：method、app_key、timestamp、format、v、sign_method、num_iid、fields…。
生成签名 sign：参数按 ASCII 升序 → 拼接 key+value → 首尾加 AppSecret → MD5/HMAC-SHA256 加密。
POST 请求网关：https://gw.api.taobao.com/router/rest。
解析 JSON/XML 返回数据。

签名是最容易出错的地方：参数顺序、时间戳格式、secret 泄露都会直接返回 invalid-sign。

四、数据结构深度解析（JSON）

返回结构分为四层：请求层 → 商品层 → SKU 层 → 店铺层。

4.1 关键字段（简化版）

json{

  "item_get_response": {
    "result": {
      "num_iid": "698877665544",
      "title": "2026夏季纯棉短袖T恤",
      "price": "59.90",
      "promotion_price": "49.90",
      "pic_url": "https://img.alicdn.com/...",
      "sales": "1256",
      "stock": 5689,
      "skus": [
        {
          "sku_id": "123456",
          "price": "49.90",
          "properties": "颜色:白色;尺寸:M",
          "quantity": 120
        }
      ],
      "desc": "<p>详情HTML...</p>"
    }
  }}

num_iid：商品唯一 ID，从 URL id= 后提取。
fields：按需指定返回字段，减少体积、提升速度。

五、技术实战场景（直接落地）

场景 1：价格监控与自动调价

定时拉取竞品详情 → 监控价格 / 促销变化 → 触发预警或自动调价。
关键点：增量拉取、按 num_iid 轮询、缓存价格快照。

场景 2：竞品全维度分析

批量获取 50 个竞品 → 对比标题卖点、价格区间、SKU 丰富度、销量、好评率。
关键点：item_get_batch + 标准化字段映射 + ES 聚合分析。

场景 3：商品内容铺货（图文同步）

拉取详情 HTML、主图、视频 → 清洗后同步到自有商城 / 小程序 / 内容平台。
关键点：图片防盗链处理、HTML 清洗、懒加载适配。

六、限流、风控与避坑指南

6.1 限流规则（2026 最新）

个人应用：QPS ≤ 3，每日约 500–1000 次。
企业应用：QPS ≤ 10–30，视权限而定。
超限：返回 too-many-requests，严重时封禁 1–7 天。

6.2 常见坑

签名失败：参数未排序、timestamp 时区不对、secret 写错。
字段缺失：fields 没写全或写错字段名。
SKU 乱序：多规格返回顺序不稳定，需按 sku_id 唯一映射。
合规风险：禁止爬取用户隐私、批量倒卖数据，否则封号追责。

（淘宝 / 京东）商品评论 API 接口：技术实战案例与架构分析

Sat, 30 May 2026 16:18:07 +0800

一、引言

在电商数据驱动的时代，商品评论是洞察用户需求、优化产品体验、监控竞品动态的核心数据。淘宝、京东作为国内头部电商平台，均开放官方商品评论 API，相较于爬虫，具备合规性强、数据稳定、字段标准、风控友好五大核心优势。本文从技术底层出发，拆解两大平台评论 API 的核心机制、实战架构、典型案例与避坑方案，为开发者提供可直接落地的技术参考。

二、淘宝 vs 京东评论 API：核心接口与技术规范

2.1 淘宝评论 API（TOP 平台）

核心接口

taobao.item.reviews.get：批量获取商品主评、追评、晒图、评分、用户信息（高频核心）。
taobao.item.evaluate.get：获取商品综合评价（好评率、评价分布、标签统计）。
taobao.traderates.get：获取交易互评数据（店铺运营质量分析）。

技术规范

接入前提：企业 / 个人实名认证、应用创建、权限申请（1-3 天审核）。
请求方式：POST（推荐）/GET，HTTPS 协议。
签名机制：HMAC-SHA256/MD5，参数按 ASCII 排序后加密。
分页限制：默认 20 条 / 页，最大 100 条 / 页，最多 100 页。
限流规则：默认 500 次 / 天，QPS≤5，高频调用触发限流。

2.2 京东评论 API（宙斯 / 联盟平台）

核心接口

jingdong.ware.comments.get：京东自营商品评论列表（含评分、追评、图片）。
jd.union.open.goods.review.list.get：联盟平台商品评论（第三方店铺适配）。

技术规范

接入前提：实名认证、应用创建、IP 白名单配置、AccessToken（30 天有效期）。
请求方式：POST，HTTPS 协议。
签名机制：MD5，参数升序拼接app_secret+key1value1...+app_secret生成 32 位大写签名。
分页限制：最大 50 条 / 页，支持按评分、时间筛选。
限流规则：基础权限 QPS≤3，企业权限 QPS≤10，高级权限 QPS≤30。

2.3 核心字段对比（标准化关键）

表格

字段	淘宝 API	京东 API	说明
商品 ID	num_iid	sku_id	唯一标识，从商品 URL 提取
评论内容	content	comment	主评 / 追评文本
评分	rate（1-5）	score（1-5）	星级评分，1 星最差
评论时间	created	commentTime	精确到秒
晒图 URL	pic_urls	imageUrls	数组格式，可直接访问
用户昵称	user_nick（脱敏）	nickname（脱敏）	隐私保护，自动脱敏

三、商品评论 API 系统架构设计（企业级）

3.1 整体架构分层

plaintext

[应用层] 舆情看板、竞品分析、差评预警、数据报表
[接口适配层] 淘宝SDK、京东SDK、统一字段映射、签名封装
[调度控制层] 定时任务、分布式锁、限流队列、失败重试
[数据处理层] 文本清洗、分词、情感分析、去重、脱敏
[数据存储层] MySQL（结构化数据）、MongoDB（原始评论）、ES（检索）、Redis（缓存/游标）

3.2 核心模块技术解析

（1）接口适配层：多平台统一接入

设计适配器模式，每个平台独立解析器，隔离差异。
统一请求 / 响应模型，输出标准化字段（comment_id、item_id、platform、score、content 等）。
封装签名、参数校验、异常捕获逻辑，降低业务层复杂度。

（2）调度控制层：限流与增量同步

增量拉取策略：记录上次拉取的max_comment_id或last_time，下次仅拉取增量数据，减少调用量。
限流控制：采用令牌桶算法，按平台 QPS 限制分发请求；多 AppKey 轮询（企业级），提升调用上限。
失败重试：指数退避（1s→2s→4s→8s），处理网络波动、限流临时封禁。
分布式锁：Redis 实现，避免多节点重复拉取同一商品评论。

（3）数据处理层：非结构化数据结构化

文本清洗：去除表情、特殊符号、URL、@用户；繁体转简体、全角转半角。
分词与属性提取：jieba 分词 + 自定义电商词典（如 “续航、音质、起球”），抽取 “名词 + 形容词” 结构（如 “物流 - 慢”“质量 - 好”）。
情感分析：

基础版：情感词典（正向 + 1、负向 - 1，程度副词加权）。
进阶版：BERT 微调电商评论模型，准确率 90%+。

数据脱敏：用户昵称、手机号自动脱敏，符合《个人信息保护法》。

（4）数据存储层：海量数据高效管理

MySQL：存储结构化数据（商品 ID、评分、评论时间、情感标签），建唯一索引防重复。
MongoDB：存储原始评论（含长文本、图片 URL、追评），适配非结构化数据。
Elasticsearch：全文检索、关键词聚合、词云生成，支撑舆情分析。
Redis：缓存热点商品评论、增量拉取游标、已告警差评 ID（24 小时过期）。

四、技术实战案例（可直接落地）

案例 1：实时差评监控与预警系统（中小商家）

场景

淘宝女装店铺，实时监控新款差评，客服 2 小时内介入，降低纠纷退款率。

技术实现

接口选择：taobao.item.reviews.get，按created降序拉取。
调度策略：新品 5 分钟轮询 1 次，老品 1 小时 1 次；每次拉取 20 条，间隔 1 秒。
关键词匹配：AC 自动机匹配负面词库（“起球、掉色、做工差、破损”），毫秒级匹配。
告警机制：匹配到差评→Redis 记录告警 ID（防重复）→企业微信机器人推送（商品 ID、评论内容、评分）。
数据统计：每日生成日报（好评率、差评 TOP3 词、晒图率）。

效果

差评响应从 24 小时缩短至 2 小时，纠纷退款率下降 40%，好评率提升 12%。

案例 2：多平台竞品评论聚合分析（品牌企业）

场景

美妆品牌，每日采集淘宝、京东 3 个竞品爆款评论，分析用户痛点，优化自家产品卖点。

技术实现

接口选择：淘宝taobao.item.reviews.get、京东jd.union.open.goods.review.list.get。
分布式调度：XXL-Job 定时任务，按商品分片，多机并行执行。
数据标准化：适配器统一字段，清洗后存入 MongoDB，ES 建立索引。
情感与痛点分析：BERT 模型做情感分类，统计负面高频词（如 “假白、拔干、油腻”）。
竞品对比：输出竞品好评率、负面痛点占比、核心卖点词云，指导产品迭代。

效果

提炼竞品核心痛点 3 类，优化自家产品配方，新品好评率达 94%，超越竞品平均水平 8%。

案例 3：京东 3C 产品质量驱动研发（硬件品牌）

场景

京东自营耳机，长期被吐槽 “戴久疼、耳罩压耳”，通过评论数据驱动结构设计优化。

技术实现

接口选择：jingdong.ware.comments.get，筛选 1-3 星差评，拉取近 6 个月数据。
数据处理：分词统计 “佩戴不适”（35%）、“耳罩硬”（21%）、“夹头”（18%）等高频痛点。
数据输出：结构化报告同步给研发团队，明确优化方向（耳罩弧度、慢回弹材质）。
效果验证：改版后拉取评论，对比差评率变化，迭代优化。

效果

改版后差评率下降 60%，好评率从 78% 升至 92%，用户复购率提升 25%。

五、核心技术痛点与避坑方案

5.1 签名机制复杂，易鉴权失败

淘宝：参数排序错误、时间戳格式不对（需yyyy-MM-dd HH:mm:ss）、AppSecret 泄露。
京东：参数未升序、IP 未配置白名单、AccessToken 过期。
避坑：封装签名工具类，严格按平台文档排序；时间戳用 UTC+8；定期刷新 AccessToken。

5.2 限流严格，高频调用触发封禁

痛点：单 AppKey、单 IP 限制，批量拉取易被封禁。
避坑：

增量拉取，减少调用次数。
令牌桶控制 QPS，严格低于平台限制。
企业级多 AppKey 轮询，分散压力。
失败后指数退避重试，不暴力请求。

5.3 数据字段差异大，标准化难

痛点：淘宝、京东字段名、数据格式不统一，解析复杂。
避坑：设计统一数据模型，适配器模式做字段映射；清洗时统一格式（如时间戳转标准格式、评分统一为 1-5 星）。

5.4 合规风险，隐私数据泄露

痛点：存储用户昵称、手机号等隐私数据，违反法规。
避坑：自动脱敏用户信息；不存储敏感数据；数据仅用于内部分析，不对外倒卖。

六、总结

淘宝、京东商品评论 API 是电商数据中台的核心基础设施，其技术价值不仅在于获取数据，更在于通过标准化接入、增量同步、异步并发、文本挖掘、分布式存储等技术手段，将非结构化评论转化为可驱动产品、运营、研发决策的高质量结构化数据。

在合规前提下，合理利用官方 API，可构建稳定、高效、可扩展的评论数据体系，帮助企业实现差评实时预警、竞品动态监控、产品迭代优化、用户体验提升，最终在电商竞争中占据数据优势。

电商评论API深度解析：淘宝、京东接口实战指南，解锁商品口碑数据价值

Wed, 27 May 2026 11:47:39 +0800

一、精选高吸引力主题标题（多风格可选）

爆款引流型

吃透淘宝京东评论API！轻松抓取电商口碑数据，赋能竞品分析
电商数据掘金：一文读懂淘宝、京东商品评论API接口全逻辑
告别手动扒数据！主流电商评论API接口实战教程，零基础上手

专业干货型

淘宝&京东商品评论API详解：接口规范、调用流程与合规实战
主流电商评论数据接口对比分析：淘宝京东API功能、限流与风控差异
电商评论数据采集进阶：官方API接口开发指南与落地解决方案

价值聚焦型

从数据到决策：依托电商评论API，实现用户口碑与竞品动态监控
合规获取电商评论数据：淘宝京东官方API接口实操与避坑指南

二、正文：淘宝京东电商商品评论API接口全解析

1. 接口核心价值：为什么电商评论API必不可少？

在数据驱动的电商运营时代，商品评论是承载用户真实反馈、产品口碑、消费痛点的核心数据载体，涵盖用户评分、文字评价、晒图视频、追评内容、SKU体验反馈、商家回复等多维信息。无论是商家优化产品、调整运营策略，还是企业开展竞品调研、市场分析、用户画像搭建，都离不开评论数据的支撑。

淘宝、京东作为国内头部电商平台，均开放了官方商品评论API接口。相较于爬虫抓取，官方API具备合规性强、数据稳定、字段标准、更新及时、风控友好五大核心优势，是开发者、运营人员、数据分析师获取电商评论数据的首选渠道，广泛应用于舆情监控、竞品分析、产品迭代、智能客服、口碑评分统计等场景。

2. 主流电商平台评论API核心接口详解

2.1 淘宝/天猫商品评论API

淘宝评论API隶属于淘宝开放平台，是标准化REST接口，包含两大核心接口，分别适配评论列表批量获取与单条评论详情查询，支持分页、筛选、多维度数据提取，适配各类开发场景。

核心接口1：taobao.item.reviews.get（商品评论列表查询）

该接口为高频使用接口，主要用于批量获取指定淘宝、天猫商品的公开评论数据，覆盖主评、追评、晒图、星级评分、用户信息、点赞数等基础字段，支持分页拉取数据，解决单页数据量有限的问题。接口请求方式为POST，采用平台标准MD5签名校验，保障请求安全。

核心请求参数：num_iid（商品唯一ID，从商品URL中提取，为必填核心参数）、page_no（分页页码）、page_size（单页数据量）、type（评论类型筛选，可区分好评、中评、差评）。

核心接口2：taobao.item.evaluate.get（商品评价详情查询）

主打精细化数据获取，可精准提取商品好评率、评价维度标签、用户评价详情、用户昵称、评价时间等深度数据，适合需要精准统计口碑指标、细化用户反馈分析的场景。

接口限制与规范：普通开发者每日调用额度约5000次，企业认证开发者可申请提升配额；接口仅返回公开合规的评论数据，屏蔽用户隐私信息，严格遵循平台数据规范。

2.2 京东商品评论API

京东商品评论API依托京东宙斯开放平台，基于HTTPS协议传输，返回标准JSON格式数据，需通过OAuth2.0认证获取访问令牌，安全性与数据规范性极高，是获取京东商品评论的官方合规渠道。

核心接口：jd.union.open.goods.review.list.get / jd.item_review

两大核心接口功能互补，支持获取京东全品类商品的评论数据，覆盖20+核心字段，包含1-5星星级评分、评论内容、晒单图片/视频、追评记录、商家回复、商品SKU属性（颜色、尺码、规格）、用户等级、评论点赞踩踩数等关键信息。

核心请求参数：skuId（京东商品唯一SKU编码，必填）、page（分页参数）、limit（单页返回条数，最大支持50条/页）、sort（评论排序方式，支持最新、最热排序）。

接口特点：认证体系严格，必须完成企业/个人实名认证、应用创建与权限审核方可调用；数据实时性强，用户新增评论可快速同步至接口返回结果，适合实时口碑监控场景。

3. 通用调用流程（淘宝+京东通用）

两大平台评论API调用流程基本一致，分为5个核心步骤，操作标准化、易落地：

第一步：平台入驻与认证 注册对应平台开放平台账号，完成个人或企业实名认证，企业账号可解锁更高调用配额与更多数据权限。

第二步：创建应用并申请权限 在开放平台后台创建开发者应用，提交商品评论查询权限申请，官方审核周期一般1-3个工作日，审核通过后方可启用接口。

第三步：获取授权凭证 淘宝获取AppKey、AppSecret，京东通过OAuth2.0协议获取access_token访问令牌，作为接口请求的身份凭证。

第四步：构造请求并调用接口按照平台规范拼接请求参数、完成签名校验，通过HTTPS请求调用对应评论接口，批量或精准获取评论数据。

第五步：数据解析与处理 解析JSON返回数据，过滤冗余字段，提取有效评论内容、评分、用户反馈等核心信息，可自主完成数据清洗、分类统计、情感分析等二次处理。

4. 核心应用场景

电商评论API的落地场景覆盖电商运营、数据分析、产品研发、市场调研等多个领域，实用性极强：

（1）竞品动态监控 批量抓取同行店铺商品评论，实时监控竞品用户痛点、好评亮点、差评集中问题，为产品优化、定价调整、营销方案升级提供数据支撑。

（2）商品口碑分析 自动统计商品好评率、差评关键词、高频反馈问题，生成口碑分析报告，帮助商家快速定位产品质量、物流、服务短板。

（3）用户画像搭建 通过评论中的用户反馈、使用场景、偏好特征，梳理用户消费习惯与核心需求，助力精准营销、产品迭代优化。

（4）舆情风险预警 实时抓取新增差评、负面评论，快速触发预警机制，帮助商家及时处理用户投诉，规避口碑崩盘风险。

（5）智能内容生成 基于海量用户真实评论，提炼产品核心卖点、高频关键词，用于商品详情页优化、短视频文案、种草内容创作。

5. 调用避坑与合规风控要点

官方API虽稳定合规，但平台存在严格的风控与规则限制，开发调用过程中需重点规避以下问题：

（1）严控调用频率，避免限流封禁 两大平台均设置每日调用配额与单秒请求上限，高频批量调用会触发限流、风控拦截，需合理设置请求间隔，采用分页分批调用、错峰请求模式。

（2）坚守数据合规底线 接口仅可用于合法商业分析、运营优化场景，禁止批量爬取、倒卖用户评论数据，禁止滥用用户隐私相关信息，否则会被收回接口权限，承担法律风险。

（3）适配接口版本更新 电商平台会不定期迭代API接口字段、请求规范，需实时关注官方文档更新，及时适配接口变动，避免接口调用失效。

（4）完善异常处理机制 调用过程中会出现网络超时、参数错误、权限不足、配额耗尽等异常情况，需提前做好异常捕获、重试机制，保障数据采集稳定性。

6. 官方API vs 第三方爬虫核心对比

对比维度	淘宝/京东官方评论API	第三方爬虫采集
合规性	完全合规，平台官方授权，无法律风险	违规风险高，易触发平台风控，涉嫌侵权
数据稳定性	字段标准、数据完整、实时同步，极少出错	页面改版即失效，数据缺失、乱码频发
调用稳定性	稳定可靠，支持长期批量调用	极易被封IP、拦截请求，可用性差
开发成本	规范统一，文档齐全，开发落地快	需持续适配页面变动，维护成本极高

7. 总结与落地建议

淘宝、京东官方商品评论API是当前获取电商口碑数据的最优解决方案，凭借合规、稳定、标准、高效的核心优势，完全满足企业与开发者的数据分析、运营优化、竞品调研需求。其中淘宝接口轻量化、适配灵活，适合中小批量数据采集；京东接口字段更丰富、认证体系更完善，适合精细化、规模化数据运营场景。

实际落地过程中，建议优先选用官方API，严格遵守平台调用规则与合规要求，结合自身业务需求合理规划调用频率与数据采集维度，搭配数据清洗、统计分析工具，最大化挖掘评论数据价值，实现从数据采集、数据分析到业务优化的完整闭环。

Taobao & Tmall Product Reviews API (V3) – JustOneAPI

Tue, 26 May 2026 16:27:08 +0800

Taobao & Tmall Product Reviews API (V3) – JustOneAPI

Version: V3

Status: Production-ready (Healthy)

Endpoint: GET /api/taobao/get-item-comment/v3

Data Format: JSON

Platform: Unified for Taobao + Tmall

1. Overview

The Taobao & Tmall Product Reviews API (V3) from JustOneAPI provides structured, real-time user review data for any Taobao or Tmall item. It unifies both platforms into a single interface, so you don’t need separate logic for Taobao vs Tmall.

Common use cases:

Competitor review analysis & sentiment monitoring
Product quality research and rating statistics
Reputation tracking & negative review alerting
E-commerce BI dashboards and review scraping at scale
Content generation (e.g., top pros/cons from reviews)

2. Request Parameters (GET)

All parameters are passed as query strings.

表格

Parameter	Type	Required	Default	Description
`token`	string	✅	—	Your JustOneAPI access token
`itemId`	string	✅	—	Taobao/Tmall product ID (num_iid)
`page`	integer	❌	1	Page number (pagination)
`pageSize`	integer	❌	20	Reviews per page (max 50)
`orderType`	string	❌	`general`	`feedbackdate` (newest first) / `general`
`rateType`	string	❌	`all`	`all` / `good` / `neutral` / `bad`
`hasPic`	boolean	❌	false	Filter reviews with images only

3. Full JSON Response Example (V3)

json{

  "code": 200,
  "msg": "success",
  "data": {
    "itemId": "681234567890",
    "total": 1258,
    "page": 1,
    "pageSize": 20,
    "reviews": [
      {
        "reviewId": "152345678901234567",
        "userNick": "t***8",
        "isAnonymous": true,
        "score": 5,
        "content": "Quality is very good, delivery fast, will buy again.",
        "created": "2026-05-20 14:22:35",
        "likeCount": 42,
        "skuInfo": "Color: Black | Size: XL",
        "picUrls": [
          "https://img01.taobaocdn.com/imgextra/i1/xxx.jpg",
          "https://img02.taobaocdn.com/imgextra/i2/xxx.jpg"
        ],
        "additionalReview": {
          "content": "Used for one month, still perfect.",
          "created": "2026-05-23 09:11:22"
        },
        "sellerReply": {
          "content": "Thank you for your support!",
          "created": "2026-05-20 16:40:12"
        }
      }
    ],
    "hasNext": true
  },
  "requestId": "req-20260526-xxx"}

4. Key Fields Explained

reviewId: Unique ID for deduplication
score: 1–5 star rating
content: Main review text
created: Review time (UTC+8)
skuInfo: Exact variant (color/size)
picUrls: Array of review photos
additionalReview: Follow-up review (追评)
sellerReply: Official store reply
hasNext: Pagination flag (simpler than calculating last page)

5. Error Codes

表格

Code	Meaning
200	Success
400	Invalid parameters
401	Token missing or invalid
403	Permission denied / quota exceeded
404	Item not found
500	Server error (retry later)

6. Usage Example (Python)

python

运行import requests

TOKEN = "your_token"ITEM_ID = "681234567890"URL = f"https://docs.justoneapi.com/api/taobao/get-item-comment/v3?token={TOKEN}&itemId={ITEM_ID}&page=1&pageSize=10&orderType=feedbackdate"resp = requests.get(URL)print(resp.json())

7. Why Use JustOneAPI V3

Unified Taobao + Tmall → one endpoint for both
Simpler pagination → hasNext boolean
Clean JSON → no messy nested structures
Built-in filtering → rating, images, date
Stable & monitored → public health status

Taobao & 1688 Product Review API: Enterprise Technical Overview & JSON Response Example

Mon, 25 May 2026 16:15:49 +0800

Theme: A practical technical guide to accessing Taobao and 1688 product review data via official APIs, including usage scenarios, core parameters, stability best practices, and standard JSON response structure for enterprise systems.

1. Overview

Taobao and 1688 Product Review APIs allow developers and enterprises to programmatically obtain user feedback, ratings, images, 追加评论 (additional reviews), and seller replies.

These APIs are widely used for:

Reputation monitoring and sentiment analysis
Competitive product research
Product quality improvement
Content generation for storefronts or recommendation systems
Business intelligence and rating statistics

The APIs return structured, clean JSON data and support pagination, filtering by rating type, and image reviews.

2. Core API Interfaces

Common standard API methods for review data:

taobao.item.review.get – Get Taobao product review list
1688.item.review.get – Get 1688 wholesale product reviews
taobao.item.review.detail.get – Get single review details

Authentication: AppKey + AppSecret signature

Format: JSON (recommended) / XML

Protocol: HTTPS

Pagination: page_no, page_size

Filter: good / neutral / bad reviews, with or without images

3. Common Request Parameters

num_iid – Product ID (required)
page_no – Page number
page_size – Items per page (max 50)
rate_type – Filter: all / good / neutral / bad
has_pic – Filter reviews with images only

4. Standard JSON Response Example

json{

  "item_review_get_response": {
    "total_results": 8652,
    "page_no": 1,
    "page_size": 20,
    "reviews": [
      {
        "review_id": 10230456789012,
        "user_nick": "user_anonymized",
        "is_anonymous": true,
        "content": "Great quality, fast delivery, fits very well.",
        "score": 5,
        "created": "2026-05-20 14:22:35",
        "like_count": 86,
        "sku_info": {
          "properties_name": "Color: White | Size: L"
        },
        "pic_urls": [
          "https://img.taobao.com/review/1.jpg",
          "https://img.taobao.com/review/2.jpg"
        ],
        "additional_review": {
          "content": "Washed several times, no fading.",
          "created": "2026-05-23 09:11:22"
        },
        "seller_reply": {
          "content": "Thank you for your trust!",
          "created": "2026-05-20 16:40:12"
        }
      }
    ],
    "request_id": "req_20260525102233012345"
  }}

5. Key Fields Explanation

review_id – Unique review ID (for deduplication)
content – User review text
score – Rating from 1 to 5
created – Review publish time
sku_info – Corresponding product specification
pic_urls – Review image attachments
additional_review – Follow-up/second review
seller_reply – Official store reply
total_results – Total reviews available
request_id – For log tracing and troubleshooting

6. Enterprise Stability & Best Practices

Control QPS and request frequency to avoid rate-limiting
Use exponential backoff retry for timeouts and 5xx errors
Validate score range (1–5), non-empty content, and valid image URLs
Cache frequent queries with Redis to reduce API calls
Use incremental synchronization based on created time
Log all requests, errors, and request_ids for monitoring
Implement service degradation when API is unstable

7. Summary

Taobao and 1688 Product Review APIs provide reliable, structured, and compliant access to user-generated content for enterprise applications.

With proper pagination, filtering, error handling, and caching, businesses can build stable review analysis, monitoring, and business intelligence systems to support data-driven operations.

Taobao & 1688 Product API Technical Overview and JSON Response Reference

Thu, 21 May 2026 17:00:20 +0800

Taobao & 1688 Product API Technical Overview and JSON Response Reference

1. Topic Overview

This article introduces the official Taobao and 1688 product detail API capabilities from an enterprise technical perspective. It covers API core functions, standard request rules, business application scenarios, and standard JSON data return structure. The API is widely used for commodity synchronization, store inventory management, price monitoring, cross-platform distribution, and e-commerce data analysis.

2. API Introduction

The Taobao / 1688 Product API is an official open interface provided by the Taobao Open Platform (TOP). It allows developers and enterprises to obtain standardized structured product data through formal authentication and signature verification.

Common official API methods:

taobao.item.get: Obtain basic product details
taobao.item.get_full: Obtain full product data (SKU, images, description, promotion)
taobao.items.onsale.get: Get all on-sale products from a store
1688.item.get: Get 1688 wholesale product information

3. Core Technical Features

Protocol: HTTPS
Data format: JSON / XML (JSON is recommended for enterprise development)
Authentication: AppKey + AppSecret MD5 signature verification
Data feature: structured, standardized, stable version iteration
Access control: QPS limit, frequency control, official traffic protection

4. Enterprise Application Scenarios

Cross-store and cross-platform product distribution (dropshipping)
Enterprise ERP commodity data synchronization
Real-time price and inventory monitoring system
Competitor product data analysis
E-commerce big data statistics and automated report generation

5. Standard JSON Return Reference (Enterprise Version)

The following is the universal standard JSON response structure for Taobao and 1688 product detail API, including core fields required for enterprise development.

{
  "item_get_response": {
    "item": {
      "num_iid": "680123456789",
      "title": "2026 Summer New Casual Cotton Short Sleeve T-shirt",
      "price": "89.00",
      "promotion_price": "59.00",
      "num": 520,
      "sales": 12580,
      "cid": 50015261,
      "category_name": "Women's Clothing > T-shirt",
      "pic_url": "https://img.taobao.com/xxx.jpg",
      "location": "Guangdong, Guangzhou",
      "nick": "Official Flagship Store",
      "modified_time": "2026-05-20 15:30:10",
      "sku_list": {
        "sku": [
          {
            "sku_id": "123456789001",
            "properties_name": "White / L",
            "price": "59.00",
            "quantity": 120
          },
          {
            "sku_id": "123456789002",
            "properties_name": "Black / XL",
            "price": "59.00",
            "quantity": 95
          }
        ]
      }
    },
    "request_id": "2026052015301000123"
  }
}

6. Core Field Explanation

num_iid: Unique product ID, the primary key for data synchronization
title: Product official title
price / promotion_price: Original price and discount price
num: Current stock quantity
sales: Cumulative sales volume
pic_url: Main product image URL
sku_list: Multi-specification price and inventory data
modified_time: Last update time for incremental synchronization
request_id: Full-link tracking ID for error troubleshooting

7. Enterprise Stability Guarantee Strategy

Control QPS frequency to avoid platform flow restriction
Retry mechanism for network timeout and 5xx errors
Strict data validation for price, stock and fields
Redis cache optimization to reduce API pressure
Incremental update based on modified_time
Full log recording and abnormal alarm monitoring

8. Summary

Taobao and 1688 Product API provides stable, standardized, and official compliant e-commerce commodity data services. It is the core data source for enterprise-level e-commerce systems, including commodity synchronization, distribution business, price monitoring, and data analysis. With standardized request logic, data verification, caching and flow control strategies, developers can ensure long-term stable operation of production-level business systems.