在电商领域,用户评论对于产品的推广和销售具有极其重要的影响。速卖通(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对象,包含回复内容、回复时间等字段。
-
三、应用场景
-
产品优化:通过分析用户评论,商家可以了解产品的优点和不足,从而进行针对性的优化和改进。
-
营销推广:精选优质评论作为营销素材,可以吸引更多潜在买家关注和购买商品。
-
客户服务:及时回应用户评论,解决用户问题,提升客户满意度和忠诚度。