/basicOpen/openapi/service/v3/data/mws/reviews{
"operation": {
"method": "POST",
"path": "/basicOpen/openapi/service/v3/data/mws/reviews"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 1,
"text": ""
},
"requestExample": {
"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": ""
},
"responseExample": {
"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
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | sort_field | 排序类型 | string | — | Optional | 排序类型 |
| 2 | sort_type | 排序 | string | — | Optional | 排序 |
| 3 | sids | 店铺id | string | — | Optional | 店铺id,多个用逗号分隔 ,对应查询亚马逊店铺列表接口对应字段【sid】 |
| 4 | mids | 站点id | string | — | Optional | 站点id,多个用逗号分隔 |
| 5 | principal_uids | lisitng负责人 | string | — | Optional | lisitng负责人,多个用逗号分隔 |
| 6 | search_field | 搜索字段 | string | — | Optional | 搜索字段: asin ASIN parent_asin 父ASIN remark 备注 amazon_order_id 订单号 author 买家信息 review_id Review ID buyer_email 买家 last_title 评价标题 |
| 7 | search_value | 搜索值 | string | — | Optional | 搜索值 |
| 8 | date_field | 时间搜索类型 | string | — | Required | 时间搜索类型: review_time 评价时间 create_time 创建时间 last_update_time 更新时间 |
| 9 | start_date | 开始时间 | string | — | Required | 开始时间,格式:Y-m-d |
| 10 | end_date | 结束时间 | string | — | Required | 结束时间,格式:Y-m-d |
| 11 | status | 状态 | string | — | Optional | 状态,多个用逗号分隔: 0 待处理 1 处理中 2 已完成 |
| 12 | star | 星级 | string | — | Optional | 星级,多个用逗号分隔 |
| 13 | review_modified_status | 内容 | string | — | Optional | 内容,多个用逗号分隔: -1 已删除 0 未标识 1 已变更 |
| 14 | mark | 标识 | string | — | Optional | 标识,多个用逗号分隔: is_vp is_er is_topc is_topr is_vine |
| 15 | cs_principal_uids | 处理人 | string | — | Optional | 处理人,多个用逗号分隔 |
| 16 | offset | 分页偏移量 | integer | — | Optional | 分页偏移量,默认0 |
| 17 | length | 分页长度 | integer | — | Optional | 分页长度,默认20,上限200 |
| 18 | cids | 分类id | string | — | Optional | 分类id,多个用逗号分隔 |
| 19 | global_tag_ids | 标签id | string | — | Optional | 标签id,多个用逗号分隔 |
| 20 | match_types | 匹配类型 | string | — | Optional | 匹配类型,多个用逗号分隔,默认传空字符串 |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | number | 0 | Required | 状态码,0 成功 |
| 2 | message | 消息提示 | string | success | Required | 消息提示 |
| 3 | error_details | 错误信息 | array<any> | — | Required | 错误信息 |
| 4 | request_id | 请求链路id | string | a8779aecad254b1ca0d34df46b00972b.1725518992094 | Required | 请求链路id |
| 5 | response_time | 响应时间 | string | 2024-09-05 14:49:52 | Required | 响应时间 |
| 6 | data | 响应数据 | array<object> | — | Required | 响应数据 |
| 6.1 | small_image_url | 图片 | string | 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 | Required | 图片 |
| 6.2 | asin | asin | string | B0ABC60875 | Required | ASIN |
| 6.3 | seller_sku | seller_sku | array<any> | ["MSKU26323CA","MSKU4C1DA7B"] | Required | MSKU |
| 6.4 | last_star | 评级 - 星级 | number | 1 | Required | 评级 - 星级 |
| 6.5 | last_title | 评级 - 标签 | string | Very Pleased | Required | 评级 - 标签 |
| 6.6 | review_likes | 点赞数 | number | 0 | Required | 点赞数 |
| 6.7 | review_id | Review ID | string | 3FA1E258B9D40D | Required | Review ID |
| 6.8 | review_url | 评价链接 | string | https://www.amazon.com/gp/xxxx/xxxx7FLN9VVKY | Required | 评价链接 |
| 6.9 | last_content | 评价内容 | string | Very easy to use. Works quickly. Love that it's lightweight and compact. | Required | 评价内容 |
| 6.10 | parent_asin | 父ASIN | array<any> | ["B0ABC53810"] | Required | 父ASIN |
| 6.11 | item_name | 标题 | array<any> | ["lingxing amazon product title DBEC4F0A76"] | Required | 标题 |
| 6.12 | local_info | 本地信息 | array<object> | — | Required | 本地信息 |
| 6.12.1 | local_sku | 本地SKU | string | 28520211130 | Required | 本地SKU |
| 6.12.2 | local_name | 本地品名 | string | 首页-测试用1 | Required | 本地品名 |
| 6.12.3 | category_name | 分类名 | string | 产品管理-Listing-退货订单-分类 | Required | 分类名 |
| 6.13 | author | 买家信息 | string | 评论者376035 | Required | 买家信息 |
| 6.14 | author_id | 买家 ID | string | amzn1.account.AF3WWN6VJJY5FTAENJDJX63XM5JKQ | Required | 买家 ID |
| 6.15 | images | 评论图片链接 | array<any> | ["https://m.media-amazon.com/images/I/61SF10hpIIL.jpg"] | Required | 评论图片链接 |
| 6.16 | videos | 评论视频链接 | array<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"] | Required | 评论视频链接 |
| 6.17 | is_vp | is_vp | number | 1 | Required | |
| 6.18 | is_er | 是否ER | number | 0 | Required | 是否ER,Early Reviewer Reward;1 是,0 否 |
| 6.19 | is_topc | 是否TOPC | number | 0 | Required | 是否TOPC,Top Contributor;1 是,0 否 |
| 6.20 | is_topr | 是否TOPR | number | 0 | Required | 是否TOPR,Top XX Reviewer;1 是,0 否 |
| 6.21 | is_vine | 是否VINE | number | 0 | Required | 是否VINE,VINE VOICE;1 是,0 否 |
| 6.22 | review_modified_status | 评论评论状态 | number | 0 | Required | 评论评论状态,0 无标识,1 已变更,-1 已删除 |
| 6.23 | seller_name | 店铺 | array<any> | ["店铺2"] | Required | 店铺 |
| 6.24 | marketplace | 国家 | string | 美国 | Required | 国家 |
| 6.25 | review_date | 评价时间 | string | 2021-08-21 | Required | 评价时间 |
| 6.26 | create_time | 创建时间 | string | 2021-08-23 | Required | 创建时间 |
| 6.27 | update_time | 更新时间 | string | 2021-08-23 15:11:10 | Required | 更新时间 |
| 6.28 | crawl_date | 操作时间 | string | 2021-08-23 15:11:10 | Required | 操作时间 |
| 6.29 | amazon_order_list | 订单号列表 | array<object> | — | Required | 订单号列表 |
| 6.29.1 | seller_name | 店铺 | string | 店铺2 | Required | 店铺 |
| 6.29.2 | amazon_order_id | 订单号 | string | 394-8475169-8475563 | Required | 订单号 |
| 6.29.3 | buyer_email | 买家邮箱 | string | — | Required | 买家邮箱 |
| 6.30 | buyer_email | 买家邮箱 | array<any> | — | Required | 买家邮箱 |
| 6.31 | remark | 备注 | string | — | Required | 备注 |
| 6.32 | status | 处理状态 | number | 0 | Required | 处理状态:0 待处理,1 处理中,2 已完成 |
| 6.33 | tags | 标签 | array<any> | — | Required | 标签 |
| 6.34 | cs_principals | 处理人 | array<object> | — | Required | 处理人 |
| 6.34.1 | uid | 处理人 UID | number | 10329601 | Required | 处理人 UID |
| 6.34.2 | name | 处理人姓名 | string | 张三 | Required | 处理人姓名 |
| 7 | total | 总数 | number | 1 | Required | 总数 |
The 查询评论管理 - Review(新) API (/basicOpen/openapi/service/v3/data/mws/reviews) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.
Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.