获得1688商品评论 API

item_review-获得1688商品评论 [查看演示] API测试工具 注册开通

onebound.1688.item_review

公共参数

请求地址: api-gw.onebound.cn/1688/item_r…

名称	类型	必须	描述
key	String	是	调用key（必须以GET方式拼接在URL中）
secret	String	是	调用密钥
api_name	String	是	API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]
cache	String	否	[yes,no]默认yes，将调用缓存的数据，速度比较快
result_type	String	否	[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读
lang	String	否	[cn,en,ru]翻译语言，默认cn简体中文
version	String	否	API版本

请求参数

请求参数：num_iid=612398037607&user_id=3838217801&nick=浙江祥珑科技

参数说明：num_iid:1688商品ID
user_id卖家id
nick卖家昵称

响应参数

Version: Date:

名称	类型	必须	示例值	描述
items	items[]	0		商品评论数据
num_iid	String	0	612398037607	商品ID
total_results	String	0	10+	货品评分
detail_url	String	0	rate2.m.1688.com/page/rateLi…	评论链接
item	item[]	0
content	String	0	好评	评论内容
explanation	Mix	0
gmtExplanation	Mix	0
gmtPublished	String	0	2020-08-29 19:06:39	评论时间
isSystemRemark	Mix	0
isTaobaoMember	Mix	0
levelImg	String	0	gw.alicdn.com/tfs/TB1HlZK…	评论图片
quantity	Float	0	1.0	库存
raterUserNick	String	0	r**1	旺旺名
specInfo	String	0	颜色:可爱喵+3米延长线	购买的商品规格
starLevel	String	0	5	评分等级
unit	String	0	个	单位

请求示例

• Curl
• PHP
• PHPsdk
• JAVA
• C#
• Python

	
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/1688/item_review/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=612398037607&user_id=3838217801&nick=浙江祥珑科技"

响应示例

{
	"items": {
		"num_iid": "612398037607",
		"total_results": "10+",
		"rate_average": "5.0",
		"good_percent": "好评率100%",
		"detail_url": "https://rate2.m.1688.com/page/rateListForOffer.html?offerId=612398037607&sellerLoginId=浙江祥珑科技&offerScene=dsc",
		"item": [
			{
				"content": "好评。",
				"explanation": null,
				"gmtExplanation": null,
				"gmtPublished": "2020-08-29 19:06:39",
				"isSystemRemark": "false",
				"isTaobaoMember": "1",
				"levelImg": "https://gw.alicdn.com/tfs/TB1HlZKoAcx_u4jSZFlXXXnUFXa-60-39.png",
				"quantity": "1.0",
				"raterUserNick": "r**1",
				"specInfo": "颜色:可爱喵+3米延长线",
				"starLevel": "5",
				"unit": "个"
			},
			{
				"content": "好评。",
				"explanation": null,
				"gmtExplanation": null,
				"gmtPublished": "2020-08-02 10:43:27",
				"isSystemRemark": "false",
				"isTaobaoMember": "1",
				"levelImg": "https://gw.alicdn.com/tfs/TB1HlZKoAcx_u4jSZFlXXXnUFXa-60-39.png",
				"quantity": "1.0",
				"raterUserNick": "r**1",
				"specInfo": "颜色:萌小黄+定时线",
				"starLevel": "5",
				"unit": "个"
			},
			{
				"content": "好评。",
				"explanation": null,
				"gmtExplanation": null,
				"gmtPublished": "2020-07-21 21:30:12",
				"isSystemRemark": "false",
				"isTaobaoMember": "1",
				"levelImg": "https://gw.alicdn.com/tfs/TB1HlZKoAcx_u4jSZFlXXXnUFXa-60-39.png",
				"quantity": "1.0",
				"raterUserNick": "r**1",
				"specInfo": "颜色:饭团+3米延长线",
				"starLevel": "5",
				"unit": "个"
			},
			{
				"content": "好评。",
				"explanation": null,
				"gmtExplanation": null,
				"gmtPublished": "2020-07-07 00:04:41",
				"isSystemRemark": "false",
				"isTaobaoMember": "1",
				"levelImg": "https://gw.alicdn.com/tfs/TB1HlZKoAcx_u4jSZFlXXXnUFXa-60-39.png",
				"quantity": "2.0",
				"raterUserNick": "r**1",
				"specInfo": "颜色:萌小黄+3米延长线|颜色:萌大白+3米延长线",
				"starLevel": "5",
				"unit": "个"
			},
			{
				"content": "好评。",
				"explanation": null,
				"gmtExplanation": null,
				"gmtPublished": "2020-06-19 10:36:17",
				"isSystemRemark": "false",
				"isTaobaoMember": "1",
				"levelImg": "https://gw.alicdn.com/tfs/TB1HlZKoAcx_u4jSZFlXXXnUFXa-60-39.png",
				"quantity": "1.0",
				"raterUserNick": "r**1",
				"specInfo": "颜色:萌大白",
				"starLevel": "5",
				"unit": "个"
			},
			{
				"content": "好评。",
				"explanation": null,
				"gmtExplanation": null,
				"gmtPublished": "2020-06-19 10:36:03",
				"isSystemRemark": "false",
				"isTaobaoMember": "1",
				"levelImg": "https://gw.alicdn.com/tfs/TB1HlZKoAcx_u4jSZFlXXXnUFXa-60-39.png",
				"quantity": "1.0",
				"raterUserNick": "r**1",
				"specInfo": "颜色:萌大白+定时线",
				"starLevel": "5",
				"unit": "个"
			}
		],
		"data_from": "1688app"
	},
	"secache": "4eafb7d1ba85181a0f9fa8e658351f5c",
	"secache_time": 1649993685,
	"secache_date": "2022-04-15 11:34:45",
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "cn",
		"current_lang": "cn"
	},
	"error": "",
	"reason": "",
	"error_code": "0000",
	"cache": 0,
	"api_info": "today:9 max:11000",
	"execution_time": "3.592",
	"server_time": "Beijing/2022-04-15 11:34:45",
	"client_ip": "106.6.33.38",
	"call_args": {
		"num_iid": "612398037607",
		"data": "3838217801",
		"page": "浙江祥珑科技"
	},
	"api_type": "1688",
	"translate_language": "zh-CN",
	"translate_engine": "google_new",
	"server_memory": "0.76MB",
	"request_id": "gw-4.6258e7d1b5595",
	"last_id": "885798952"}
```
```
异常示例

```
{
  "error": "item-not-found",
  "reason": "商品没找到",
  "error_code": "2000",
  "success": 0,
  "cache": 0,
  "api_info": "today:0 max:10000",
  "execution_time": 0.081,
  "server_time": "Beijing/2020-06-10 23:44:00",
  "call_args": [],
  "api_type": "1688",
  "request_id": "1ee0ffc041242"}
```

[]()相关资料错误码解释

| 状态代码(error_code) | 状态信息                               | 详细描述            | 是否收费 |
| ---------------- | ---------------------------------- | --------------- | ---- |
| 0000             | success                            | 接口调用成功并返回相关数据   | 是    |
| 2000             | Search success but no result       | 接口访问成功，但是搜索没有结果 | 是    |
| 4000             | Server internal error              | 服务器内部错误         | 否    |
| 4001             | Network error                      | 网络错误            | 否    |
| 4002             | Target server error                | 目标服务器错误         | 否    |
| 4003             | Param error                        | 用户输入参数错误        | 忽略   |
| 4004             | Account not found                  | 用户帐号不存在         | 忽略   |
| 4005             | Invalid authentication credentials | 授权失败            | 忽略   |
| 4006             | API stopped                        | 您的当前API已停用      | 忽略   |
| 4007             | Account stopped                    | 您的账户已停用         | 忽略   |
| 4008             | API rate limit exceeded            | 并发已达上限          | 忽略   |
| 4009             | API maintenance                    | API维护中          | 忽略   |
| 4010             | API not found with these values    | API不存在          | 忽略   |
| 4012             | Please add api first               | 请先添加api         | 忽略   |
| 4013             | Number of calls exceeded           | 调用次数超限          | 忽略   |
| 4014             | Missing url param                  | 参数缺失            | 忽略   |
| 4015             | Wrong pageToken                    | 参数pageToken有误   | 忽略   |
| 4016             | Insufficient balance               | 余额不足            | 忽略   |
| 4017             | timeout error                      | 请求超时            | 否    |
| 5000             | unknown error                      | 未知错误            | 否