Lingxing
切换旧版

查询TikTok产品表现

POST/basicOpen/platformStatistics/tiktokProductAnalysis/list

查询TikTok产品表现列表数据,对应系统【统计分析】>【多平台产品表现】>【TikTok】数据

接口信息

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

请求参数

sidsarray<any>
店铺ID列表
siteCodesarray<any>
站点筛选(多选, 传原始site_code, 如10011-TH); 空=全部站点
dimensionTypeinteger必填
维度类型:1=MSKU,2=商品ID,3=SKU,4=店铺
startDatestring必填
查询范围开始日期
endDatestring必填
查询范围结束日期
currencyCodestring
币种,传空则为原币种
searchFieldinteger
搜索字段类型:1=商品ID,2=MSKU ID,3=MSKU,4=标题,5=品名,6=SKU
searchValuearray<any>
搜索关键词,单个关键词支持模糊匹配,多个关键词支持精确匹配
brandIdsarray<any>
品牌ID
categoryIdsarray<any>
分类ID
productStatusarray<any>
商品状态列表:
DRAFT=草稿
PENDING=审核中
FAILED=失败
ACTIVATE=在售
SELLER_DEACTIVATED=已下架
PLATFORM_DEACTIVATED=平台停用
FREEZE=冻结
DELETED=删除
OTHER=其他状态
sortFieldstring
排序字段,默认sales_qty。
可用值:sales_qty、sample_qty、gift_qty、total_qty、order_qty、total_order_qty、sales_amount、sample_amount、total_sales_amount、net_sales_amount、fbt_available、ad_fee
sortTypestring
排序类型:asc、desc,默认desc
pageNuminteger
当前页码
pageSizeinteger
页大小
parentKeystring
展开子行的父行标识,商品ID维度传platformProductId和sid的拼接值,SKU维度传localSku

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/platformStatistics/tiktokProductAnalysis/list?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "sids": [1, 2],
    "dimensionType": 1,
    "startDate": "2026-01-01",
    "endDate": "2026-01-31",
    "currencyCode": "USD",
    "sortField": "sales_qty",
    "sortType": "desc",
    "pageNum": 1,
    "pageSize": 20
}'

返回结果

Json Object

codeinteger必填
状态码,0:成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
数据校验失败时的错误详情
request_idstring必填
请求链路id
示例 a0d54debf93140f3b58d1ed81e8e3583
response_timestring必填
响应时间
示例 2026-06-01 12:00:00
dataobject必填
响应数据
隐藏子属性
netSalesAmountDescstring必填
净销售额公式说明
示例 净销售额=销售额-退款金额
dataarray<object>必填
列表数据
隐藏子属性
adFeenumber必填
广告费
示例 100.5
affiliateAdCommissionnumber必填
联盟广告佣金
示例 20
affiliatePartnerAdCommissionnumber必填
联盟伙伴广告佣金
示例 10
affiliatePartnerCommissionnumber必填
联盟伙伴佣金
示例 8
areastring必填
站点
示例 泰国
avgPricenumber必填
销售均价
示例 25.5
avgSales14dnumber必填
14天日均
示例 5.2
avgSales30dnumber必填
30天日均
示例 4.8
avgSales7dnumber必填
7天日均
示例 6.1
avgVolumenumber必填
销量日均
示例 5
baseInfoListarray<object>必填
MSKU子行明细
隐藏子属性
areastring必填
站点
示例 泰国
bidinteger必填
品牌ID
示例 1
bnamestring必填
品牌名称
示例 BrandA
cidinteger必填
分类ID
示例 10
cnamestring必填
分类名称
示例 电子产品
imageUrlstring必填
主图URL
示例 https://img.example.com/1.jpg
localSkustring必填
本地SKU
示例 SKU001
platformProductIdstring必填
商品ID
示例 PROD001
platformProductNamestring必填
商品标题
示例 示例商品标题
platformStatusstring必填
平台状态
示例 LIVE
pnamestring必填
品名
示例 商品A
pricenumber必填
价格
示例 29.99
rowKeystring必填
子行唯一键
示例 12345$&#124;$1
salesQtyinteger必填
MSKU在所选区间的总销量
示例 200
sellerSkustring必填
MSKU名称
示例 MSKU001
sellerSkuIdstring必填
MSKU ID
示例 12345
sidinteger必填
店铺ID
示例 1
siteCodestring必填
站点原始code
示例 10011-TH
storeNamestring必填
店铺名称
示例 MyStore
bidinteger必填
品牌ID
示例 1
bnamestring必填
品牌
示例 BrandA
buyerFreightnumber必填
客付运费
示例 3.5
cidinteger必填
分类ID
示例 10
cnamestring必填
分类
示例 电子产品
currencyCodestring必填
币种代码
示例 USD
currencyIconstring必填
币种图标
示例 $
estimatedCommissionnumber必填
预估佣金
示例 50
exchangeQtyinteger必填
换货量
示例 2
exchangeRatenumber必填
换货率
示例 0.01
fbtAvailableinteger必填
FBT可售
示例 500
fbtAvailableDaysnumber必填
FBT可售天数预估
示例 30.5
fbtInStockinteger必填
总在库
示例 800
fbtInTransitinteger必填
转运中
示例 100
fbtReservedinteger必填
FBT预留
示例 50
fbtStorageFeenumber必填
FBT仓储费
示例 25
fbtTotalinteger必填
总库存
示例 950
fbtUnfulfillableinteger必填
FBT不可售
示例 10
giftQtyinteger必填
赠品销量
示例 5
gmvOrderQtyinteger必填
GMV MAX广告订单数(归因)
示例 20
gmvSalesAmountnumber必填
GMV MAX广告销售额(归因)
示例 500
imageUrlstring必填
主图URL
示例 https://img.example.com/1.jpg
influencerCommissionnumber必填
达人佣金
示例 30
influencerOrderQtyinteger必填
达人订单数(归因)
示例 10
influencerRefundAmountnumber必填
达人退款金额
示例 5
influencerRefundQtyinteger必填
达人退款数
示例 1
influencerRefundRatenumber必填
达人退款率
示例 0.01
influencerRewardnumber必填
达人奖励
示例 10
influencerSalesAmountnumber必填
达人销售额(归因)
示例 200
influencerSalesQtyinteger必填
达人销量(归因)
示例 8
liveCountinteger必填
直播数
示例 3
localAvailableinteger必填
本地可用
示例 200
localSkustring必填
SKU
示例 SKU001
mskuCountinteger必填
MSKU子行数量
示例 2
netSalesAmountnumber必填
净销售额
示例 1200
orderQtyinteger必填
订单量
示例 150
overseasAvailableinteger必填
海外可用
示例 100
platformProductIdstring必填
商品ID
示例 PROD001
platformProductNamestring必填
标题
示例 示例商品标题
platformStatusstring必填
状态
示例 LIVE
platformSubsidynumber必填
平台补贴
示例 20
pnamestring必填
品名
示例 商品A
pricenumber必填
售价
示例 29.99
productSubsidyAmountnumber必填
商品补贴
示例 5
refundAmountnumber必填
退款金额
示例 50
refundQtyinteger必填
退款量
示例 3
refundRatenumber必填
退款率
示例 0.02
rowKeystring必填
行唯一键
示例 key001
sales14dinteger必填
14天销量
示例 70
sales30dinteger必填
30天销量
示例 150
sales7dinteger必填
7天销量
示例 40
salesAmountnumber必填
销售额
示例 1500
salesQtyinteger必填
销量
示例 200
salesRationumber必填
销量占比
示例 0.15
salesRevenuenumber必填
销售收益
示例 1000
sampleAmountnumber必填
样品销售额
示例 100
sampleQtyinteger必填
样品销量
示例 10
sampleRationumber必填
样品销量占比
示例 0.05
sellerDiscountnumber必填
商品折扣
示例 30
sellerSkustring必填
MSKU
示例 MSKU001
sellerSkuIdstring必填
MSKU ID
示例 12345
settlementCurrencyCodestring必填
结算毛利润-币种代码
示例 USD
settlementCurrencyIconstring必填
结算毛利润-币种图标
示例 $
settlementProfitnumber必填
结算毛利润
示例 280
settlementProfitMarginnumber必填
结算毛利率
示例 0.22
shipmentFeeSubsidyAmountnumber必填
运费补贴
示例 10
sidinteger必填
店铺ID
示例 1
siteCodestring必填
站点原始code
示例 10011-TH
storeNamestring必填
店铺
示例 MyStore
totalAvgVolumenumber必填
总销量日均
示例 6.5
totalOrderQtyinteger必填
总订单量
示例 160
totalQtyinteger必填
总销量
示例 215
totalSalesAmountnumber必填
总销售额
示例 1600
videoCountinteger必填
视频数
示例 5
totalobject必填
合计行数据
隐藏子属性
adFeenumber必填
广告费
示例 5000
affiliateAdCommissionnumber必填
联盟广告佣金
示例 1000
affiliatePartnerAdCommissionnumber必填
联盟伙伴广告佣金
示例 500
affiliatePartnerCommissionnumber必填
联盟伙伴佣金
示例 400
avgPricenumber必填
销售均价
示例 25.5
avgSales14dnumber必填
14天日均
示例 200
avgSales30dnumber必填
30天日均
示例 180
avgSales7dnumber必填
7天日均
示例 220
avgVolumenumber必填
销量日均
示例 190
buyerFreightnumber必填
客付运费
示例 500
currencyCodestring必填
币种代码
示例 USD
currencyIconstring必填
币种图标
示例 $
estimatedCommissionnumber必填
预估佣金
示例 2500
exchangeQtyinteger必填
换货量
示例 50
exchangeRatenumber必填
换货率
示例 0.01
fbtAvailableinteger必填
FBT可售
示例 10000
fbtAvailableDaysnumber必填
FBT可售天数预估
示例 30
fbtInStockinteger必填
总在库
示例 15000
fbtInTransitinteger必填
转运中
示例 2000
fbtReservedinteger必填
FBT预留
示例 500
fbtStorageFeenumber必填
FBT仓储费
示例 1200
fbtTotalinteger必填
总库存
示例 18000
fbtUnfulfillableinteger必填
FBT不可售
示例 100
giftQtyinteger必填
赠品销量
示例 100
gmvOrderQtyinteger必填
GMV MAX广告订单数(归因)
示例 500
gmvSalesAmountnumber必填
GMV MAX广告销售额(归因)
示例 12000
influencerCommissionnumber必填
达人佣金
示例 1500
influencerOrderQtyinteger必填
达人订单数(归因)
示例 300
influencerRefundAmountnumber必填
达人退款金额
示例 200
influencerRefundQtyinteger必填
达人退款数
示例 20
influencerRefundRatenumber必填
达人退款率
示例 0.01
influencerRewardnumber必填
达人奖励
示例 500
influencerSalesAmountnumber必填
达人销售额(归因)
示例 8000
influencerSalesQtyinteger必填
达人销量(归因)
示例 200
liveCountinteger必填
直播数
示例 50
localAvailableinteger必填
本地可用
示例 5000
netSalesAmountnumber必填
净销售额
示例 50000
orderQtyinteger必填
订单量
示例 5000
overseasAvailableinteger必填
海外可用
示例 3000
platformSubsidynumber必填
平台补贴
示例 1000
productSubsidyAmountnumber必填
商品补贴
示例 500
refundAmountnumber必填
退款金额
示例 2000
refundQtyinteger必填
退款量
示例 100
refundRatenumber必填
退款率
示例 0.02
sales14dinteger必填
14天销量
示例 2800
sales30dinteger必填
30天销量
示例 5400
sales7dinteger必填
7天销量
示例 1500
salesAmountnumber必填
销售额
示例 55000
salesQtyinteger必填
销量
示例 6000
salesRationumber必填
销量占比
示例 1
salesRevenuenumber必填
销售收益
示例 45000
sampleAmountnumber必填
样品销售额
示例 3000
sampleQtyinteger必填
样品销量
示例 200
sampleRationumber必填
样品销量占比
示例 0.03
sellerDiscountnumber必填
商品折扣
示例 2000
settlementCurrencyCodestring必填
结算毛利润-币种代码
示例 USD
settlementCurrencyIconstring必填
结算毛利润-币种图标
示例 $
settlementProfitnumber必填
结算毛利润
示例 14000
settlementProfitMarginnumber必填
结算毛利率
示例 0.22
shipmentFeeSubsidyAmountnumber必填
运费补贴
示例 800
totalAvgVolumenumber必填
总销量日均
示例 210
totalOrderQtyinteger必填
总订单量
示例 5200
totalQtyinteger必填
总销量
示例 6300
totalSalesAmountnumber必填
总销售额
示例 58000
videoCountinteger必填
视频数
示例 100
totalinteger必填
总数
示例 100

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583",
    "response_time": "2026-06-01 12:00:00",
    "data": {
        "netSalesAmountDesc": "净销售额=销售额-退款金额",
        "data": [
            {
                "adFee": 100.50,
                "affiliateAdCommission": 20.00,
                "affiliatePartnerAdCommission": 10.00,
                "affiliatePartnerCommission": 8.00,
                "area": "泰国",
                "avgPrice": 25.50,
                "avgSales14d": 5.2,
                "avgSales30d": 4.8,
                "avgSales7d": 6.1,
                "avgVolume": 5.0,
                "sellerSku": "MSKU001",
                "salesQty": 200,
                "salesAmount": 1500.00,
                "netSalesAmount": 1200.00,
                "orderQty": 150,
                "storeName": "MyStore",
                "sid": 1
            }
        ],
        "total": {
            "adFee": 5000.00,
            "salesQty": 6000,
            "salesAmount": 55000.00,
            "netSalesAmount": 50000.00,
            "orderQty": 5000,
            "currencyCode": "USD",
            "currencyIcon": "$"
        }
    },
    "total": 1
}