速卖通商品评论API(aliexpress.item_review)返回值全解析

在电商领域,用户评论对于产品的推广和销售具有极其重要的影响。速卖通(AliExpress)作为全球知名的跨境电商平台,提供了丰富的API接口供开发者使用,其中aliexpress.item_review API允许开发者获取商品的评论信息。本文将详细解析这个API的返回值,帮助开发者更好地理解和利用这些数据。

一、API概述

aliexpress.item_review API是速卖通开放平台提供的一个接口,用于获取指定商品的评论数据。通过调用这个API,开发者可以获取包括评论内容、评分、评论者信息、评论时间等在内的详细信息,从而帮助商家分析产品反馈,提升服务质量和商品竞争力。

aliexpress.item_review

公共参数

名称类型必须描述
keyString调用key(必须以GET方式拼接在URL中)
secretString调用密钥
api_nameStringAPI接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等]
cacheString[yes,no]默认yes,将调用缓存的数据,速度比较快
result_typeString[json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读
langString[cn,en,ru]翻译语言,默认cn简体中文
versionStringAPI版本

请求参数

请求参数: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

Mix1获得商品评论信息

 返回数据示例

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

 

二、返回值详解

当成功调用aliexpress.item_review API后,通常会返回一个JSON格式的数据包,其中包含以下关键字段:

  1. status
    • 类型:字符串
    • 描述:请求状态码,表示请求是否成功。常见的状态码有“success”(成功)和“fail”(失败)。
  2. message
    • 类型:字符串
    • 描述:如果请求成功,则返回相应的提示信息;如果请求失败,则返回具体的错误原因。
  3. item_id
    • 类型:字符串
    • 描述:请求的商品ID,用于标识具体的商品。
  4. 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对象,包含回复内容、回复时间等字段。

三、应用场景

  1. 产品优化:通过分析用户评论,商家可以了解产品的优点和不足,从而进行针对性的优化和改进。

  2. 营销推广:精选优质评论作为营销素材,可以吸引更多潜在买家关注和购买商品。

  3. 客户服务:及时回应用户评论,解决用户问题,提升客户满意度和忠诚度。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值