京东评论接口实战指南:从官方 API 接入到评论数据深度分析

admin11小时前京东api8

一、为什么需要京东评论接口?

在电商运营中,商品评论是用户真实反馈的黄金数据源。一条差评可能在数小时内影响数百人的购买决策,而逐条手动翻页查看评论不仅效率极低,更无法做到规模化分析。通过京东评论接口,可以程序化获取商品评价数据,实现:
  • 口碑监控:实时追踪自家商品和竞品的用户反馈
  • 产品迭代:从海量评论中提取用户痛点,指导产品改进
  • 竞品分析:对比同类商品的好评率、差评集中点
  • 舆情预警:自动识别负面关键词,分钟级响应危机
京东评论接口主要分为两类:京东开放平台官方 API(合规、稳定、推荐)和前端评论接口(需爬虫,存在反爬风险)。本文重点讲解官方 API 的接入与实战。

二、接入准备:账号、权限与密钥

2.1 注册与认证

  1. 访问 京东开放平台,注册开发者账号
  2. 完成实名认证(企业用户需提交营业执照 + 近 3 个月经营流水)
  3. 创建应用,选择「自研应用」或「联盟应用」类型

2.2 申请接口权限

2026 年京东开放平台实行权限分级新规,评论接口权限如下:
表格
权限等级适用人群可获取数据QPS 限制申请要求
基础权限个人开发者商品名称、价格、主图、基础销量、评价摘要5实名认证
进阶权限企业用户+ 促销详情、评价原文、店铺评分、优惠券20企业营业执照
高级权限联盟合作伙伴+ 实时销量、商品成长指数、点击转化率60数据用途承诺书
⚠️ 注意:评价原文需单独申请权限,评论数据默认仅返回近 180 天 的用户评价。

2.3 获取密钥

审核通过后,在应用管理后台获取:
  • App Key:应用标识
  • App Secret:签名密钥
  • Access Token:OAuth2.0 访问令牌

三、接口详解与核心参数

3.1 接口基础信息

表格
项目说明
接口方法jd.union.open.goods.comment.query(联盟版)/ jd.item.review(通用版)
网关地址https://api.jd.com/routerjson
传输协议HTTPS,推荐 POST(参数量大防截断)
返回格式JSON
鉴权方式AppKey + AppSecret MD5 签名 + AccessToken OAuth2.0 双鉴权
单页上限50-100 条/页
总量限制通常限制 1000 条/商品
数据时效近 180 天

3.2 公共请求参数(所有 JOS 接口通用)

表格
参数名类型必填说明
methodString接口方法名,如 jd.union.open.goods.comment.query
app_keyString应用分配的 App Key
access_tokenStringOAuth 授权令牌
timestampString请求时间戳,格式 yyyy-MM-dd HH:mm:ss
formatString返回格式,固定 json
vString接口版本,固定 2.0
sign_methodString签名方法,固定 md5
param_jsonString业务入参 JSON 字符串
signString参数字典序 MD5 签名

3.3 业务参数(param_json 内)

表格
参数名类型必填说明
skuIdString京东商品 SKU 编号
pageIndexInt页码,从 1 开始
pageSizeInt每页条数,最大 100
scoreInt评分筛选:0-全部,1-差评,2-中评,3-好评,4-晒单,5-视频评价
isImageInt是否只查带图评论:0-全部,1-带图
needAfterReviewInt是否需要追评:0-不需要,1-需要

3.4 核心返回字段

JSON
{
  "commentId": "评论唯一ID",
  "content": "评论正文",
  "rating": 5,
  "creationTime": "2026-07-15 14:30:00",
  "skuAttr": "颜色:黑色;尺码:XL",
  "pictures": ["图片URL1", "图片URL2"],
  "afterSaleReview": {
    "content": "追评内容",
    "creationTime": "2026-07-20 10:00:00"
  },
  "userNickName": "匿名用户",
  "userLevel": "PLUS会员"}

四、Python 实战:从接口调用到全量采集

4.1 MD5 签名生成(核心且易踩坑)点击测试获取key

京东 API 的签名规则是:AppSecret 放首尾,中间按参数名字典序拼接 key+value,最后整体 MD5 加密转大写。这是新手最容易出错的地方。
Python
import hashlibimport jsonimport timeimport requests

APP_KEY = "你的AppKey"APP_SECRET = "你的AppSecret"ACCESS_TOKEN = "你的AccessToken"API_URL = "https://api.jd.com/routerjson"def generate_sign(params: dict, app_secret: str) -> str:
    """
    京东 API MD5 签名生成
    规则:app_secret + 按key排序后的keyvalue拼接 + app_secret,整体MD5转大写
    """
    # 过滤空值,按key字典序排序
    sorted_items = sorted(
        [(k, v) for k, v in params.items() if v is not None and v != ""],
        key=lambda x: x[0]
    )
    
    # 拼接签名字符串
    sign_str = app_secret    for k, v in sorted_items:
        sign_str += f"{k}{v}"
    sign_str += app_secret    
    # MD5加密并转大写
    return hashlib.md5(sign_str.encode("utf-8")).hexdigest().upper()def fetch_comments_page(sku_id: str, page: int = 1, page_size: int = 20, score: int = 0):
    """
    单页评论采集
    """
    # 业务参数
    biz_params = {
        "skuId": sku_id,
        "pageIndex": page,
        "pageSize": page_size,
        "score": score,
        "isImage": 0,
        "needAfterReview": 1
    }
    
    # 公共参数
    common_params = {
        "app_key": APP_KEY,
        "method": "jd.union.open.goods.comment.query",
        "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
        "format": "json",
        "v": "2.0",
        "sign_method": "md5",
        "access_token": ACCESS_TOKEN,
        "param_json": json.dumps(biz_params, separators=(",", ":"))
    }
    
    # 生成签名(注意:签名时不包含 sign 字段本身)
    common_params["sign"] = generate_sign(common_params, APP_SECRET)
    
    try:
        response = requests.get(API_URL, params=common_params, timeout=15)
        data = response.json()
        
        # 解析响应
        result = data.get("jd_union_open_goods_comment_query_res", {}).get("result", {})
        comments = result.get("comments", [])
        return {
            "comments": comments,
            "total": result.get("totalCount", 0),
            "good_rate": result.get("goodRate", 0)
        }
    except Exception as e:
        print(f"请求失败:{e}")
        return {"comments": [], "total": 0, "good_rate": 0}

4.2 全量评论采集(自动分页 + 流控)

Python
import pandas as pdfrom time import sleepdef crawl_all_comments(sku_id: str, max_pages: int = 50, score: int = 0):
    """
    全量采集商品评论,自动分页,带流控和容错
    """
    all_comments = []
    page = 1
    
    print(f"开始采集商品 {sku_id} 的评论...")
    
    while page <= max_pages:
        result = fetch_comments_page(sku_id, page=page, score=score)
        comments = result.get("comments", [])
        
        if not comments:
            print(f"第 {page} 页无数据,采集结束")
            break
        
        for c in comments:
            after = c.get("afterSaleReview") or {}
            row = {
                "comment_id": c.get("commentId"),
                "sku_id": sku_id,
                "star": c.get("rating", 5),
                "content": c.get("content", ""),
                "after_comment": after.get("content", ""),
                "spec": c.get("skuAttr", ""),
                "create_time": c.get("creationTime"),
                "has_img": 1 if c.get("pictures") else 0,
                "user_nick": c.get("userNickName", ""),
                "user_level": c.get("userLevel", "")
            }
            all_comments.append(row)
        
        print(f"第 {page} 页采集完成,本页 {len(comments)} 条,累计 {len(all_comments)} 条")
        
        # 流控:避免触发限流,每页间隔 0.5-1 秒
        sleep(0.6)
        page += 1
    
    df = pd.DataFrame(all_comments)
    df.to_csv(f"jd_comments_{sku_id}.csv", index=False, encoding="utf-8-sig")
    print(f"采集完成!共 {len(df)} 条评论,已保存至 jd_comments_{sku_id}.csv")
    return dfif __name__ == "__main__":
    # 示例:采集 iPhone 16 的评论(替换为真实 SKU)
    df = crawl_all_comments(sku_id="100012043978", max_pages=20)

五、数据清洗与 NLP 深度分析

采集到原始评论后,需要进行清洗和结构化分析,才能产生业务价值。

5.1 数据清洗

Python
import reimport jieba# 停用词表STOPWORDS = set(["的", "了", "很", "非常", "还是", "但是", "觉得", 
                 "这个", "那个", "一个", "有点", "感觉", "就是"])def clean_comment(text: str) -> str:
    """评论文本清洗"""
    if not isinstance(text, str):
        return ""
    # 去除HTML标签
    text = re.sub(r'<[^>]+>', '', text)
    # 去除特殊符号,保留中文、英文、数字
    text = re.sub(r'[^\u4e00-\u9fa5a-zA-Z0-9]', ' ', text)
    # 去除多余空格
    text = re.sub(r'\s+', ' ', text).strip()
    return textdef tokenize(text: str) -> list:
    """分词并过滤停用词"""
    words = jieba.lcut(text)
    return [w for w in words if len(w) >= 2 and w not in STOPWORDS]

5.2 情感分析(SnowNLP 快速版)

Python
from snownlp import SnowNLPdef analyze_sentiment(text: str):
    """
    情感分析:>0.6 好评,0.3-0.6 中评,<0.3 差评
    """
    if not text or len(text) < 3:
        return 0.5, "中性"
    
    try:
        score = SnowNLP(text).sentiments        if score > 0.6:
            label = "好评"
        elif score >= 0.3:
            label = "中评"
        else:
            label = "差评"
        return round(score, 3), label    except:
        return 0.5, "未知"# 批量分析df["clean_content"] = df["content"].apply(clean_comment)df[["sentiment_score", "sentiment_label"]] = df["clean_content"].apply(
    lambda x: pd.Series(analyze_sentiment(x)))

5.3 差评关键词提取(定位产品痛点)

Python
import jieba.analyse# 提取差评文本bad_comments = df[df["sentiment_label"] == "差评"]["clean_content"].tolist()bad_text = " ".join(bad_comments)# TF-IDF 提取关键词keywords = jieba.analyse.extract_tags(
    bad_text, 
    topK=30, 
    withWeight=True,
    allowPOS=("n", "v", "a")  # 只保留名词、动词、形容词)print("差评高频痛点 TOP10:")for word, weight in keywords[:10]:
    print(f"  {word}: {weight:.4f}")

5.4 可视化:情感分布 + 差评词云

Python
import matplotlib.pyplot as pltfrom wordcloud import WordCloud

plt.rcParams["font.sans-serif"] = ["SimHei"]plt.rcParams["axes.unicode_minus"] = False# 1. 情感分布饼图sent_counts = df["sentiment_label"].value_counts()colors = {"好评": "#52c41a", "中评": "#faad14", "差评": "#f5222d"}plt.figure(figsize=(6, 6))plt.pie(
    sent_counts.values, 
    labels=sent_counts.index, 
    autopct="%1.1f%%",
    colors=[colors.get(l, "#999") for l in sent_counts.index])plt.title("评论情感分布", fontsize=14, fontweight="bold")plt.savefig("sentiment_pie.png", dpi=150)plt.close()# 2. 差评词云if bad_text:
    wc = WordCloud(
        font_path="C:/Windows/Fonts/simhei.ttf",  # Linux/Mac 请替换路径
        width=900, 
        height=500,
        background_color="white",
        colormap="Reds"
    )
    wc.generate(bad_text)
    wc.to_file("bad_wordcloud.png")

六、避坑指南与合规红线

6.1 常见错误码与解决方案

表格
错误码含义解决方案
10001入参异常检查 app_key 是否为空,请求体是否超过 3M
4001签名错误检查密钥、参数排序、编码是否合规,注意大小写
403权限不足确认接口权限是否已开通,Token 是否过期
429频率限制采用指数退避重试,降低 QPS

6.2 合规红线(务必遵守)

  1. 仅使用官方开放 API 获取数据,禁止抓包逆向前端匿名接口、代理爬虫批量爬取
  2. 调用频次严格遵循平台 QPS 限流规则,基础权限 QPS 为 5,超限可能导致 IP 被封禁
  3. 数据用途合规:仅限企业竞品调研、市场分析自用,禁止倒卖用户评论隐私数据
  4. 评论隐私保护:评价原文需单独申请权限,禁止泄露用户个人信息
  5. 数据延迟认知:库存、价格数据可能存在 5-10 分钟延迟,评论数据仅保留近 180 天

七、典型应用场景

场景 1:品牌口碑监控系统

定时采集自家商品和核心竞品的评论,通过关键词预警(如"质量问题""假货""破损")触发钉钉/企业微信告警,自动生成周报统计好评率和差评 TOP 问题。

场景 2:产品迭代决策支持

批量提取差评中的高频关键词,定位用户集中吐槽点(如"物流慢""包装差""尺寸不准"),为产品改进和供应链优化提供数据依据。

场景 3:竞品评论对比分析

同时采集 3-5 款竞品商品的评论,对比好评率、差评集中属性、用户关注维度,输出竞品口碑雷达图,辅助制定差异化营销策略。


相关文章

京东商品详情页数据分析:从数据洞察到运营增长的实战指南

一、为什么详情页数据是电商运营的核心战场在京东平台,商品详情页是流量承接与转化的"最后一公里"。用户从搜索、推荐或广告进入详情页后,页面质量直接决定了是否产生购买行为。据京东商智数...

Python代码获取京东商品详情原数据 API 接口(item_get_app)

一、接口概述京东的 item_get_app 接口用于获取商品的原始详情数据,包括商品的基础信息、价格信息、库存信息、规格参数、促销信息、服务信息以及多媒体信息等。二、前期准备(一)注册京东开放平台账...

京东关键词搜索接口完全指南

一、接口体系概览京东提供两套核心的商品搜索接口,分别服务于不同场景:表格接口类型核心接口适用场景数据特点权限要求京东联盟jd.union.open.goods.searchCPS推广、选品、导购含佣金...

Java获取京东商品详情接口(item_get)实战指南

一、接口概述京东开放平台API体系表格接口名称功能说明应用场景jd.item.get获取单个商品详情商品信息同步、详情展示jd.item.search关键词搜索商品选品、比价系统jd.item.sku...

实战解析:京东关键词搜索 item_search_pro —— 按关键字搜索商品

一、接口定位item_search_pro 并不是京东官方文档里出现的接口名,而是第三方服务商对「京东关键词搜索商品」能力的封装代号。它本质上调用的是京东联盟开放平台里的jd.union.open.g...

Python 爬虫获取京东商品详情 API 接口实战指南

本文将详细介绍如何使用 Python 调用京东商品详情 API 接口,涵盖官方开放平台 API、第三方代理接口以及网页逆向三种方案,包含完整的代码示例和最佳实践。一、方案概述1. 官方开放平台 API...

发表评论    

◎欢迎参与讨论,请在这里发表您的看法、交流您的观点。