Lingxing
切换旧版

查询商品折扣列表

POST/basicOpen/promotion/listingList

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/promotion/listingListHTTPSPOST1

请求参数

site_datestring必填
站点时间,格式:Y-m-d
start_timestring
开始时间【活动时间】,双闭区间,格式:Y-m-d,时间间隔最长不超过90天
end_timestring
结束时间【活动时间】,双闭区间,格式:Y-m-d,时间间隔最长不超过90天
offsetinteger
分页偏移量,默认0
lengthinteger
分页长度,默认20,上限200
is_overlayinteger
是否优惠叠加:
0 否
1 是
sidsarray<any>
店铺id ,对应查询亚马逊店铺列表接口对应字段【sid】
statusarray<any>
促销状态:
0 其他
1 进行中
2 已过期
3 未开始
product_statusarray<any>
商品状态:
-1 已删除
0 停售
1 在售
promotion_categoryarray<any>
促销类型:
1 优惠券
2 秒杀
3 管理促销
4 会员折扣

返回结果

Json Object

codeinteger必填
状态码,0 成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
错误信息
request_idstring必填
请求链路id
示例 C3D9F541-8083-E376-EB5C-606A872F5C89
response_timestring必填
响应时间
示例 2022-12-08 18:27:13
totalinteger必填
总数
示例 0
dataarray<object>必填
响应数据
隐藏子属性
item_namestring必填
商品标题
示例 wallet men's wallet
sidstring必填
店铺id
示例 119
store_namestring必填
店铺名称
示例 uboss-US
region_namestring必填
国家/地区
示例 美国
currency_iconstring必填
货币符号
示例 $
small_image_urlstring必填
商品缩略图地址
示例 https://xxx.com/75.jpg
asinstring必填
ASIN
示例 B0xxxxDXBV
asin_urlstring必填
ASIN跳转地址
示例 https://www.amazon.com/dp/B0xxxxDXBV
seller_skustring必填
MSKU
示例 BN-Q83M-S7I3
promotion_listarray<object>必填
商品优惠券
隐藏子属性
promotion_idstring必填
优惠券id
示例 f88a4358-695b-493d-81d5-9757b4afd715
namestring必填
优惠券名称
示例 Save $2 on 1115满减类型(优惠券) BV
statusstring必填
优惠券状态:
0 其他
1 进行中
2 已过期
3 未开始
示例 0
origin_statusstring必填
优惠券平台原始状态
示例 FAILED
categorystring必填
促销活动类别:
1 优惠券
2 秒杀
3 管理促销
4 促销折扣
示例 1
category_textstring必填
促销活动类型说明
示例 优惠券
promotion_typestring必填
促销类型
示例 7
promotion_type_textstring必填
促销类型说明
示例 金额
discount_pricestring必填
折扣价格
示例 0.00
discount_ratestring必填
折扣率
示例 0.00
promotion_start_timestring必填
促销开始时间
示例 2022-11-15 00:00:00
promotion_end_timestring必填
促销结束时间
示例 2022-12-31 00:00:00
promotion_combo_numinteger必填
折扣叠加数量
示例 1
sales_pricestring必填
优惠价
示例 8.11
sales_price_usdstring必填
优惠券【美元】
示例 8.10
avg_deal_pricestring必填
平均成交价
示例 0.00
discount_price_minstring必填
最低折扣价
示例 0.00
discount_rate_ratestring必填
最低折扣率
示例 0.00
principal_listarray<any>必填
listing负责人
示例 ["jack"]
listing_tagsstring必填
listing标签列表
隐藏子属性
global_tag_idstring必填
标签id
示例 907202235307626941
tag_namestring必填
标签名
示例 条目
colorstring必填
标签颜色
示例 #5A8BF0
afn_fulfillable_quantitystring必填
FBA可售
示例 0
quantitystring必填
FBM可售
示例 0

返回成功示例

  
{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "e320d07cd2b24dfd8e075677c0eee622.159.16982279070474519",
    "response_time": "2023-10-25 17:58:32",
    "data": [
        {
            "item_name": "Multifunctional short wallet antimagnetic wallet men's wallet",
            "sid": "119",
            "store_name": "uboss-US",
            "region_name": "美国",
            "currency_icon": "$",
            "small_image_url": "https://m.media-amazon.com/images/I/31geVbfb-UL._SL75_.jpg",
            "asin": "B09335DXBV",
            "asin_url": "https://www.amazon.com/dp/B0xxxxDXBV",
            "seller_sku": "BN-Q83M-S7I3",
            "promotion_list": [
                {
                    "promotion_id": "f88a4358-695b-493d-81d5-9757b4afd715",
                    "name": "Save $2 on 1115满减类型(优惠券) BV",
                    "status": "0",
                    "origin_status": "FAILED",
                    "category": "1",
                    "category_text": "优惠券",
                    "promotion_type": "7",
                    "promotion_type_text": "金额",
                    "discount_price": "0.00",
                    "discount_rate": "0.00",
                    "promotion_start_time": "2022-11-15 00:00:00",
                    "promotion_end_time": "2022-12-31 00:00:00"
                }
            ],
            "promotion_combo_num": "1",
            "sales_price": "8.11",
            "sales_price_usd": "8.10",
            "avg_deal_price": "0.00",
            "discount_price_min": "0.00",
            "discount_rate_rate": "0.00",
            "principal_list": [
                "jack"
            ],
            "listing_tags": [
                {
                    "global_tag_id": "907202235307626941",
                    "tag_name": "家电大卖",
                    "color": "#5A8BF0"
                }
            ],
            "afn_fulfillable_quantity": "0",
            "quantity": "0"
        }
	],
    "total": 1
}