轻易云
注册体验

领星ERP查询亚马逊Listing接口

所属平台
领星ERP
类型
WebAPI
作用
QUERY
接口版本
1.0
适配器
\Adapter\LingXing\LXQueryAdapter
授权方式
OTHER
描述
销售 / Listing · POST · 请求参数 13 个(必填 1) · 响应参数 99 个 · 限流令牌桶容量 1
更新日期
2026-11-21

查询亚马逊Listing

POST/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}"
}

接口请求参数

序号字段名称类型默认值必填描述
1sid店铺idstring—必填店铺id,多个使用英文逗号分隔 ,对应查询亚马逊店铺列表接口对应字段【sid】
2is_pair是否配对integer—可选是否配对:1 已配对,2 未配对
3is_delete是否删除integer—可选是否删除:0 未删除,1 已删除
4pair_update_start_time【配对更新时间】的开始时间(此为北京时间string—可选【配对更新时间】的开始时间(此为北京时间,格式:Y-m-d H:i:s),用此时间查询要求 is_pair=1
5pair_update_end_time【配对更新时间】的结束时间(此为北京时间string—可选【配对更新时间】的结束时间(此为北京时间,格式:Y-m-d H:i:s),用此时间查询要求 is_pair=1
6listing_update_start_timelisting_update_start_timestring—可选【All Listing报表更新时间】的开始时间(此为零时区时间,格式Y-m-d H:i:s)
7listing_update_end_timelisting_update_end_timestring—可选【All Listing报表更新时间】的结束时间(此为零时区时间,格式Y-m-d H:i:s)
8search_field搜索支持字段string—可选搜索支持字段:seller_sku、asin、sku
9search_value搜索值array<any>—可选搜索值,上限10个
10exact_search搜索模式integer—可选搜索模式:0 模糊搜索,1 精确搜索【默认值】
11store_type商品类型integer—可选商品类型,1-非低价商店 ,2-低价商店商品
12offset分页偏移量integer—可选分页偏移量,默认0
13length分页长度integer—可选分页长度,默认1000,上限1000

接口响应参数

序号字段名称类型默认值必填描述
1code状态码integer0必填状态码,0 成功
2message消息提示stringsuccess必填消息提示
3error_details错误信息array<any>[]必填错误信息
4request_id请求链路idstring83AAED7E-A5CF-6A09-6446-36F51AA3EEBA必填请求链路id
5response_time响应时间string2020-05-18 11:23:47必填响应时间
6total总数integer1必填总数
7data响应数据array<object>—必填响应数据
7.1fba_fee预估FBA费-APIstring—必填预估FBA费-API:API口径预估FBA费
7.2fba_fee_update_time预估FBA费-API-更新时间string—必填预估FBA费-API-更新时间:API口径预估FBA费更新时间
7.3report_fba_fee预估FBA费-报表string—必填预估FBA费-报表:报表口径预估FBA费
7.4report_fba_fee_update_time预估FBA费-报表-更新时间string—必填预估FBA费-报表-更新时间:报表口径预估FBA费更新时间
7.5estimated_referral_fee_rate平台费率string—必填平台费率,格式如15.0%,无法计算时为空字符串
7.6estimated_referral_fee平台费string—必填平台费:报表口径平台费
7.7estimated_referral_fee_update_time平台费-更新时间string—必填平台费-更新时间:平台费报表更新时间
7.8listing_id亚马逊定义的listing的id【可能为空】stringxx必填亚马逊定义的listing的id【可能为空】
7.9sid店铺idinteger—必填店铺id
7.10marketplace国家string美国必填国家
7.11seller_skuseller_skustringxxxx必填MSKU
7.12fnskufnskustringxxxx必填FNSKU
7.13asinasinstringxxxxx必填ASIN
7.14parent_asin父ASINstringxxx必填父ASIN
7.15small_image_url商品缩略图地址stringhttps://xxx/xxx.gif必填商品缩略图地址
7.16status状态integer1必填状态:0 停售,1 在售
7.17is_delete是否删除integer0必填是否删除:0 否,1 是
7.18item_name标题stringxxxx必填标题
7.19local_sku本地产品SKUstringxxxx必填本地产品SKU
7.20local_name品名stringproduct xxxx必填品名
7.21currency_code币种stringUSD必填币种
7.22price价格【不包含促销string0.00必填价格【不包含促销,运费,积分】
7.23list_priceList Pricestring2.22必填List Price
7.24remark备注string这是Listing备注必填备注
7.25landed_price总价【包含了促销、运费、积分】string19.99必填总价【包含了促销、运费、积分】
7.26listing_price优惠价string19.99必填优惠价
7.27shipping运费string0.00必填运费
7.28points积分string—必填积分,日本站才有
7.29quantityFBM库存integer0必填FBM库存
7.30afn_fulfillable_quantityFBA可售integer0必填FBA可售
7.31afn_unsellable_quantityFBA不可售integer0必填FBA不可售
7.32reserved_fc_transfers待调仓integer0必填待调仓
7.33reserved_fc_processing调仓中integer0必填调仓中
7.34reserved_customerorders待发货integer0必填待发货
7.35afn_inbound_shipped_quantity在途integer0必填在途
7.36afn_inbound_working_quantity计划入库integer0必填计划入库
7.37afn_inbound_receiving_quantity入库中integer0必填入库中
7.38open_date商品创建时间string2021-02-04 01:15:58 PST必填商品创建时间
7.39open_date_display商品创建时间string2021-02-04 01:15:58 -08:00必填商品创建时间,格式:Y-m-d H:i:s+时区
7.40listing_update_dateAll Listing报表更新时间 (注意string2021-03-14 06:53:24必填All Listing报表更新时间 (注意:此为零时区时间)
7.41seller_rank排名integer38214必填排名
7.42seller_brand亚马逊品牌string38214必填亚马逊品牌
7.43seller_category排名所属的类别(后续不再维护stringLighting必填排名所属的类别(后续不再维护,改用seller_category_new)
7.44review_num评论条数integer0必填评论条数
7.45last_star星级评分string0必填星级评分
7.46fulfillment_channel_type配送方式stringFBM必填配送方式
7.47principal_info负责人信息array<object>—必填负责人信息
7.47.1principal_uid负责人用户idintegerxx必填负责人用户id
7.47.2principal_name负责人姓名stringxxx必填负责人姓名
7.48seller_category_new排名所属的类别array<any>["Beauty & Personal Care"]必填排名所属的类别
7.49pair_update_time配对更新时间 (注意string2022-02-23 18:10:45必填配对更新时间 (注意:此为北京时间)
7.50first_order_time首单时间string2023-01-11必填首单时间,格式:Y-m-d
7.51on_sale_time开售时间string2023-02-01必填开售时间,格式:Y-m-d
7.52store_type商品类型integer1必填商品类型,1-非低价商店 ,2-低价商店商品
7.53total_volume销量-7天string100必填销量-7天
7.54yesterday_volume销量-昨天string100必填销量-昨天
7.55fourteen_volume销量-14天string100必填销量-14天
7.56thirty_volume销量-30天string100必填销量-30天
7.57yesterday_amount销售额-昨天string110.00必填销售额-昨天
7.58seven_amount销售额-7天string200.00必填销售额-7天
7.59fourteen_amount销售额-14天string200.00必填销售额-14天
7.60thirty_amount销售额-30天string300.00必填销售额-30天
7.61average_seven_volume日均销量-7日string100必填日均销量-7日
7.62average_fourteen_volume日均销量-14日string100必填日均销量-14日
7.63average_thirty_volume日均销量-30日string100必填日均销量-30日
7.64dimension_info尺寸信息array<object>—必填尺寸信息,没有尺寸信息时是空
7.64.1item_height商品高度string22.68必填商品高度
7.64.2item_height_units_type商品高度单位stringinch必填商品高度单位: unkown未知单位 空字符串 inches(英寸复数,in) inch(英寸单数,in) centimeter(厘米,cm) yard(码,yd) veron(弗隆,fur) foot(英尺,ft)
7.64.3item_length商品长度string95.36必填商品长度
7.64.4item_length_units_type商品长度单位stringinch必填商品长度单位: unkown未知单位 空字符串 inches(英寸复数,in) inch(英寸单数,in) centimeter(厘米,cm) yard(码,yd) veron(弗隆,fur) foot(英尺,ft)
7.64.5item_width商品宽度string20.55必填商品宽度
7.64.6item_width_units_type商品宽度单位stringinch必填商品宽度单位: unkown未知单位 空字符串 inches(英寸复数,in) inch(英寸单数,in) centimeter(厘米,cm) yard(码,yd) veron(弗隆,fur) foot(英尺,ft)
7.64.7item_weight商品重量string5.41必填商品重量
7.64.8item_weight_units_type商品重量单位objectunknown必填商品重量单位: unkown未知单位 空字符串 pounds(ce(盎司,o磅,ib) kg(千克,kg) ounce(盎司,oz) gram(克,g) carat(克拉,ct)
7.64.9package_height包装高度string95.63必填包装高度
7.64.10package_height_units_type包装高度单位stringfoot必填包装高度单位: unkown未知单位 空字符串 inches(英寸复数,in) inch(英寸单数,in) centimeter(厘米,cm) yard(码,yd) veron(弗隆,fur) foot(英尺,ft)
7.64.11package_length包装长度string84.37必填包装长度
7.64.12package_length_units_type包装长度单位string—必填包装长度单位: unkown未知单位 空字符串 inches(英寸复数,in) inch(英寸单数,in) centimeter(厘米,cm) yard(码,yd) veron(弗隆,fur) foot(英尺,ft)
7.64.13package_width包装宽度string55.46必填包装宽度
7.64.14package_width_units_type包装宽度单位string—必填包装宽度单位: unkown未知单位 空字符串 inches(英寸复数,in) inch(英寸单数,in) centimeter(厘米,cm) yard(码,yd) veron(弗隆,fur) foot(英尺,ft)
7.64.15package_weight包装重量string11.74必填包装重量
7.64.16package_weight_units_type包装重量单位stringpounds必填包装重量单位: unkown未知单位 空字符串 pounds(ce(盎司,o磅,ib) kg(千克,kg) ounce(盎司,oz) gram(克,g) carat(克拉,ct)
7.65small_rank小类排名信息array<object>—必填小类排名信息
7.65.1category小类名称stringLaptop Stands必填小类名称
7.65.2rank小类排名string223必填小类排名
7.66global_tags全局标签array<object>—必填全局标签
7.66.1globalTagId全局标签IDstring907204347399528686必填全局标签ID
7.66.2tagName标签名称stringTEST-005必填标签名称
7.66.3color颜色string#3BB84C必填颜色
7.67variant变体属性array<object>—必填变体属性
7.67.1attr_name属性名称stringcolor必填属性名称
7.67.2attr_value属性值stringSliver必填属性值

领星ERP的接口:查询亚马逊Listing(/erp/sc/data/mws/listing),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。