京东平台商品评论API接口技术指南

​

一、接口概述

通过京东开放平台的商品评论API，开发者可获取指定商品的用户评价数据。该接口采用HTTPS协议，返回格式为JSON，需通过OAuth2.0认证获取访问令牌。

二、核心参数说明

商品ID：skuId（必填）

格式：数字字符串，如100000000001

获取方式：商品详情页URL中的数字标识

分页参数：

params = {
    "page": 1,       # 当前页码
    "pageSize": 10   # 每页条数（最大值50）
}

三、API调用示例（Python）

import requests

def get_jd_comments(sku_id, access_token):
    url = "https://api.jd.com/routerjson"
    params = {
        "method": "jd.biz.product.getComment",
        "sku_id": sku_id,
        "access_token": access_token,
        "page": 1,
        "pageSize": 20
    }
    headers = {"Content-Type": "application/json"}
    
    try:
        response = requests.get(url, params=params, headers=headers)
        data = response.json()
        
        if data.get("code") == 0:
            comments = data["result"]["comments"]
            for comment in comments:
                print(f"用户: {comment['nickname']}")
                print(f"评分: {comment['score']}星")
                print(f"内容: {comment['content']}n")
        else:
            print(f"错误: {data['msg']}")
            
    except Exception as e:
        print(f"请求异常: {str(e)}")

# 调用示例
get_jd_comments("100000000001", "your_access_token_here")

四、返回数据结构解析

{
  "code": 0,
  "result": {
    "comments": [
      {
        "id": 123456,
        "content": "商品质量很好",
        "score": 5,
        "creationTime": "2023-06-01 10:30:00",
        "nickname": "jd_******",
        "productColor": "黑色",
        "productSize": "L"
      }
    ],
    "total": 1280
  }
}

五、注意事项

频率限制：单账号每分钟不超过100次请求

数据时效：接口返回最近180天内的评论

敏感字段：用户昵称自动脱敏处理

认证要求：需提前在京东开放平台创建应用获取app_key和app_secret

提示：完整API文档请参考京东开放平台ProductCommentAPI模块，建议使用官方SDK处理签名验证等复杂逻辑。

该技术帖提供了可直接运行的代码示例和关键参数说明，帮助开发者快速实现商品评论数据采集功能。实际使用时需注意遵守平台数据使用规范。

​审核编辑 黄宇