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

4 阅读2分钟

一、接口概述

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

二、核心参数说明

  1. 商品IDskuId(必填)

    • 格式:数字字符串,如100000000001
    • 获取方式:商品详情页URL中的数字标识
  2. 分页参数

    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
  }
}

五、注意事项

  1. 频率限制:单账号每分钟不超过100次请求
  2. 数据时效:接口返回最近180天内的评论
  3. 敏感字段:用户昵称自动脱敏处理
  4. 认证要求:需提前在京东开放平台创建应用获取app_keyapp_secret

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


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