Lingxing
切换旧版

查询评论管理 - Review(新)

POST/basicOpen/openapi/service/v3/data/mws/reviews

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/openapi/service/v3/data/mws/reviewsHTTPSPOST1

请求参数

sort_fieldstring
排序类型
sort_typestring
排序
sidsstring
店铺id,多个用逗号分隔 ,对应查询亚马逊店铺列表接口对应字段【sid】
midsstring
站点id,多个用逗号分隔
principal_uidsstring
lisitng负责人,多个用逗号分隔
search_fieldstring
搜索字段:
asin ASIN
parent_asin 父ASIN
remark 备注
amazon_order_id 订单号
author 买家信息
review_id Review ID
buyer_email 买家
last_title 评价标题
search_valuestring
搜索值
date_fieldstring必填
时间搜索类型:
review_time 评价时间
create_time 创建时间
last_update_time 更新时间
start_datestring必填
开始时间,格式:Y-m-d
end_datestring必填
结束时间,格式:Y-m-d
statusstring
状态,多个用逗号分隔:
0 待处理
1 处理中
2 已完成
starstring
星级,多个用逗号分隔
review_modified_statusstring
内容,多个用逗号分隔:
-1 已删除
0 未标识
1 已变更
markstring
标识,多个用逗号分隔:
is_vp
is_er
is_topc
is_topr
is_vine
cs_principal_uidsstring
处理人,多个用逗号分隔
offsetinteger
分页偏移量,默认0
lengthinteger
分页长度,默认20,上限200
cidsstring
分类id,多个用逗号分隔
global_tag_idsstring
标签id,多个用逗号分隔
match_typesstring
匹配类型,多个用逗号分隔,默认传空字符串

请求示例

{
  "sort_field": "review_date",
  "sort_type": "desc",
  "search_field": "review_id",
  "search_value": "R1KKLEHWNZWH05",
  "start_date": "2021-06-01",
  "end_date": "2024-09-06",
  "date_field": "review_time",
  "offset": 0,
  "length": 20,
  "cids": "",
  "global_tag_ids": "",
  "match_types": ""
}

返回结果

Json Object

codenumber必填
状态码,0 成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
错误信息
request_idstring必填
请求链路id
示例 a8779aecad254b1ca0d34df46b00972b.1725518992094
response_timestring必填
响应时间
示例 2024-09-05 14:49:52
dataarray<object>必填
响应数据
隐藏子属性
small_image_urlstring必填
图片
示例 https://image-1254213275.cos.ap-guangzhou.myqcloud.com/dev/20210914/USB%E5%A3%81%E5%BC%8F%E5%85%85%E7%94%B5%E5%99%A8.jpg
asinstring必填
ASIN
示例 B0ABC60875
seller_skuarray<any>必填
MSKU
示例 ["MSKU26323CA","MSKU4C1DA7B"]
last_starnumber必填
评级 - 星级
示例 1
last_titlestring必填
评级 - 标签
示例 Very Pleased
review_likesnumber必填
点赞数
示例 0
review_idstring必填
Review ID
示例 3FA1E258B9D40D
review_urlstring必填
评价链接
示例 https://www.amazon.com/gp/xxxx/xxxx7FLN9VVKY
last_contentstring必填
评价内容
示例 Very easy to use. Works quickly. Love that it's lightweight and compact.
parent_asinarray<any>必填
父ASIN
示例 ["B0ABC53810"]
item_namearray<any>必填
标题
示例 ["lingxing amazon product title DBEC4F0A76"]
local_infoarray<object>必填
本地信息
隐藏子属性
local_skustring必填
本地SKU
示例 28520211130
local_namestring必填
本地品名
示例 首页-测试用1
category_namestring必填
分类名
示例 产品管理-Listing-退货订单-分类
authorstring必填
买家信息
示例 评论者376035
author_idstring必填
买家 ID
示例 amzn1.account.AF3WWN6VJJY5FTAENJDJX63XM5JKQ
imagesarray<any>必填
评论图片链接
示例 ["https://m.media-amazon.com/images/I/61SF10hpIIL.jpg"]
videosarray<any>必填
评论视频链接
示例 ["https://m.media-amazon.com/images/S/vse-vms-transcodiing-artifact-eu-west-1-prod/e86fbba7-b53e-42f1-ba1f-599df347a600/default.vertical.jobtemplate.mp4.480"]
is_vpnumber必填
示例 1
is_ernumber必填
是否ER,Early Reviewer Reward;1 是,0 否
示例 0
is_topcnumber必填
是否TOPC,Top Contributor;1 是,0 否
示例 0
is_toprnumber必填
是否TOPR,Top XX Reviewer;1 是,0 否
示例 0
is_vinenumber必填
是否VINE,VINE VOICE;1 是,0 否
示例 0
review_modified_statusnumber必填
评论评论状态,0 无标识,1 已变更,-1 已删除
示例 0
seller_namearray<any>必填
店铺
示例 ["店铺2"]
marketplacestring必填
国家
示例 美国
review_datestring必填
评价时间
示例 2021-08-21
create_timestring必填
创建时间
示例 2021-08-23
update_timestring必填
更新时间
示例 2021-08-23 15:11:10
crawl_datestring必填
操作时间
示例 2021-08-23 15:11:10
amazon_order_listarray<object>必填
订单号列表
隐藏子属性
seller_namestring必填
店铺
示例 店铺2
amazon_order_idstring必填
订单号
示例 394-8475169-8475563
buyer_emailstring必填
买家邮箱
buyer_emailarray<any>必填
买家邮箱
remarkstring必填
备注
statusnumber必填
处理状态:0 待处理,1 处理中,2 已完成
示例 0
tagsarray<any>必填
标签
cs_principalsarray<object>必填
处理人
隐藏子属性
uidnumber必填
处理人 UID
示例 10329601
namestring必填
处理人姓名
示例 张三
totalnumber必填
总数
示例 1

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a016098c47674ff99ca7ac177e54111c.1725616690741",
    "response_time": "2024-09-06 17:58:10",
    "data": [
        {
            "small_image_url": "https://m.media-amazon.com/images/I/81h9TDdkM-L._SL75_.jpg",
            "asin": "B07XKHF683",
            "seller_sku": [
                "YE-2XPZ-XKY1-A"
            ],
            "last_star": 5,
            "last_title": "Kinda unique for me",
            "review_likes": 0,
            "review_id": "R1KKLEHWNZWH05",
            "review_url": "https://www.amazon.com/gp/xxxx/xxxx7FLN9VVKY",
            "last_content": "  I love it,  so perfect for my room.",
            "parent_asin": [
                "B08CCRG337"
            ],
            "item_name": [
                "HEETA 2 Stück Duschablage Ohne Bohren, Rostfreies Badezimmer Regal mit Selbstklebender Wandmontage, Starke Duschregal ohne Bohren Küchenregale, Edelstahl-Organizer und Aufbewahrung (13 Inches)"
            ],
            "local_info": [
                {
                    "local_sku": "2323235",
                    "local_name": "sadgacv",
                    "category_name": "3C类"
                }
            ],
            "author": "Mae",
            "is_vp": 0,
            "seller_name": [
                "JHL-DE-2"
            ],
            "marketplace": "德国",
            "review_date": "2023-08-05",
            "create_time": "2021-11-27",
            "update_time": "2021-12-31 21:16:37",
            "crawl_date": "2021-12-31 21:16:37",
            "amazon_order_list": [],
            "buyer_email": [],
            "remark": "",
            "status": 0,
            "tags": [],
            "cs_principals": []
        }
    ],
    "total": 1
}