Lingxing
切换旧版

商品维度 - 查询运营计划列表

POST/basicOpen/product/operationPlan/page

支持按商品计划维度查询运营计划列表,对应系统【产品】>【运营计划】数据。

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/product/operationPlan/pageHTTPSPOST1

请求参数

storeIdinteger
按店铺进一步限定,来源:查询亚马逊店铺列表返回的 data[].sid
planNamestring
按计划名称精确限定
dimensionsarray<any>
计划维度数组
asin:ASIN
parentAsin:父ASIN
sku:SKU
asinstring
按ASIN限定
parentAsinstring
按父ASIN限定
skustring
按SKU限定
chargeUidinteger
按负责人UID限定,来源:查询用户管理列表返回的 data>>uid
chargeUidsarray<any>
按多个负责人UID限定,来源:查询用户管理列表返回的 data>>uid
planStatusstring
计划状态
0:未开始
1:进行中
2:已结束
不传则查询全部
createUidinteger
按创建人UID限定,来源:查询用户管理列表返回的 data>>uid
lastUidinteger
按最后操作人UID限定,来源:查询用户管理列表返回的 data>>uid
storeIdsarray<any>
多个店铺ID,来源:查询亚马逊店铺列表返回的 data[].sid
startTimestring
查询开始日期,格式 yyyy-MM-dd
endTimestring
查询结束日期,格式 yyyy-MM-dd
queryTimeTypestring
时间筛选类型
0:按计划开始时间查询
1:按计划结束时间查询
searchFieldstring
搜索字段
asin:ASIN
parentAsin:父ASIN
sku:SKU
planName:计划名称
searchValuesarray<any>
搜索值列表,配合 searchField 使用
pageNuminteger必填
页码,默认 1,最小 1
pageSizeinteger必填
每页数量,默认 20,最小 1,最大 200

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/product/operationPlan/page?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "id": "123456789012345678",
    "pageNum": 1,
    "pageSize": 20
}'

返回结果

Json Object

codeinteger必填
状态码,0:成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
数据校验失败时的错误详情
request_idstring必填
请求链路 id
示例 a0d54debf93140f3b58d1ed81e8e3583
response_timestring必填
响应时间
示例 2026-08-18 12:00:00
dataobject必填
响应数据
隐藏子属性
totalinteger必填
数据总数
示例 1
sizeinteger必填
每页大小
示例 20
pageCountinteger必填
总页数
示例 1
currentinteger必填
当前页码
示例 1
currentSizeinteger必填
当前页记录数
示例 1
recordsarray<object>必填
计划记录列表
隐藏子属性
gmtCreatestring必填
创建时间
示例 2024-12-06 13:50:04
gmtModifiedstring必填
修改时间
示例 2024-12-19 20:03:33
storeIdinteger必填
店铺 ID,asin、parentAsin 维度使用
示例 8
storeNamestring必填
店铺名称
示例 JHL Official-01
regionNamestring必填
国家或地区名称
示例 英国
storeIdsstring必填
多个店铺 ID,逗号分隔,sku 维度使用
示例 8,9,10,12
sellerMarketInfosarray<object>必填
店铺与站点信息,sku 维度可返回多个
隐藏子属性
storeIdinteger必填
店铺 ID
示例 8
storeNamestring必填
店铺名称
示例 JHL Official-01
regionNamestring必填
国家或地区名称
示例 英国
planNamestring必填
计划名称
示例 SKU测试
dimensionstring必填
计划维度
示例 sku
asinstring必填
ASIN
示例 B07R3WDSZR
parentAsinstring必填
父 ASIN
示例 B09194Z1F3
skustring必填
SKU
示例 00202192103
currencyCodestring必填
统计币种,sku 维度不为空
示例 USD
currencyIconstring必填
货币符号
示例 $
itemNamestring必填
Listing 品名
示例 SKU测试商品
itemPicturestring必填
Listing 图片地址
示例 https://example.com/item.jpg
chargeUidinteger必填
计划负责人 UID
示例 10326714
startTimestring必填
计划开始时间
示例 2022-05-01
endTimestring必填
计划结束时间
示例 2022-06-30
planStatusinteger必填
计划状态
0:未开始
1:进行中
2:已结束
示例 1
asinUrlstring必填
ASIN 地址
示例 https://www.amazon.com/dp/B07R3WDSZR
isParentstring必填
是否父体标记
示例 false
notStartedCountinteger必填
未开始任务数
示例 0
onGoingCountinteger必填
进行中任务数
示例 1
completedCountinteger必填
已完成任务数
示例 2
canceledCountinteger必填
已取消任务数
示例 0
expireCountinteger必填
已逾期任务数
示例 0
targetCountnumber必填
目标总数
示例 100
targetCompletedCountnumber必填
目标达成数
示例 80
completedRatestring必填
目标综合达成率
示例 80.00
planTargetDTOListarray<object>必填
计划目标列表
隐藏子属性
gmtCreatestring必填
创建时间
示例 2024-12-06 13:50:04
gmtModifiedstring必填
修改时间
示例 2024-12-06 13:50:04
opIdinteger必填
运营计划 ID
示例 1864910158979309600
targetTypeinteger必填
指标分类,1:销售指标,2:广告指标
示例 1
targetKeystring必填
指标 key
示例 sale
targetDetailstring必填
指标明细
示例 sum
targetValuestring必填
指标值
示例 100.00
currentValuestring必填
当前值
示例 80.00
completedRatestring必填
完成进度
示例 80.00
startTimestring必填
开始时间
endTimestring必填
结束时间
targetKeyAndDetailstring必填
指标 key 与明细
isCompletedinteger必填
是否已达成,0:否,1:是
示例 1
dateTimestring必填
日期
idstring必填
目标 ID
示例 139509153281650700
statisticInfostring必填
统计数据 JSON 字符串
示例 {"saleSum":"126.96"}
remarkstring必填
备注
示例 测试备注
fileUrlstring必填
附件地址 JSON 字符串
示例 []
idstring必填
运营计划 ID
示例 1864910158979309570
hasPreviousPageboolean必填
是否有上一页
示例 false
hasNextPageboolean必填
是否有下一页
示例 false
totalinteger必填
总记录数
示例 1

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583",
    "response_time": "2026-08-18 12:00:00",
    "data": {
        "total": 1,
        "size": 20,
        "pageCount": 1,
        "current": 1,
        "currentSize": 1,
        "records": [
            {
                "planName": "SKU测试",
                "dimension": "sku",
                "sku": "00202192103",
                "storeIds": "8,9,10,12",
                "planStatus": 1,
                "planTargetDTOList": [
                    {
                        "targetKey": "sale",
                        "targetValue": "100.00",
                        "currentValue": "80.00",
                        "isCompleted": 0
                    }
                ]
            }
        ],
        "hasPreviousPage": false,
        "hasNextPage": false
    },
    "total": 1
}