Lingxing
切换旧版

查询评价统计 - Review列表

GET/erp/sc/v2/cs/reviewReport/lists

接口信息

API Path请求协议请求方式令牌桶容量
/erp/sc/v2/cs/reviewReport/listsHTTPSGET1

请求参数

参数作为query参数拼接在url上,签名时参数用json格式参与生成签名

start_datestring必填
开始时间【时间间隔不超过1年】,格式:Y-m-d
示例 2020-01-01
end_datestring必填
结束时间【时间间隔不超过1年】,格式:Y-m-d
示例 2024-08-05
sidarray<any>
店铺id ,对应查询亚马逊店铺列表接口对应字段【sid】
示例 [1,136,139]
offsetinteger
分页偏移量,默认0
示例 0
lengthinteger
分页长度,默认20
示例 20

请求示例

curl --location --request GET 'https://openapi.lingxing.com/erp/sc/v2/cs/reviewReport/lists?app_key=&access_token=&timestamp=&sign=&start_date=2024-09-01&end_date=2025-05-01&offset=0&length=20'

返回结果

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
totalinteger必填
总数
示例 701
dataarray<object>必填
响应数据
隐藏子属性
ratingsnumber必填
子rating总数
示例 3112
five_starnumber必填
5星review新增数
示例 5
four_starnumber必填
4星review新增数
three_starnumber必填
3星review新增数
示例 1
two_starnumber必填
2星review新增数
示例 1
one_starnumber必填
1星review新增数
示例 2
review_numnumber必填
review数
示例 9
good_numnumber必填
review好评数
示例 5
negative_numnumber必填
review中差评数
示例 4
good_ratenumber必填
review好评率
示例 0.5556
negative_ratenumber必填
review中差评率
示例 0.4444
modified_numnumber必填
review改评数
remove_numnumber必填
review删评数
asinstring必填
子asin
示例 B0ABC7613019
asin_urlstring必填
asin链接
示例 https://www.amazon.com/dp/B0ABC7613019
image_urlstring必填
图片链接
titlestring必填
商品标题
示例 标题38746
countrystring必填
国家
示例 美国
scorenumber必填
评分
示例 4.6
marknumber必填
仅评分数
seller_namearray<any>必填
店铺名称
示例 ["account5","account2"]
local_infoarray<object>必填
隐藏子属性
local_skustring必填
sku
示例 SKU27CB788
local_namestring必填
品名
示例 [演示数据]Android充电线
parent_asinarray<any>必填
父asin
示例 ["B0ABC3499"]
seller_listarray<object>必填
店铺列表
隐藏子属性
sidinteger必填
sid
示例 2
seller_namestring必填
店铺名称
示例 店铺2

成功请求示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "D31C7F9E-675B-EFBD-4E64-FD5D909948C1",
    "response_time": "2022-09-28 11:03:26",
    "total": 1
    "data": [
        {
            "ratings": 64,
            "five_star": 1,
            "four_star": 0,
            "three_star": 0,
            "two_star": 0,
            "one_star": 0,
            "review_num": 1,
            "good_num": 1,
            "negative_num": 0,
            "good_rate": 1,
            "negative_rate": 0,
            "modified_num": 0,
            "remove_num": 0,
            "asin": "B0ABC50851",
            "asin_url": "https://www.amazon.com/dp/B0ABC50851",
            "image_url": "https://image-1254213275.cos.ap-guangzhou.myqcloud.com/dev/20210914/Sony%20ZX%E7%B3%BB%E5%88%97%E6%9C%89%E7%BA%BF%E5%A4%B4%E6%88%B4%E5%BC%8F%E8%80%B3%E6%9C%BA%20%E9%BB%91%E8%89%B2%20MDR-ZX110.jpg",
            "title": "标题38657",
            "country": "美国",
            "score": 4.6,
            "mark": 0,
            "seller_name": [
                "店铺2"
            ],
            "seller_list": [
                {
                    "sid": 2,
                    "seller_name": "店铺2"
                }
            ],
            "local_info": [
                {
                    "local_sku": "SKU09707D9",
                    "local_name": "[演示数据]Sony ZX系列有线头戴式耳机 黑色 MDR-ZX110"
                }
            ],
            "parent_asin": [
                "B0ABC86025"
            ]
        }
    ]
}

失败请求示例

{
    "code": 102,
    "message": "参数不合法",
    "error_details": [
        "start_date => start_date不能为空"
    ],
    "request_id": "8671A9D1-BC61-9398-FBD9-C90A672DAD11",
    "response_time": "2022-03-31 15:55:03",
    "data": [],
    "total": 0
}