/erp/sc/data/mws/listing{
"operation": {
"method": "POST",
"path": "/erp/sc/data/mws/listing"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 1,
"text": ""
},
"requestExample": {
"sid": "1,16",
"is_pair": 1,
"is_delete": 0,
"pair_update_start_time": "2022-01-01 12:01:21",
"pair_update_end_time": "2022-10-01 12:01:21",
"listing_update_start_time": "2021-09-01 01:22:00",
"listing_update_end_time": "2022-10-01 11:22:00",
"search_field": "asin",
"search_value": [
"asin1",
"asin2"
],
"exact_search": 1,
"store_type": 1,
"offset": 0,
"length": 15
},
"responseExample": "{\n \"code\": 0,\n \"message\": \"success\",\n \"error_details\": [],\n \"request_id\": \"83AAED7E-A5CF-6A09-6446-36F51AA3EEBA\",\n \"response_time\": \"2023-10-30 15:38:54\",\n \"total\": 10,\n \"data\": [\n {\n \"listing_id\": \"0623ZI1F5EF11\",\n \"seller_sku\": \"msku-1\",\n \"fnsku\": \"B085NPWXXX\",\n \"item_name\": \"xxxx \",\n \"local_sku\": \"n2\",\n \"local_name\": \"组合2\",\n \"price\": \"11.10\",\n \"list_price\": \"2.22\",\n \"remark\": \"这是Listing备注\",\n \"quantity\": 11,\n \"asin\": \"B0B4WP82XX\",\n \"parent_asin\": \"B0B4WP82XX\",\n \"small_image_url\": \"https://XXX/XXX.jpg\",\n \"status\": 1,\n \"is_delete\": 0,\n \"afn_fulfillable_quantity\": 0,\n \"reserved_fc_transfers\": 0,\n \"reserved_fc_processing\": 0,\n \"reserved_customerorders\": 0,\n \"afn_inbound_shipped_quantity\": 0,\n \"afn_unsellable_quantity\": 0,\n \"afn_inbound_working_quantity\": 0,\n \"afn_inbound_receiving_quantity\": 0,\n \"currency_code\": \"USD\",\n \"landed_price\": \"11.10\",\n \"listing_price\": \"11.10\",\n \"open_date\": \"2022-06-23 03:55:12 PDT\",\n \"listing_update_date\": \"2023-06-28 17:44:14\",\n \"seller_rank\": 1112193,\n \"seller_brand\": \"str\",\n \"seller_category\": \"[\\\"Beauty & Personal Care\\\"]\",\n \"review_num\": 0,\n \"last_star\": \"0.0\",\n \"fulfillment_channel_type\": \"FBM\",\n \"open_date_display\": \"2022-06-23 03:55:12 -07:00\",\n \"principal_info\": [],\n \"shipping\": \"0.00\",\n \"points\": \"0\",\n \"sid\": 101,\n \"store_type\": 1,\n \"total_volume\": 100,\n \"yesterday_volume\": 100,\n \"fourteen_volume\": 100,\n \"thirty_volume\": 100,\n \"yesterday_amount\": \"110.00\",\n \"seven_amount\": \"200.00\",\n \"thirty_amount\": \"300.00\",\n \"average_seven_volume\": 100,\n \"average_fourteen_volume\": 100,\n \"average_thirty_volume\": 100\n \"dimension_info\": [\n {\n \"item_height\": \"0.00\",\n \"item_height_units_type\": \"\",\n \"item_length\": \"0.00\",\n \"item_length_units_type\": \"\",\n \"item_width\": \"0.00\",\n \"item_width_units_type\": \"\",\n \"item_weight\": \"0.00\",\n \"item_weight_units_type\": \"\",\n \"package_height\": \"0.00\",\n \"package_height_units_type\": \"\",\n \"package_length\": \"0.00\",\n \"package_length_units_type\": \"\",\n \"package_width\": \"0.00\",\n \"package_width_units_type\": \"\",\n \"package_weight\": \"0.00\",\n \"package_weight_units_type\": \"\"\n }\n ],\n \"pair_update_time\": \"2023-10-30 15:25:51\",\n \"small_rank\": [\n {\n \"category\": \"Hair Elastics & Ties\",\n \"rank\": 13758\n }\n ],\n \"on_sale_time\": \"2023-10-04\",\n \"global_tags\":[\n {\n \"globalTagId\": \"907204347399528686\",\n \"tagName\": \"TEST-005\",\n \"color\": \"#3BB84C\"\n }\n ],\n \"variant\": [\n {\n \"attr_name\": \"color\",\n \"attr_value\": \"Sliver\"\n }\n ],\n \"first_order_time\": \"\",\n \"marketplace\": \"美国\",\n \"seller_category_new\": [\n \"Beauty & Personal Care\"\n ] \n }\n ]\n}"
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | sid | 店铺id | string | — | Required | 店铺id,多个使用英文逗号分隔 ,对应查询亚马逊店铺列表接口对应字段【sid】 |
| 2 | is_pair | 是否配对 | integer | — | Optional | 是否配对:1 已配对,2 未配对 |
| 3 | is_delete | 是否删除 | integer | — | Optional | 是否删除:0 未删除,1 已删除 |
| 4 | pair_update_start_time | 【配对更新时间】的开始时间(此为北京时间 | string | — | Optional | 【配对更新时间】的开始时间(此为北京时间,格式:Y-m-d H:i:s),用此时间查询要求 is_pair=1 |
| 5 | pair_update_end_time | 【配对更新时间】的结束时间(此为北京时间 | string | — | Optional | 【配对更新时间】的结束时间(此为北京时间,格式:Y-m-d H:i:s),用此时间查询要求 is_pair=1 |
| 6 | listing_update_start_time | listing_update_start_time | string | — | Optional | 【All Listing报表更新时间】的开始时间(此为零时区时间,格式Y-m-d H:i:s) |
| 7 | listing_update_end_time | listing_update_end_time | string | — | Optional | 【All Listing报表更新时间】的结束时间(此为零时区时间,格式Y-m-d H:i:s) |
| 8 | search_field | 搜索支持字段 | string | — | Optional | 搜索支持字段:seller_sku、asin、sku |
| 9 | search_value | 搜索值 | array<any> | — | Optional | 搜索值,上限10个 |
| 10 | exact_search | 搜索模式 | integer | — | Optional | 搜索模式:0 模糊搜索,1 精确搜索【默认值】 |
| 11 | store_type | 商品类型 | integer | — | Optional | 商品类型,1-非低价商店 ,2-低价商店商品 |
| 12 | offset | 分页偏移量 | integer | — | Optional | 分页偏移量,默认0 |
| 13 | length | 分页长度 | integer | — | Optional | 分页长度,默认1000,上限1000 |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | Required | 状态码,0 成功 |
| 2 | message | 消息提示 | string | success | Required | 消息提示 |
| 3 | error_details | 错误信息 | array<any> | [] | Required | 错误信息 |
| 4 | request_id | 请求链路id | string | 83AAED7E-A5CF-6A09-6446-36F51AA3EEBA | Required | 请求链路id |
| 5 | response_time | 响应时间 | string | 2020-05-18 11:23:47 | Required | 响应时间 |
| 6 | total | 总数 | integer | 1 | Required | 总数 |
| 7 | data | 响应数据 | array<object> | — | Required | 响应数据 |
| 7.1 | fba_fee | 预估FBA费-API | string | — | Required | 预估FBA费-API:API口径预估FBA费 |
| 7.2 | fba_fee_update_time | 预估FBA费-API-更新时间 | string | — | Required | 预估FBA费-API-更新时间:API口径预估FBA费更新时间 |
| 7.3 | report_fba_fee | 预估FBA费-报表 | string | — | Required | 预估FBA费-报表:报表口径预估FBA费 |
| 7.4 | report_fba_fee_update_time | 预估FBA费-报表-更新时间 | string | — | Required | 预估FBA费-报表-更新时间:报表口径预估FBA费更新时间 |
| 7.5 | estimated_referral_fee_rate | 平台费率 | string | — | Required | 平台费率,格式如15.0%,无法计算时为空字符串 |
| 7.6 | estimated_referral_fee | 平台费 | string | — | Required | 平台费:报表口径平台费 |
| 7.7 | estimated_referral_fee_update_time | 平台费-更新时间 | string | — | Required | 平台费-更新时间:平台费报表更新时间 |
| 7.8 | listing_id | 亚马逊定义的listing的id【可能为空】 | string | xx | Required | 亚马逊定义的listing的id【可能为空】 |
| 7.9 | sid | 店铺id | integer | — | Required | 店铺id |
| 7.10 | marketplace | 国家 | string | 美国 | Required | 国家 |
| 7.11 | seller_sku | seller_sku | string | xxxx | Required | MSKU |
| 7.12 | fnsku | fnsku | string | xxxx | Required | FNSKU |
| 7.13 | asin | asin | string | xxxxx | Required | ASIN |
| 7.14 | parent_asin | 父ASIN | string | xxx | Required | 父ASIN |
| 7.15 | small_image_url | 商品缩略图地址 | string | https://xxx/xxx.gif | Required | 商品缩略图地址 |
| 7.16 | status | 状态 | integer | 1 | Required | 状态:0 停售,1 在售 |
| 7.17 | is_delete | 是否删除 | integer | 0 | Required | 是否删除:0 否,1 是 |
| 7.18 | item_name | 标题 | string | xxxx | Required | 标题 |
| 7.19 | local_sku | 本地产品SKU | string | xxxx | Required | 本地产品SKU |
| 7.20 | local_name | 品名 | string | product xxxx | Required | 品名 |
| 7.21 | currency_code | 币种 | string | USD | Required | 币种 |
| 7.22 | price | 价格【不包含促销 | string | 0.00 | Required | 价格【不包含促销,运费,积分】 |
| 7.23 | list_price | List Price | string | 2.22 | Required | List Price |
| 7.24 | remark | 备注 | string | 这是Listing备注 | Required | 备注 |
| 7.25 | landed_price | 总价【包含了促销、运费、积分】 | string | 19.99 | Required | 总价【包含了促销、运费、积分】 |
| 7.26 | listing_price | 优惠价 | string | 19.99 | Required | 优惠价 |
| 7.27 | shipping | 运费 | string | 0.00 | Required | 运费 |
| 7.28 | points | 积分 | string | — | Required | 积分,日本站才有 |
| 7.29 | quantity | FBM库存 | integer | 0 | Required | FBM库存 |
| 7.30 | afn_fulfillable_quantity | FBA可售 | integer | 0 | Required | FBA可售 |
| 7.31 | afn_unsellable_quantity | FBA不可售 | integer | 0 | Required | FBA不可售 |
| 7.32 | reserved_fc_transfers | 待调仓 | integer | 0 | Required | 待调仓 |
| 7.33 | reserved_fc_processing | 调仓中 | integer | 0 | Required | 调仓中 |
| 7.34 | reserved_customerorders | 待发货 | integer | 0 | Required | 待发货 |
| 7.35 | afn_inbound_shipped_quantity | 在途 | integer | 0 | Required | 在途 |
| 7.36 | afn_inbound_working_quantity | 计划入库 | integer | 0 | Required | 计划入库 |
| 7.37 | afn_inbound_receiving_quantity | 入库中 | integer | 0 | Required | 入库中 |
| 7.38 | open_date | 商品创建时间 | string | 2021-02-04 01:15:58 PST | Required | 商品创建时间 |
| 7.39 | open_date_display | 商品创建时间 | string | 2021-02-04 01:15:58 -08:00 | Required | 商品创建时间,格式:Y-m-d H:i:s+时区 |
| 7.40 | listing_update_date | All Listing报表更新时间 (注意 | string | 2021-03-14 06:53:24 | Required | All Listing报表更新时间 (注意:此为零时区时间) |
| 7.41 | seller_rank | 排名 | integer | 38214 | Required | 排名 |
| 7.42 | seller_brand | 亚马逊品牌 | string | 38214 | Required | 亚马逊品牌 |
| 7.43 | seller_category | 排名所属的类别(后续不再维护 | string | Lighting | Required | 排名所属的类别(后续不再维护,改用seller_category_new) |
| 7.44 | review_num | 评论条数 | integer | 0 | Required | 评论条数 |
| 7.45 | last_star | 星级评分 | string | 0 | Required | 星级评分 |
| 7.46 | fulfillment_channel_type | 配送方式 | string | FBM | Required | 配送方式 |
| 7.47 | principal_info | 负责人信息 | array<object> | — | Required | 负责人信息 |
| 7.47.1 | principal_uid | 负责人用户id | integer | xx | Required | 负责人用户id |
| 7.47.2 | principal_name | 负责人姓名 | string | xxx | Required | 负责人姓名 |
| 7.48 | seller_category_new | 排名所属的类别 | array<any> | ["Beauty & Personal Care"] | Required | 排名所属的类别 |
| 7.49 | pair_update_time | 配对更新时间 (注意 | string | 2022-02-23 18:10:45 | Required | 配对更新时间 (注意:此为北京时间) |
| 7.50 | first_order_time | 首单时间 | string | 2023-01-11 | Required | 首单时间,格式:Y-m-d |
| 7.51 | on_sale_time | 开售时间 | string | 2023-02-01 | Required | 开售时间,格式:Y-m-d |
| 7.52 | store_type | 商品类型 | integer | 1 | Required | 商品类型,1-非低价商店 ,2-低价商店商品 |
| 7.53 | total_volume | 销量-7天 | string | 100 | Required | 销量-7天 |
| 7.54 | yesterday_volume | 销量-昨天 | string | 100 | Required | 销量-昨天 |
| 7.55 | fourteen_volume | 销量-14天 | string | 100 | Required | 销量-14天 |
| 7.56 | thirty_volume | 销量-30天 | string | 100 | Required | 销量-30天 |
| 7.57 | yesterday_amount | 销售额-昨天 | string | 110.00 | Required | 销售额-昨天 |
| 7.58 | seven_amount | 销售额-7天 | string | 200.00 | Required | 销售额-7天 |
| 7.59 | fourteen_amount | 销售额-14天 | string | 200.00 | Required | 销售额-14天 |
| 7.60 | thirty_amount | 销售额-30天 | string | 300.00 | Required | 销售额-30天 |
| 7.61 | average_seven_volume | 日均销量-7日 | string | 100 | Required | 日均销量-7日 |
| 7.62 | average_fourteen_volume | 日均销量-14日 | string | 100 | Required | 日均销量-14日 |
| 7.63 | average_thirty_volume | 日均销量-30日 | string | 100 | Required | 日均销量-30日 |
| 7.64 | dimension_info | 尺寸信息 | array<object> | — | Required | 尺寸信息,没有尺寸信息时是空 |
| 7.64.1 | item_height | 商品高度 | string | 22.68 | Required | 商品高度 |
| 7.64.2 | item_height_units_type | 商品高度单位 | string | inch | Required | 商品高度单位: unkown未知单位 空字符串 inches(英寸复数,in) inch(英寸单数,in) centimeter(厘米,cm) yard(码,yd) veron(弗隆,fur) foot(英尺,ft) |
| 7.64.3 | item_length | 商品长度 | string | 95.36 | Required | 商品长度 |
| 7.64.4 | item_length_units_type | 商品长度单位 | string | inch | Required | 商品长度单位: unkown未知单位 空字符串 inches(英寸复数,in) inch(英寸单数,in) centimeter(厘米,cm) yard(码,yd) veron(弗隆,fur) foot(英尺,ft) |
| 7.64.5 | item_width | 商品宽度 | string | 20.55 | Required | 商品宽度 |
| 7.64.6 | item_width_units_type | 商品宽度单位 | string | inch | Required | 商品宽度单位: unkown未知单位 空字符串 inches(英寸复数,in) inch(英寸单数,in) centimeter(厘米,cm) yard(码,yd) veron(弗隆,fur) foot(英尺,ft) |
| 7.64.7 | item_weight | 商品重量 | string | 5.41 | Required | 商品重量 |
| 7.64.8 | item_weight_units_type | 商品重量单位 | object | unknown | Required | 商品重量单位: unkown未知单位 空字符串 pounds(ce(盎司,o磅,ib) kg(千克,kg) ounce(盎司,oz) gram(克,g) carat(克拉,ct) |
| 7.64.9 | package_height | 包装高度 | string | 95.63 | Required | 包装高度 |
| 7.64.10 | package_height_units_type | 包装高度单位 | string | foot | Required | 包装高度单位: unkown未知单位 空字符串 inches(英寸复数,in) inch(英寸单数,in) centimeter(厘米,cm) yard(码,yd) veron(弗隆,fur) foot(英尺,ft) |
| 7.64.11 | package_length | 包装长度 | string | 84.37 | Required | 包装长度 |
| 7.64.12 | package_length_units_type | 包装长度单位 | string | — | Required | 包装长度单位: unkown未知单位 空字符串 inches(英寸复数,in) inch(英寸单数,in) centimeter(厘米,cm) yard(码,yd) veron(弗隆,fur) foot(英尺,ft) |
| 7.64.13 | package_width | 包装宽度 | string | 55.46 | Required | 包装宽度 |
| 7.64.14 | package_width_units_type | 包装宽度单位 | string | — | Required | 包装宽度单位: unkown未知单位 空字符串 inches(英寸复数,in) inch(英寸单数,in) centimeter(厘米,cm) yard(码,yd) veron(弗隆,fur) foot(英尺,ft) |
| 7.64.15 | package_weight | 包装重量 | string | 11.74 | Required | 包装重量 |
| 7.64.16 | package_weight_units_type | 包装重量单位 | string | pounds | Required | 包装重量单位: unkown未知单位 空字符串 pounds(ce(盎司,o磅,ib) kg(千克,kg) ounce(盎司,oz) gram(克,g) carat(克拉,ct) |
| 7.65 | small_rank | 小类排名信息 | array<object> | — | Required | 小类排名信息 |
| 7.65.1 | category | 小类名称 | string | Laptop Stands | Required | 小类名称 |
| 7.65.2 | rank | 小类排名 | string | 223 | Required | 小类排名 |
| 7.66 | global_tags | 全局标签 | array<object> | — | Required | 全局标签 |
| 7.66.1 | globalTagId | 全局标签ID | string | 907204347399528686 | Required | 全局标签ID |
| 7.66.2 | tagName | 标签名称 | string | TEST-005 | Required | 标签名称 |
| 7.66.3 | color | 颜色 | string | #3BB84C | Required | 颜色 |
| 7.67 | variant | 变体属性 | array<object> | — | Required | 变体属性 |
| 7.67.1 | attr_name | 属性名称 | string | color | Required | 属性名称 |
| 7.67.2 | attr_value | 属性值 | string | Sliver | Required | 属性值 |
The 查询亚马逊Listing API (/erp/sc/data/mws/listing) 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.