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