Lingxing
切换旧版

查询评价管理 - Review

POST/erp/sc/v2/data/mws/reviews

接口信息

API Path请求协议请求方式令牌桶容量
/erp/sc/v2/data/mws/reviewsHTTPSPOST1

请求参数

sidinteger必填
店铺id ,对应查询亚马逊店铺列表接口对应字段【sid】
start_datestring必填
开始评论时间,闭区间,格式:Y-m-d
end_datestring必填
结束评论时间,闭区间,格式:Y-m-d
offsetinteger必填
分页偏移量,默认0
lengthinteger必填
分页长度
date_fieldstring
时间类型:
review_date 评价时间【默认值】
create_time 创建时间

请求示例

{
    "offset": 0,
    "length": 20,
    "sid": 1,
    "start_date": "2024-08-05",
    "end_date": "2024-08-05",
    "date_field": "review_date"
}

返回结果

Json Object

codeinteger必填
状态码,0 成功
示例 0
messagestring必填
响应信息
示例 success
error_detailsarray<any>必填
错误信息
request_idstring必填
请求链路id
示例 73A0718B-AA68-E120-D28B-F7175018175D
response_timestring必填
响应时间
示例 2022-04-19 15:16:18
dataarray<object>必填
响应数据
隐藏子属性
asinstring必填
ASIN
示例 B0ABC6760875
last_starinteger必填
星级
示例 5
last_titlestring必填
评论标题
示例 Very Pleased
last_contentstring必填
评价内容
示例 Very easy to use. Works quickly. Love that it's lightweight and compact.
review_likesinteger必填
点赞数
示例 1000
authorstring必填
评论客户
示例 评论者363934
author_idstring必填
评论客户id
review_datestring必填
评论时间
示例 2021-04-09
review_idstring必填
Review ID
示例 0002118826800D
statusinteger必填
处理状态:0 待处理,1 处理中,2 已完成
示例 2
update_timeinteger必填
更新时间,时间戳
示例 1624856476
create_timeinteger必填
创建时间,时间戳
示例 1618164429
review_modified_statusinteger必填
评论状态:-1 已删除,0 无标识,1 已变更
示例 1
remarkstring必填
备注
amazon_order_listarray<any>必填
匹配订单列表
marketplacestring必填
国家
示例 美国
is_vpinteger必填
是否是VP:0 否,1 是
is_erinteger必填
是否是ER:0 否,1 是
示例 0
is_topcinteger必填
是否是TOPC:0 否,1 是
示例 0
is_toprinteger必填
是否是TOPR:0 否,1 是
示例 0
is_vineinteger必填
是否是VINE:0 否,1 是
示例 0
asin_urlstring必填
ASIN 链接
示例 https://www.amazon.com/dp/B0AB76C60875
review_urlstring必填
评价链接
示例 https://www.amazon.com/xx/ref=cmttl?ie=UTF8&ASIN=B0ABC7605
seller_namearray<any>必填
店铺名
示例 ["店铺2","店铺5"]
sidsarray<any>必填
店铺ID
示例 ["2","5"]
attachmentsarray<object>必填
附件
隐藏子属性
typestring必填
附件类型:image 图片,video 视频
示例 image
urlstring必填
链接地址
示例 https://images-na.ssl-images-amazon.com/images/xxx.jpg
totalinteger必填
总数
示例 6556

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "42293103-574D-CF2A-1767-822AE1942984",
    "response_time": "2022-04-19 15:29:47",
    "data": [
        {
            "asin": "ASIN",
            "last_star": "星级",
            "last_title": "评价标题",
            "last_content": "评价内容",
            "review_likes": "点赞数",
            "author": "评价客户",
            "author_id": "评价客户ID",
            "review_date": "评论时间",
            "review_id": "Review ID",
            "status": "处理状态",
            "update_time": "更新时间",
            "create_time": "创建时间",
            "review_modified_status": "评价状态",
            "remark": "备注",
            "amazon_order_list": ["订单号列表","订单号列表"],
            "marketplace": "国家",
            "is_vp": "是否VP",
            "is_er": "是否ER",
            "is_topc": "是否TOPC",
            "is_topr": "是否TOPR",
            "is_vine": "是否VINE",
            "asin_url": "ASIN 链接",
            "review_url": "评价链接",
            "seller_name": ["店铺","店铺"],
            "sids": ["店铺id","店铺id"],
            "attachments": [
                {
                    "type": "image",
                    "url": "https://images-na.ssl-images-amazon.com/images/I/71w0PBmui+L._SY88.jpg"
                },
                {
                    "type": "video",
                    "url": "https://images-na.ssl-images-amazon.com/images/I/C1OFT0iGsoS.mp4"
                },
            ]
        }
    ],
    "total": "1"
}