在电商领域，用户评论对于产品的推广和销售具有极其重要的影响。速卖通（AliExpress）作为全球知名的跨境电商平台，提供了丰富的API接口供开发者使用，其中aliexpress.item_review API允许开发者获取商品的评论信息。本文将详细解析这个API的返回值，帮助开发者更好地理解和利用这些数据。
一、API概述
aliexpress.item_review API是速卖通开放平台提供的一个接口，用于获取指定商品的评论数据。通过调用这个API，开发者可以获取包括评论内容、评分、评论者信息、评论时间等在内的详细信息，从而帮助商家分析产品反馈，提升服务质量和商品竞争力。
aliexpress.item_review
公共参数
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| 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版本 |
请求参数
请求参数：url=https://ja.aliexpress.com/item/1005005958833204.html?gatewayAdapt=glo2jpn4itemAdapt&country=JP¤cy=USD&lang=ja_JP&sort=complex_default&num_iid=1005005958833204&page=1
参数说明：num_iid:aliexpress商品ID
country:地区(地区和域名必须对应)
currency:货币
page:页码
lang:语言
url:域名
响应参数
Version: Date:2024-05-07
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| item | Mix | 1 | 获得商品评论信息 |
返回数据示例
"items": {"page": "1","real_total_results": 2000,"total_results": 2000,"page_size": 10,"pagecount": 200,"_ddf": "alex","item": [{"currentPage": 1,"evaViewList": [{"aigc": false,"anonymous": false,"buyerAddFbDays": 0,"buyerCountry": "BR","buyerEval": 100,"buyerFbType": {"crowdSourcingPersonName": "AliExpress Shopper","sourceLang": "zh-CN","typeTranslationAccepted": "crowdsourcing"},"buyerFeedback": "material mt bom , porém pequeno , comprem 1 numero a +","buyerName": "n***r","buyerProductFeedBack": "","buyerTranslationFeedback": "Mt material, good but small, buy 1 number a +","downVoteCount": 0,"evalDate": "13 Apr 2024","evaluationId": 60081139963794270,"evaluationIdStr": "60081139963794276","images": ["https://ae01.alicdn.com/kf/Adf721751a21f42ff9904e9afd7621c23d.jpg","https://ae01.alicdn.com/kf/Aefcd5445fadd4d28ad798f7507cd83f5L.jpg"],"logistics": "Aliexpress Selection Standard","selectedIcon": "https://ae01.alicdn.com/kf/S2df5f3fa0d8242b1a0bbb1cc92cab109P/221x221.png","selectedReview": true,"skuInfo": "Color:WHITE Shoe Size:42-43 ","status": "1","thumbnails": ["https://ae01.alicdn.com/kf/Adf721751a21f42ff9904e9afd7621c23d.jpg_220x220.jpg","https://ae01.alicdn.com/kf/Aefcd5445fadd4d28ad798f7507cd83f5L.jpg_220x220.jpg"],"trendyol": false,"upVoteCount": 0},{"aigc": false,"anonymous": false,"buyerAddFbDays": 0,"buyerCountry": "BR","buyerEval": 100,"buyerFbType": {"crowdSourcingPersonName": "AliExpress Shopper","sourceLang": "zh-CN","typeTranslationAccepted": "crowdsourcing"},"buyerFeedback": "muito bem informado sobre o andamento do produto desde a compra até a entrega. o produto chegou muito bem embalada e veio conforme anunciado.","buyerName": "d***d","buyerProductFeedBack": "","buyerTranslationFeedback": "Very well informed about the progress of the product from purchase to delivery. The product arrived very well packed and came as advertised.","downVoteCount": 0,"evalDate": "17 Apr 2024","evaluationId": 60080937301364664,"evaluationIdStr": "60080937301364664","images": ["https://ae01.alicdn.com/kf/A16759320a0be4c50acd71f3afea518491.jpg","https://ae01.alicdn.com/kf/A17194ecde56b414085fef9f7d88032c7p.jpg","https://ae01.alicdn.com/kf/Ade3235df6a4943888eff77083836f8bbN.jpg"],"logistics": "Aliexpress Selection Standard","selectedIcon": "https://ae01.alicdn.com/kf/S2df5f3fa0d8242b1a0bbb1cc92cab109P/221x221.png","selectedReview": true,"skuInfo": "Color:WHITE Shoe Size:40-41 ","status": "1","thumbnails": ["https://ae01.alicdn.com/kf/A16759320a0be4c50acd71f3afea518491.jpg_220x220.jpg","https://ae01.alicdn.com/kf/A17194ecde56b414085fef9f7d88032c7p.jpg_220x220.jpg","https://ae01.alicdn.com/kf/Ade3235df6a4943888eff77083836f8bbN.jpg_220x220.jpg"],"trendyol": false,"upVoteCount": 0},{"aigc": false,"anonymous": false,"buyerAddFbDays": 0,"buyerCountry": "UA","buyerEval": 100,"buyerFbType": {"crowdSourcingPersonName": "AliExpress Shopper","sourceLang": "zh-CN","typeTranslationAccepted": "crowdsourcing"},"buyerFeedback": "очень классно, как на картинке, размер соответствует, пришла посылка очень быстро на Украину, продавца рекомендую","buyerGender": "F","buyerHeadPortrait": "https://ae01.alicdn.com/kf/A9a8a42a591ac46169949eb607fc3771bt.jpg_220x220.jpg","buyerName": "S***y","buyerProductFeedBack": "","buyerTranslationFeedback": "Very cool, as in the picture, the size is the same, the parcel arrived very quickly in Ukraine, I recommend the seller","downVoteCount": 0,"evalDate": "30 Apr 2024","evaluationId": 30071909855907284,"evaluationIdStr": "30071909855907283","images": ["https://ae01.alicdn.com/kf/A5830c9fe4dfb4dcabc4e1985f8cfd130H.jpg"],"logistics": "Aliexpress Selection Standard","selectedIcon": "https://ae01.alicdn.com/kf/S2df5f3fa0d8242b1a0bbb1cc92cab109P/221x221.png","selectedReview": true,"skuInfo": "Color:Black Shoe Size:42-43 ","status": "1","thumbnails": ["https://ae01.alicdn.com/kf/A5830c9fe4dfb4dcabc4e1985f8cfd130H.jpg_220x220.jpg"],"trendyol": false,"upVoteCount": 0},{"aigc": false,"anonymous": false,"buyerAddFbDays": 0,"buyerCountry": "BR","buyerEval": 100,"buyerFbType": {"crowdSourcingPersonName": "AliExpress Shopper","sourceLang": "zh-CN","typeTranslationAccepted": "crowdsourcing"},"buyerFeedback": "muito top, e muito gostoso de calçar, bem confortavel... era pra chegar 11/12 chegou 08/12","buyerHeadPortrait": "https://ae01.alicdn.com/kf/Af527bde36ddb452586c488cc7c6aba6az.jpg_220x220.jpg","buyerName": "B***f","buyerProductFeedBack": "","buyerTranslationFeedback": "Very top, and very nice to put on, very comfortable... Was to get 11/12 came 08/12","downVoteCount": 0,"evalDate": "09 Dec 2023","evaluationId": 60076923816535944,"evaluationIdStr": "60076923816535946","images": ["https://ae01.alicdn.com/kf/A7363cd70b0da4aa69405fdb6e3ac3a7eg.jpg","https://ae01.alicdn.com/kf/A5b304817b93b414cbc56f043686e73cby.jpg","https://ae01.alicdn.com/kf/A81709a306b75495e95d7d83095c1a40aD.jpg","https://ae01.alicdn.com/kf/Ae893bccd17c04496adac492f83673ee44.jpg"],"logistics": "AliExpress Standard Shipping","selectedIcon": "https://ae01.alicdn.com/kf/S2df5f3fa0d8242b1a0bbb1cc92cab109P/221x221.png","selectedReview": true,"skuInfo": "Color:Black Shoe Size:38-39 ","status": "1","thumbnails": ["https://ae01.alicdn.com/kf/A7363cd70b0da4aa69405fdb6e3ac3a7eg.jpg_220x220.jpg","https://ae01.alicdn.com/kf/A5b304817b93b414cbc56f043686e73cby.jpg_220x220.jpg","https://ae01.alicdn.com/kf/A81709a306b75495e95d7d83095c1a40aD.jpg_220x220.jpg","https://ae01.alicdn.com/kf/Ae893bccd17c04496adac492f83673ee44.jpg_220x220.jpg"],"trendyol": false,"upVoteCount": 0},{"aigc": false,"anonymous": false,"buyerAddFbDays": 0,"buyerCountry": "UA","buyerEval": 100,"buyerFbType": {"crowdSourcingPersonName": "AliExpress Shopper","sourceLang": "zh-CN","typeTranslationAccepted": "crowdsourcing"},"buyerFeedback": "пришли быстро. запакован отлично. качество хорошее. мягкий материал. цвет как на картинке. буду брать ещё.","buyerGender": "M","buyerHeadPortrait": "https://ae01.alicdn.com/kf/UT8gC3dXw0XXXagOFbXC.jpg_220x220.jpg","buyerName": "S***v","buyerProductFeedBack": "","buyerTranslationFeedbac错误码解释
| 状态代码(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 | 未知错误 | 否 |
二、返回值详解
当成功调用aliexpress.item_review API后，通常会返回一个JSON格式的数据包，其中包含以下关键字段：
- status
- 类型：字符串
- 描述：请求状态码，表示请求是否成功。常见的状态码有“success”（成功）和“fail”（失败）。
- message
- 类型：字符串
- 描述：如果请求成功，则返回相应的提示信息；如果请求失败，则返回具体的错误原因。
- item_id
- 类型：字符串
- 描述：请求的商品ID，用于标识具体的商品。
- reviews
-
类型：数组
-
描述：包含商品评论信息的列表，每个评论都是一个JSON对象。以下是一个评论对象的详细字段：
a. review_id
- 类型：字符串
- 描述：评论的唯一标识符，用于区分不同的评论。
b. content
- 类型：字符串
- 描述：评论的具体内容，即买家对商品的评价和看法。
c. rating
- 类型：整数
- 描述：买家对商品的评分，通常是一个介于1到5之间的整数，其中5代表非常满意。
d. reviewer_name
- 类型：字符串
- 描述：评论者的昵称或用户名，用于标识评论的发布者。
e. reviewer_avatar
- 类型：字符串
- 描述：评论者的头像链接，通常是一个URL地址。
f. review_time
- 类型：字符串
- 描述：评论的发布时间，通常是一个遵循ISO 8601标准的日期时间字符串。
g. verified_purchase
- 类型：布尔值（true/false）
- 描述：表示该评论是否来自真实购买的买家。真实购买的评论通常更有参考价值。
h. helpful_count
- 类型：整数
- 描述：表示该评论被认为有帮助的次数，通常由其他买家投票产生。
i. images
- 类型：数组
- 描述：包含评论者上传的图片链接的列表。这些图片可能是对商品的实际拍摄或使用效果展示。
j. responses
- 类型：数组
- 描述：包含卖家对评论的回复信息的列表。每个回复也是一个JSON对象，包含回复内容、回复时间等字段。
-
三、应用场景
-
产品优化：通过分析用户评论，商家可以了解产品的优点和不足，从而进行针对性的优化和改进。
-
营销推广：精选优质评论作为营销素材，可以吸引更多潜在买家关注和购买商品。
-
客户服务：及时回应用户评论，解决用户问题，提升客户满意度和忠诚度。
