Lingxing
切换旧版

查询eBay在线商品列表

POST/basicOpen/multiplatform/ebay/list

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/multiplatform/ebay/listHTTPSPOST1

请求参数

principalUidsarray<any>
负责人用户ID列表
offsetinteger
分页偏移量
lengthinteger
分页长度,默认20,最大上限200
store_idsarray<any>
店铺id
site_codearray<any>
站点code
listing_statusarray<any>
销售状态
auto_restocksarray<any>
是否自动补货:
0 无补货规则
1 启用
2 停用
listing_typearray<any>
销售类型:
1 拍卖
2 固价
3 多属性
search_fieldinteger
查询字段类型:
1 msku
2 商品ID
3 sku
4 标题
5 品名
6 walmart gtin码
search_single_valuestring
搜索值(字符串,单个模糊搜索)
listing_time_fieldinteger
查询时间类型:
1 创建时间
2 结束时间
listing_start_timestring
开始时间(站点时间),Y-m-d,闭区间【开始结束时间不超过31天】
listing_end_timestring
结束时间(站点时间),Y-m-d,闭区间【开始结束时间不超过31天】

请求示例

{
    "principalUids": [
        10001,
        10002
    ],
    "store_ids": [
        "110000000018003001"
    ],
    "site_code": [
        "10003-AU",
        "10003-AT"
    ],
    "listing_status": [
        1
    ],
    "auto_restocks": [
        1,
        2
    ],
    "listing_type": [
        1,
        2
    ],
    "offset": 0,
    "length": 50,
    "search_field": 1,
    "search_single_value": "test",
    "listing_time_field": 1,
    "listing_start_time": "2024-08-14",
    "listing_end_time": "2024-09-13"
}

返回结果

Json Object

codeinteger必填
状态码,0:成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
数据校验失败时的错误详情
request_idstring必填
请求链路id
示例 a7cd109d697e45babbf4a9673ea2189f.1726022450730
response_timestring必填
响应时间
示例 2024-09-11 10:40:54
dataarray<object>必填
隐藏子属性
item_urlstring必填
商品跳转链接
示例 https://www.ebay.com/itm/Cotton-Short-Sleeve-T-shirt-Boys-/353943065214
picture_urlstring必填
图片链接
示例 "https://www.ebay.com/asr/3498e623-4de1-4d4e-8780-d1571dd2af14.5596ac930b26139b73c49a8145501e83.jpeg"
item_idstring必填
商品ID
示例 123943065211
mskustring必填
MSKU
attributestring必填
变体属性
示例 Black/Regular/S
titlestring必填
标题
示例 Cotton Short Sleeve T shirt for Boys
local_namestring必填
品名
local_skustring必填
SKU
listing_statusinteger必填
状态值
示例 1
listing_status_namestring必填
状态
示例 在售
store_idstring必填
店铺id
示例 110000000018003001
store_namestring必填
店铺
示例 test18&自创ebay测试店铺1号11
site_codestring必填
国家id
示例 10003-US
site_namestring必填
国家
示例 美国
listing_typeinteger必填
销售类型id
示例 3
listing_type_namestring必填
销售类型
示例 多属性
pricestring必填
价格
示例 0.99
start_pricestring必填
起拍价
示例 0.00
accept_pricestring必填
一口价
示例 0.00
quantityinteger必填
库存
示例 1
auto_restockstring必填
是否自动补货
product_auto_restock_responseobject必填
自动补货响应
隐藏子属性
variantUniqueIdstring必填
商品变体唯一ID(雪花ID)
示例 901172147307683840
typeinteger必填
补货类型:
1 固定值
2 指定仓库
示例 1
typeNamestring必填
补货类型:
1 固定值
2 指定仓库
示例 固定值
syncIntervalTimeinteger必填
同步间隔时间:
1 每30分钟
2 每1小时
3 每6小时
4 每12小时
5 每24小时
示例 1
syncIntervalTimeNamestring必填
同步间隔时间:
1 每30分钟
2 每1小时
3 每6小时
4 每12小时
5 每24小时
示例 30分钟
autoRestockinteger必填
是否自动补货:
0 未设置补货规则
1 启用
2 停用
示例 2
autoRestockNamestring必填
是否自动补货:
0 未设置补货规则
1 启用
2 停用
示例 停用
disableReasoninteger必填
停用原因:
1 手动停用
2 自动停用
示例 1
disableReasonNamestring必填
停用原因:
1 手动停用
2 自动停用
示例 手动停用
autoDisableReasonstring必填
自动停用具体原因
restockQuantitystring必填
补货数量
示例 10
restockWarehouseIdstring必填
补货仓库ID
示例 0
locationstring必填
物品所在地
示例 Shenzhen
dispatch_time_maxinteger必填
处理时间
示例 20
listing_start_timestring必填
创建时间
示例 2022-03-07 14:41:01
listing_end_timestring必填
结束时间
示例 2022-04-03 14:41:01
totalinteger必填
总数
示例 141

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583.181.17262202316017601",
    "response_time": "2024-09-13 17:37:12",
    "data": [
        {
            "item_url": "https://www.ebay.com/itm/Cotton-Short-Sleeve-T-shirt-Boys-/353943065214",
            "item_id": "123943065211",
            "msku": "",
            "attribute": "Black/Regular/S",
            "title": "Cotton Short Sleeve T shirt for Boys",
            "local_name": null,
            "local_sku": null,
            "listing_status": 1,
            "listing_status_name": "在售",
            "store_id": "110000000018003001",
            "store_name": "test18&自创ebay测试店铺1号11",
            "site_code": "10003-US",
            "site_name": "美国",
            "listing_type": 3,
            "listing_type_name": "多属性",
            "price": "0.99",
            "start_price": "0.00",
            "accept_price": "0.00",
            "quantity": 1,
            "auto_restock": null,
            "product_auto_restock_response": {
                "variantUniqueId": "901172147307683840",
                "type": 1,
                "typeName": "固定值",
                "syncIntervalTime": 1,
                "syncIntervalTimeName": "30分钟",
                "autoRestock": 2,
                "autoRestockName": "停用",
                "disableReason": 1,
                "disableReasonName": "手动停用",
                "autoDisableReason": "",
                "restockQuantity": "10",
                "restockWarehouseId": "0"
            },
            "location": "Shenzhen",
            "dispatch_time_max": 20,
            "listing_start_time": "2022-03-07 14:41:01",
            "listing_end_time": "2022-04-03 14:41:01"
        }
    ],
    "total": 141
}