注册开通
公共参数
名称 | 类型 | 必须 | 描述 |
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=600530677643&data=&page=1
参数说明：num_iid:商品ID
sort:排序 0：默认排序 ，1： 最新排序
响应参数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
rate_content | String | 0 | 衣服面料很好 穿起来很舒服 衣服挺合适的！ | 评论内容 |
rate_date | Date | 0 | 2019-03-16 12:10:24 | 评论日期 |
pics | MIX | 0 | ["//img.alicdn.com/bao/uploaded/i4/O1CN01Zmq4QI1dqwnpBIxmX_!!0-rate.jpg"] | 评论图片 |
display_user_nick | String | 0 | 李***0 | 买家昵称 |
auction_sku | String | 0 | 颜色:加绒;尺码:2XL | 评论商品属性 |
rate_id | String | 0 | 1182747118197 | 评论ID |
add_feedback | String | 0 | 衣服面料很好 穿起来很舒服 衣服挺合适的！ | 追评内容 |
add_feedback_images | MIX | 0 | ["//img.alicdn.com/bao/uploaded/i4/O1CN01Zmq4QI1dqwnpBIxmX_!!0-rate.jpg"] | 追评图片 |
video | String | 0 | 视频地址 | |
videoCover | String | 0 | https://img.alicdn.com/imgextra/i3/O1CN01cvjYjY28SRpqyDJIN_!!0-tbbala.jpg | 视频截图 |
请求示例
- Curl
- PHP
- PHPsdk
- JAVA
- C#
- Python
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/taobao/item_review/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=600530677643&data=&page=1"
响应示例
{
"items": {
"totalpage": 4,
"total_results": "70",
"page_size": 20,
"page": "1",
"item": [
{
"rate_content": "此用户没有填写评价。",
"rate_date": "2022-08-28",
"pics": [],
"display_user_nick": "",
"auction_sku": "尺码:37;颜色分类:黑色【内里：超细纤维】",
"add_feedback": "",
"add_feedback_images": [],
"create_time_interval": "5个月前",
"read_count": "0",
"rate_id": "1185790146502",
"comment_count": "0",
"like_count": [],
"user_star": "9",
"user_star_pic": "https://img.alicdn.com/imgextra/i3/O1CN01PIYxrZ22FGrmiDphN_!!6000000007090-2-tps-92-45.png"
},
{
"rate_content": "太漂亮了 本来买的时候犹豫很久很久很久 从来没有买过黄色的 觉得不好配衣服也觉得图片一般 犹豫了有一天终于下定决心去买一个试试 结果太太太太让我惊喜了 太漂亮了 很亮鞋子特别舒服 我买的大一点 也很舒服 还挺好配衣服的 后悔就买一双了 现在我家都是她家的鞋子了 绝对的YYDS",
"rate_date": "2022-08-23",
"pics": [],
"display_user_nick": "",
"auction_sku": "尺码:36;颜色分类:黄色【内里：超细纤维】",
"add_feedback": "",
"add_feedback_images": [],
"create_time_interval": "5个月前",
"read_count": "0",
"rate_id": "1184973493639",
"comment_count": "0",
"like_count": [],
"user_star": "8",
"user_star_pic": "https://img.alicdn.com/imgextra/i4/O1CN019QZnaG1U1LtUAPn6e_!!6000000002457-2-tps-92-45.png"
},
{
"rate_content": "鞋子很满意，3号客服棒棒哒，长毛绒也很暖和 ",
"rate_date": "2021-12-05",
"pics": [
"//img.alicdn.com/imgextra/i2/0/O1CN01DD4Zcv1IxGY6IPN73_!!0-rate.jpg",
"//img.alicdn.com/imgextra/i1/0/O1CN0189R9CP1IxGYCdWZyV_!!0-rate.jpg"
],
"display_user_nick": "",
"auction_sku": "尺码:39;颜色分类:黑色【内里：长毛绒】",
"add_feedback": "",
"add_feedback_images": [],
"create_time_interval": "1年前",
"read_count": "39",
"rate_id": "1158296533060",
"comment_count": "0",
"like_count": [],
"user_star": "7",
"user_star_pic": "https://img.alicdn.com/imgextra/i4/O1CN01ZlCYMx1nbVriw6u0S_!!6000000005108-2-tps-92-45.png"
},
{
"rate_content": "面料材质：材质有一点点硬，版型不错，整体还凑合，对得起这个价格 ",
"rate_date": "2021-11-16",
"pics": [
"//img.alicdn.com/imgextra/i3/0/O1CN01TrfEtd2M3Ag2ClelC_!!0-rate.jpg"
],
"display_user_nick": "",
"auction_sku": "尺码:39;颜色分类:黑色【内里：长毛绒】",
"add_feedback": "",
"add_feedback_images": [],
"create_time_interval": "1年前",
"read_count": "165",
"rate_id": "1155310540482",
"comment_count": "0",
"like_count": [],
"user_star": "7",
"user_star_pic": "https://img.alicdn.com/imgextra/i4/O1CN01ZlCYMx1nbVriw6u0S_!!6000000005108-2-tps-92-45.png"
},
{
"rate_content": "买第二双了，鞋子很漂亮也挺舒服",
"rate_date": "2021-11-09",
"pics": [],
"display_user_nick": "",
"auction_sku": "尺码:39;颜色分类:黄色【内里：超细纤维】",
"add_feedback": "",
"add_feedback_images": [],
"create_time_interval": "1年前",
"read_count": "1",
"rate_id": "1154131764289",
"comment_count": "0",
"like_count": [],
"user_star": "8",
"user_star_pic": "https://img.alicdn.com/imgextra/i4/O1CN019QZnaG1U1LtUAPn6e_!!6000000002457-2-tps-92-45.png"
},
{
"rate_content": "7号客服棒棒哒，鞋子很喜欢，已第三次购买 ",
"rate_date": "2021-10-31",
"pics": [
"//img.alicdn.com/imgextra/i3/0/O1CN01hPcYYn1EzJr4JSAzG_!!0-rate.jpg",
"//img.alicdn.com/imgextra/i1/0/O1CN01Fjvoou25NSkm50Bp2_!!0-rate.jpg",
"//img.alicdn.com/imgextra/i4/0/O1CN01mBc4V91txqplVs6o6_!!0-rate.jpg",
"//img.alicdn.com/imgextra/i3/0/O1CN01YFUXAj1Whbcfv3TRJ_!!0-rate.jpg"
],
"display_user_nick": "",
"auction_sku": "尺码:39;颜色分类:黑色【内里：超细纤维】",
"add_feedback": "",
"add_feedback_images": [],
"create_time_interval": "1年前",
"read_count": "245",
"rate_id": "1153379805402",
"comment_count": "0",
"like_count": [],
"user_star": "5",
"user_star_pic": "https://img.alicdn.com/imgextra/i2/O1CN01vy8zTE1Zeo5lC6lTQ_!!6000000003220-2-tps-92-45.png"
},
{
"rate_content": "7号客服服务真好，鞋子质量很好，己第二次购买了 ",
"rate_date": "2021-10-27",
"pics": [
"//img.alicdn.com/imgextra/i1/0/O1CN01hMfUsj1yDexza4Eu1_!!0-rate.jpg",
"//img.alicdn.com/imgextra/i2/0/O1CN01BNKARZ1yDexwiXDKc_!!0-rate.jpg",
"//img.alicdn.com/imgextra/i4/0/O1CN01hDGyZC1yDexjAaZ4I_!!0-rate.jpg",
"//img.alicdn.com/imgextra/i4/0/O1CN01714Xvv1yDexu2mTEB_!!0-rate.jpg"
],
"display_user_nick": "",
"auction_sku": "尺码:39;颜色分类:黑色【内里：超细纤维】",
"add_feedback": "",
"add_feedback_images": [],
"create_time_interval": "1年前",
"read_count": "291",
"rate_id": "1152900593524",
"comment_count": "0",
"like_count": "1",
"user_star": "5",
"user_star_pic": "https://img.alicdn.com/imgextra/i2/O1CN01vy8zTE1Zeo5lC6lTQ_!!6000000003220-2-tps-92-45.png"
},
{
"rate_content": "去年买过一双一样的，今年看了其他家，还是想复制一下上一双鞋子的快乐。鞋底很软，走路不累，超级百搭，爱了爱了。客服都很耐心，7号客服很棒哈哈～ ",
"rate_date": "2021-10-20",
"pics": [
"//img.alicdn.com/imgextra/i1/0/O1CN01N6n5JO24FqYC9k9mc_!!0-rate.jpg"
],
"display_user_nick": "",
"auction_sku": "尺码:39;颜色分类:黑色【内里：超细纤维】",
"add_feedback": "",
"add_feedback_images": [],
"create_time_interval": "1年前",
"read_count": "299",
"rate_id": "1152874831149",
"comment_count": "0",
"like_count": [],
"user_star": "7",
"user_star_pic": "https://img.alicdn.com/imgextra/i4/O1CN01ZlCYMx1nbVriw6u0S_!!6000000005108-2-tps-92-45.png"
},
{
"rate_content": "2号客服棒棒哒",
"rate_date": "2021-09-28",
"pics": [],
"display_user_nick": "",
"auction_sku": "尺码:39;颜色分类:黑色【内里：超细纤维】",
"add_feedback": "",
"add_feedback_images": [],
"create_time_interval": "1年前",
"read_count": "2",
"rate_id": "1148841092349",
"comment_count": "0",
"like_count": [],
"user_star": "8",
"user_star_pic": "https://img.alicdn.com/imgextra/i4/O1CN019QZnaG1U1LtUAPn6e_!!6000000002457-2-tps-92-45.png"
},
{
"rate_content": "此用户没有填写评价。",
"rate_date": "2021-09-15",
"pics": [],
"display_user_nick": "",
"auction_sku": "尺码:37;颜色分类:黑色【内里：超细纤维】",
"add_feedback": "",
"add_feedback_images": [],
"create_time_interval": "1年前",
"read_count": "0",
"rate_id": "1147688357921",
"comment_count": "0",
"like_count": [],
"user_star": "8",
"user_star_pic": "https://img.alicdn.com/imgextra/i4/O1CN019QZnaG1U1LtUAPn6e_!!6000000002457-2-tps-92-45.png"
},
{
"rate_content": "7号客服棒棒哒 ",
"rate_date": "2021-09-13",
"pics": [],
"display_user_nick": "",
"auction_sku": "尺码:37;颜色分类:黑色【内里：超细纤维】",
"add_feedback": "",
"add_feedback_images": [],
"create_time_interval": "1年前",
"read_count": "1",
"rate_id": "1147975534640",
"comment_count": "0",
"like_count": [],
"user_star": "7",
"user_star_pic": "https://img.alicdn.com/imgextra/i4/O1CN01ZlCYMx1nbVriw6u0S_!!6000000005108-2-tps-92-45.png"
},
{
"rate_content": "不错 ",
"rate_date": "2021-09-13",
"pics": [],
"display_user_nick": "",
"auction_sku": "尺码:37;颜色分类:黑色【内里：超细纤维】",
"add_feedback": "",
"add_feedback_images": [],
"create_time_interval": "1年前",
"read_count": "0",
"rate_id": "1147394085601",
"comment_count": "0",
"like_count": [],
"user_star": "8",
"user_star_pic": "https://img.alicdn.com/imgextra/i4/O1CN019QZnaG1U1LtUAPn6e_!!6000000002457-2-tps-92-45.png"
},
{
"rate_content": "4号服务态度好，物流速度快。",
"rate_date": "2021-04-25",
"pics": [],
"display_user_nick": "",
"auction_sku": "尺码:37;颜色分类:黑色【内里：超细纤维】",
"add_feedback": "",
"add_feedback_images": [],
"create_time_interval": "1年前",
"read_count": "0",
"rate_id": "1130396694112",
"comment_count": "0",
"like_count": [],
"user_star": "7",
"user_star_pic": "https://img.alicdn.com/imgextra/i4/O1CN01ZlCYMx1nbVriw6u0S_!!6000000005108-2-tps-92-45.png"
},
{
"rate_content": "之前在实体店买过一双白色的，在网上看到又下单一双黑色，很满意，客服2号和6号服务也不错",
"rate_date": "2021-04-23",
"pics": [
"//img.alicdn.com/imgextra/i4/0/O1CN01lhul4v22e0AX7QO75_!!0-rate.jpg"
],
"display_user_nick": "",
"auction_sku": "尺码:37;颜色分类:黑色【内里：超细纤维】",
"add_feedback": "",
"add_feedback_images": [],
"create_time_interval": "1年前",
"read_count": "206",
"rate_id": "1129704857485",
"comment_count": "1",
"like_count": [],
"user_star": "6",
"user_star_pic": "https://img.alicdn.com/imgextra/i3/O1CN01QZTjHW1F4oegDvuEX_!!6000000000434-2-tps-92-45.png"
},
{
"rate_content": "穿上挺好看的，戈美琪的鞋子穿了很多双了，质量一直很好，款式也好看好评哦！这次活动力度大，很划算！",
"rate_date": "2021-04-19",
"pics": [],
"display_user_nick": "",
"auction_sku": "尺码:37;颜色分类:黑色【内里：超细纤维】",
"add_feedback": "",
"add_feedback_images": [],
"create_time_interval": "1年前",
"read_count": "2",
"rate_id": "1129160497439",
"comment_count": "0",
"like_count": [],
"user_star": "8",
"user_star_pic": "https://img.alicdn.com/imgextra/i4/O1CN019QZnaG1U1LtUAPn6e_!!6000000002457-2-tps-92-45.png"
},
{
"rate_content": "此用户没有填写评价。",
"rate_date": "2021-04-17",
"pics": [],
"display_user_nick": "",
"auction_sku": "尺码:38;颜色分类:黑色【内里：超细纤维】",
"add_feedback": "",
"add_feedback_images": [],
"create_time_interval": "1年前",
"read_count": "0",
"rate_id": "1129752431972",
"comment_count": "0",
"like_count": [],
"user_star": "7",
"user_star_pic": "https://img.alicdn.com/imgextra/i4/O1CN01ZlCYMx1nbVriw6u0S_!!6000000005108-2-tps-92-45.png"
},
{
"rate_content": "此用户没有填写评价。",
"rate_date": "2021-04-16",
"pics": [],
"display_user_nick": "",
"auction_sku": "尺码:37;颜色分类:黑色【内里：超细纤维】",
"add_feedback": "",
"add_feedback_images": [],
"create_time_interval": "1年前",
"read_count": "0",
"rate_id": "1129245610801",
"comment_count": "0",
"like_count": [],
"user_star": "5",
"user_star_pic": "https://img.alicdn.com/imgextra/i2/O1CN01vy8zTE1Zeo5lC6lTQ_!!6000000003220-2-tps-92-45.png"
},
{
"rate_content": "1号客服棒棒哒",
"rate_date": "2021-04-11",
"pics": [],
"display_user_nick": "",
"auction_sku": "尺码:39;颜色分类:黑色【内里：超细纤维】",
"add_feedback": "",
"add_feedback_images": [],
"create_time_interval": "1年前",
"read_count": "0",
"rate_id": "1129030951526",
"comment_count": "0",
"like_count": [],
"user_star": "9",
"user_star_pic": "https://img.alicdn.com/imgextra/i3/O1CN01PIYxrZ22FGrmiDphN_!!6000000007090-2-tps-92-45.png"
},
{
"rate_content": "整体评价：鞋子很舒服，回购的第二双了，喜欢 ",
"rate_date": "2021-04-07",
"pics": [],
"display_user_nick": "",
"auction_sku": "尺码:38;颜色分类:黑色【内里：超细纤维】",
"add_feedback": "",
"add_feedback_images": [],
"create_time_interval": "1年前",
"read_count": "0",
"rate_id": "1127252768470",
"comment_count": "0",
"like_count": [],
"user_star": "8",
"user_star_pic": "https://img.alicdn.com/imgextra/i4/O1CN019QZnaG1U1LtUAPn6e_!!6000000002457-2-tps-92-45.png"
},
{
"rate_content": "面料材质：摸着很舒服， 舒适度：鞋底很柔软。 现在购买简直就是物美价廉 ",
"rate_date": "2021-04-06",
"pics": [],
"display_user_nick": "",
"auction_sku": "尺码:38;颜色分类:黑色【内里：超细纤维】",
"add_feedback": "",
"add_feedback_images": [],
"create_time_interval": "1年前",
"read_count": "2",
"rate_id": "1127553169073",
"comment_count": "0",
"like_count": [],
"user_star": "7",
"user_star_pic": "https://img.alicdn.com/imgextra/i4/O1CN01ZlCYMx1nbVriw6u0S_!!6000000005108-2-tps-92-45.png"
}
],
"data_from": "xdl"
},
"secache": "c8bde0fb0758d449f9b07cca295d4b61",
"secache_time": 1675326491,
"secache_date": "2023-02-02 16:28:11",
"translate_status": "",
"translate_time": 0,
"language": {
"default_lang": "cn",
"current_lang": "cn"
},
"error": "",
"reason": "",
"error_code": "0000",
"cache": 0,
"api_info": "today:137 max:10100 all[233=137+41+55];expires:2030-12-31",
"execution_time": "1.454",
"server_time": "Beijing/2023-02-02 16:28:11",
"client_ip": "106.6.36.88",
"call_args": {
"num_iid": "600530677643",
"page": "1"
},
"api_type": "taobao",
"translate_language": "zh-CN",
"translate_engine": "google_api",
"server_memory": "6.1MB",
"request_id": "gw-1.63db741a53609",
"last_id": "1516112329"
}异常示例
相关资料
错误码解释
状态代码(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 | 未知错误 | 否 |
