1688商品评论API使用指南

一、前言

1688（阿里巴巴批发网）商品评论 API 是用于获取平台批发商品买家评论数据的核心接口，可支撑供应商口碑评估、商品质量分析、批发市场调研等场景。需明确的是：1688 官方未向普通开发者开放通用的商品评论公开 API，仅针对入驻商家、企业级合作伙伴提供合规的数据接口权限（需通过 1688 开放平台申请）；本文展示的方案基于合理的网络爬虫策略（遵守 1688 平台规则、robots 协议及《网络安全法》《电子商务法》等法律法规），仅限技术学习和非商用场景参考。

二、接口概述

2.1 核心能力

通过商品 ID（offerId）获取 1688 商品的评论核心信息，包括：

评论基础信息：买家昵称、评论内容、评分（1-5 分）、评论时间；

采购相关信息：买家采购规格、采购数量、成交金额；

多媒体信息：晒单图片 / 视频、追评内容；

统计信息：评论总数、好评率、中差评数量；

商家回复：商家对评论的回复内容、回复时间。

请求地址：c0b.cc/R4rbK2 。

2.2 接口参数说明（非官方标准，基于爬虫适配）

1688 商品评论数据通过异步接口动态加载，核心请求参数如下（需适配平台接口更新）：

参数名类型必选说明

offerIdString是1688 商品 ID（offer ID），商品详情页 URL 中1688.com/offer/[offerId].html

pageNumInt否评论页码，默认 1（部分接口页码从 0 开始）

pageSizeInt否每页评论数，默认 20，最大 20

typeInt否评论类型筛选：0 - 全部、1 - 好评、2 - 中评、3 - 差评、5 - 带图评论、6 - 追评

sellerIdString否商家 ID（可选，从商品页解析，提升请求成功率）

_csrf_tokenString否防跨域令牌（部分接口需携带，从 Cookie 解析）

2.3 返回数据结构（示例）

以下为简化后的核心数据结构（实际返回字段更丰富，含加密 / 混淆字段）：

json

{"success":true,"data":{"totalCount":589,// 评论总数"goodRate":99.2,// 好评率（%）"goodCount":585,// 好评数"middleCount":3,// 中评数"badCount":1,// 差评数"comments":[{"id":"1234567890","buyerNick":"采购商_12345",// 脱敏后的买家昵称"content":"商品质量符合预期，发货快，批量采购性价比高！","score":5,// 评分（1-5分）"createTime":"2025-11-20 15:30:00","purchaseSpec":"规格：200g/袋 | 采购数量：100袋","hasImage":true,// 是否晒单"imageUrls":["https://xxx.1688.com/xxx.jpg"],// 晒单图片"isAppend":false,// 是否追评"sellerReply":"感谢您的认可，期待再次合作！"// 商家回复}]}}

2.4 注意事项

1688 反爬机制严格，高频请求会触发 IP 封禁、滑块验证、Cookie 失效等风控措施；

评论数据为动态渲染（AJAX 加载），直接爬取静态 HTML 无法获取完整数据；

买家信息、采购数据均做脱敏处理，无法获取真实隐私信息；

部分商家会隐藏中差评，返回的评论数据可能存在筛选 Bias；

非商用场景需控制请求频率（单 IP 每分钟≤3 次），避免触发风控。

三、Python 请求示例

# coding:utf-8

""" Compatible for python2.x and python3.x requirement: pip install requests """

from __future__ import print_function

import requests

# 请求示例 url 默认请求参数已经做URL编码

url = "1688/item_review/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=612398037607&user_id=3838217801&nick=浙江祥珑科技&page=1" headers = { "Accept-Encoding": "gzip", "Connection": "close" } if __name__ == "__main__": r = requests.get(url, headers=headers) json_obj = r.json() print(json_obj)

3.3 代码说明

接口适配：采用 1688 评论的异步 JSON 接口（而非静态 HTML），确保获取完整数据；

反爬策略：

添加随机延迟（2-5 秒），避免高频请求；

模拟 AJAX 请求头（X-Requested-With），贴合浏览器行为；

携带时间戳参数（_），防止接口缓存；

数据解析：

使用jsonpath简化 JSON 嵌套数据提取；

正则解析采购规格等结构化信息；

兼容接口字段缺失的情况，避免程序崩溃；

异常处理：覆盖超时、连接错误、接口返回失败等场景，保证程序稳定性；

Cookie 配置：登录 1688 后，从浏览器「开发者工具→网络→请求头」复制 Cookie 填入，可大幅提升请求成功率（Cookie 有效期约 1-7 天）。

四、结语

4.1 合规性优先

本文示例仅用于技术学习和非商用场景，商用场景必须通过 1688 开放平台申请正规接口权限。1688 开放平台为企业用户提供「商品评论查询」「供应商口碑分析」等合规接口，需提供企业资质、签署合作协议，部分接口需缴纳服务费，但数据稳定性和合法性有保障。

4.2 风控优化建议

若需长期使用非官方方式获取少量学习用数据，需做好以下风控措施：

IP 池管理：使用代理 IP 池轮换 IP，避免单一 IP 高频请求；

Cookie 池：维护多个 1688 账号的有效 Cookie，轮换使用；

请求频率控制：单 IP / 账号每分钟请求≤3 次，峰值时段（9:00-18:00）进一步降低频率；

验证码处理：若触发滑块验证，需集成验证码识别工具（如 ddddocr），或手动验证；

接口适配：1688 接口参数 / 返回格式会不定期更新，需定期维护解析规则。

4.3 商用替代方案

1688 开放平台：申请「供应链数据 API」「商品口碑分析 API」，合规获取批量评论数据；

第三方合规数据源：通过阿里巴巴旗下的数智化服务平台（如阿里云数据市场）获取授权数据；

商家自有数据：入驻商家可通过「卖家工作台」导出自有商品的评论数据，无需爬取。

4.4 稳定性说明

非官方接口无任何稳定性保障，1688 可能通过接口加密、参数变更、风控升级等方式限制访问。因此，基于爬虫的方案仅适合小量、临时的数据分析场景，大规模、长期的应用需依赖 1688 开放平台的合规接口。

综上，1688 商品评论数据的获取需在「技术实现」和「合规性」之间找到平衡，优先选择官方开放平台的解决方案，既保证数据的稳定性，也规避法律和风控风险。

审核编辑 黄宇