Qeasy Cloud
Get Started

领星ERP 查询亚马逊Listing API

Platform
领星ERP
Type
WebAPI
Effect
QUERY
API Version
1.0
Adapter
\Adapter\LingXing\LXQueryAdapter
Auth Mode
OTHER
Description
销售 / Listing · POST · 请求参数 13 个(必填 1) · 响应参数 99 个 · 限流令牌桶容量 1
Updated At
2026-11-21

查询亚马逊Listing

POST/erp/sc/data/mws/listing
Factory
{
  "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}"
}

Request Parameters

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

Response Parameters

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

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.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.