/basicOpen/platformStatistics/tiktokProductAnalysis/list{
"operation": {
"method": "POST",
"path": "/basicOpen/platformStatistics/tiktokProductAnalysis/list"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 1,
"text": ""
},
"requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/platformStatistics/tiktokProductAnalysis/list?access_token=value×tamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n \"sids\": [1, 2],\n \"dimensionType\": 1,\n \"startDate\": \"2026-01-01\",\n \"endDate\": \"2026-01-31\",\n \"currencyCode\": \"USD\",\n \"sortField\": \"sales_qty\",\n \"sortType\": \"desc\",\n \"pageNum\": 1,\n \"pageSize\": 20\n}'",
"responseExample": {
"code": 0,
"message": "success",
"error_details": [],
"request_id": "a0d54debf93140f3b58d1ed81e8e3583",
"response_time": "2026-06-01 12:00:00",
"data": {
"netSalesAmountDesc": "净销售额=销售额-退款金额",
"data": [
{
"adFee": 100.5,
"affiliateAdCommission": 20,
"affiliatePartnerAdCommission": 10,
"affiliatePartnerCommission": 8,
"area": "泰国",
"avgPrice": 25.5,
"avgSales14d": 5.2,
"avgSales30d": 4.8,
"avgSales7d": 6.1,
"avgVolume": 5,
"sellerSku": "MSKU001",
"salesQty": 200,
"salesAmount": 1500,
"netSalesAmount": 1200,
"orderQty": 150,
"storeName": "MyStore",
"sid": 1
}
],
"total": {
"adFee": 5000,
"salesQty": 6000,
"salesAmount": 55000,
"netSalesAmount": 50000,
"orderQty": 5000,
"currencyCode": "USD",
"currencyIcon": "$"
}
},
"total": 1
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | sids | 店铺ID列表 | array<any> | — | 可选 | 店铺ID列表 |
| 2 | siteCodes | 站点筛选(多选 | array<any> | — | 可选 | 站点筛选(多选, 传原始site_code, 如10011-TH); 空=全部站点 |
| 3 | dimensionType | 维度类型 | integer | — | 必填 | 维度类型:1=MSKU,2=商品ID,3=SKU,4=店铺 |
| 4 | startDate | 查询范围开始日期 | string | — | 必填 | 查询范围开始日期 |
| 5 | endDate | 查询范围结束日期 | string | — | 必填 | 查询范围结束日期 |
| 6 | currencyCode | 币种 | string | — | 可选 | 币种,传空则为原币种 |
| 7 | searchField | 搜索字段类型 | integer | — | 可选 | 搜索字段类型:1=商品ID,2=MSKU ID,3=MSKU,4=标题,5=品名,6=SKU |
| 8 | searchValue | 搜索关键词 | array<any> | — | 可选 | 搜索关键词,单个关键词支持模糊匹配,多个关键词支持精确匹配 |
| 9 | brandIds | 品牌ID | array<any> | — | 可选 | 品牌ID |
| 10 | categoryIds | 分类ID | array<any> | — | 可选 | 分类ID |
| 11 | productStatus | 商品状态列表 | array<any> | — | 可选 | 商品状态列表: DRAFT=草稿 PENDING=审核中 FAILED=失败 ACTIVATE=在售 SELLER_DEACTIVATED=已下架 PLATFORM_DEACTIVATED=平台停用 FREEZE=冻结 DELETED=删除 OTHER=其他状态 |
| 12 | sortField | 排序字段 | string | — | 可选 | 排序字段,默认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 |
| 13 | sortType | 排序类型 | string | — | 可选 | 排序类型:asc、desc,默认desc |
| 14 | pageNum | 当前页码 | integer | — | 可选 | 当前页码 |
| 15 | pageSize | 页大小 | integer | — | 可选 | 页大小 |
| 16 | parentKey | 展开子行的父行标识 | string | — | 可选 | 展开子行的父行标识,商品ID维度传platformProductId和sid的拼接值,SKU维度传localSku |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | 必填 | 状态码,0:成功 |
| 2 | message | 消息提示 | string | success | 必填 | 消息提示 |
| 3 | error_details | 数据校验失败时的错误详情 | array<any> | — | 必填 | 数据校验失败时的错误详情 |
| 4 | request_id | 请求链路id | string | a0d54debf93140f3b58d1ed81e8e3583 | 必填 | 请求链路id |
| 5 | response_time | 响应时间 | string | 2026-06-01 12:00:00 | 必填 | 响应时间 |
| 6 | data | 响应数据 | object | — | 必填 | 响应数据 |
| 6.1 | netSalesAmountDesc | 净销售额公式说明 | string | 净销售额=销售额-退款金额 | 必填 | 净销售额公式说明 |
| 6.2 | data | 列表数据 | array<object> | — | 必填 | 列表数据 |
| 6.2.1 | adFee | 广告费 | number | 100.5 | 必填 | 广告费 |
| 6.2.2 | affiliateAdCommission | 联盟广告佣金 | number | 20 | 必填 | 联盟广告佣金 |
| 6.2.3 | affiliatePartnerAdCommission | 联盟伙伴广告佣金 | number | 10 | 必填 | 联盟伙伴广告佣金 |
| 6.2.4 | affiliatePartnerCommission | 联盟伙伴佣金 | number | 8 | 必填 | 联盟伙伴佣金 |
| 6.2.5 | area | 站点 | string | 泰国 | 必填 | 站点 |
| 6.2.6 | avgPrice | 销售均价 | number | 25.5 | 必填 | 销售均价 |
| 6.2.7 | avgSales14d | 14天日均 | number | 5.2 | 必填 | 14天日均 |
| 6.2.8 | avgSales30d | 30天日均 | number | 4.8 | 必填 | 30天日均 |
| 6.2.9 | avgSales7d | 7天日均 | number | 6.1 | 必填 | 7天日均 |
| 6.2.10 | avgVolume | 销量日均 | number | 5 | 必填 | 销量日均 |
| 6.2.11 | baseInfoList | MSKU子行明细 | array<object> | — | 必填 | MSKU子行明细 |
| 6.2.11.1 | area | 站点 | string | 泰国 | 必填 | 站点 |
| 6.2.11.2 | bid | 品牌ID | integer | 1 | 必填 | 品牌ID |
| 6.2.11.3 | bname | 品牌名称 | string | BrandA | 必填 | 品牌名称 |
| 6.2.11.4 | cid | 分类ID | integer | 10 | 必填 | 分类ID |
| 6.2.11.5 | cname | 分类名称 | string | 电子产品 | 必填 | 分类名称 |
| 6.2.11.6 | imageUrl | 主图URL | string | https://img.example.com/1.jpg | 必填 | 主图URL |
| 6.2.11.7 | localSku | 本地SKU | string | SKU001 | 必填 | 本地SKU |
| 6.2.11.8 | platformProductId | 商品ID | string | PROD001 | 必填 | 商品ID |
| 6.2.11.9 | platformProductName | 商品标题 | string | 示例商品标题 | 必填 | 商品标题 |
| 6.2.11.10 | platformStatus | 平台状态 | string | LIVE | 必填 | 平台状态 |
| 6.2.11.11 | pname | 品名 | string | 商品A | 必填 | 品名 |
| 6.2.11.12 | price | 价格 | number | 29.99 | 必填 | 价格 |
| 6.2.11.13 | rowKey | 子行唯一键 | string | 12345$|$1 | 必填 | 子行唯一键 |
| 6.2.11.14 | salesQty | MSKU在所选区间的总销量 | integer | 200 | 必填 | MSKU在所选区间的总销量 |
| 6.2.11.15 | sellerSku | MSKU名称 | string | MSKU001 | 必填 | MSKU名称 |
| 6.2.11.16 | sellerSkuId | MSKU ID | string | 12345 | 必填 | MSKU ID |
| 6.2.11.17 | sid | 店铺ID | integer | 1 | 必填 | 店铺ID |
| 6.2.11.18 | siteCode | 站点原始code | string | 10011-TH | 必填 | 站点原始code |
| 6.2.11.19 | storeName | 店铺名称 | string | MyStore | 必填 | 店铺名称 |
| 6.2.12 | bid | 品牌ID | integer | 1 | 必填 | 品牌ID |
| 6.2.13 | bname | 品牌 | string | BrandA | 必填 | 品牌 |
| 6.2.14 | buyerFreight | 客付运费 | number | 3.5 | 必填 | 客付运费 |
| 6.2.15 | cid | 分类ID | integer | 10 | 必填 | 分类ID |
| 6.2.16 | cname | 分类 | string | 电子产品 | 必填 | 分类 |
| 6.2.17 | currencyCode | 币种代码 | string | USD | 必填 | 币种代码 |
| 6.2.18 | currencyIcon | 币种图标 | string | $ | 必填 | 币种图标 |
| 6.2.19 | estimatedCommission | 预估佣金 | number | 50 | 必填 | 预估佣金 |
| 6.2.20 | exchangeQty | 换货量 | integer | 2 | 必填 | 换货量 |
| 6.2.21 | exchangeRate | 换货率 | number | 0.01 | 必填 | 换货率 |
| 6.2.22 | fbtAvailable | FBT可售 | integer | 500 | 必填 | FBT可售 |
| 6.2.23 | fbtAvailableDays | FBT可售天数预估 | number | 30.5 | 必填 | FBT可售天数预估 |
| 6.2.24 | fbtInStock | 总在库 | integer | 800 | 必填 | 总在库 |
| 6.2.25 | fbtInTransit | 转运中 | integer | 100 | 必填 | 转运中 |
| 6.2.26 | fbtReserved | FBT预留 | integer | 50 | 必填 | FBT预留 |
| 6.2.27 | fbtStorageFee | FBT仓储费 | number | 25 | 必填 | FBT仓储费 |
| 6.2.28 | fbtTotal | 总库存 | integer | 950 | 必填 | 总库存 |
| 6.2.29 | fbtUnfulfillable | FBT不可售 | integer | 10 | 必填 | FBT不可售 |
| 6.2.30 | giftQty | 赠品销量 | integer | 5 | 必填 | 赠品销量 |
| 6.2.31 | gmvOrderQty | GMV MAX广告订单数(归因) | integer | 20 | 必填 | GMV MAX广告订单数(归因) |
| 6.2.32 | gmvSalesAmount | GMV MAX广告销售额(归因) | number | 500 | 必填 | GMV MAX广告销售额(归因) |
| 6.2.33 | imageUrl | 主图URL | string | https://img.example.com/1.jpg | 必填 | 主图URL |
| 6.2.34 | influencerCommission | 达人佣金 | number | 30 | 必填 | 达人佣金 |
| 6.2.35 | influencerOrderQty | 达人订单数(归因) | integer | 10 | 必填 | 达人订单数(归因) |
| 6.2.36 | influencerRefundAmount | 达人退款金额 | number | 5 | 必填 | 达人退款金额 |
| 6.2.37 | influencerRefundQty | 达人退款数 | integer | 1 | 必填 | 达人退款数 |
| 6.2.38 | influencerRefundRate | 达人退款率 | number | 0.01 | 必填 | 达人退款率 |
| 6.2.39 | influencerReward | 达人奖励 | number | 10 | 必填 | 达人奖励 |
| 6.2.40 | influencerSalesAmount | 达人销售额(归因) | number | 200 | 必填 | 达人销售额(归因) |
| 6.2.41 | influencerSalesQty | 达人销量(归因) | integer | 8 | 必填 | 达人销量(归因) |
| 6.2.42 | liveCount | 直播数 | integer | 3 | 必填 | 直播数 |
| 6.2.43 | localAvailable | 本地可用 | integer | 200 | 必填 | 本地可用 |
| 6.2.44 | localSku | localSku | string | SKU001 | 必填 | SKU |
| 6.2.45 | mskuCount | MSKU子行数量 | integer | 2 | 必填 | MSKU子行数量 |
| 6.2.46 | netSalesAmount | 净销售额 | number | 1200 | 必填 | 净销售额 |
| 6.2.47 | orderQty | 订单量 | integer | 150 | 必填 | 订单量 |
| 6.2.48 | overseasAvailable | 海外可用 | integer | 100 | 必填 | 海外可用 |
| 6.2.49 | platformProductId | 商品ID | string | PROD001 | 必填 | 商品ID |
| 6.2.50 | platformProductName | 标题 | string | 示例商品标题 | 必填 | 标题 |
| 6.2.51 | platformStatus | 状态 | string | LIVE | 必填 | 状态 |
| 6.2.52 | platformSubsidy | 平台补贴 | number | 20 | 必填 | 平台补贴 |
| 6.2.53 | pname | 品名 | string | 商品A | 必填 | 品名 |
| 6.2.54 | price | 售价 | number | 29.99 | 必填 | 售价 |
| 6.2.55 | productSubsidyAmount | 商品补贴 | number | 5 | 必填 | 商品补贴 |
| 6.2.56 | refundAmount | 退款金额 | number | 50 | 必填 | 退款金额 |
| 6.2.57 | refundQty | 退款量 | integer | 3 | 必填 | 退款量 |
| 6.2.58 | refundRate | 退款率 | number | 0.02 | 必填 | 退款率 |
| 6.2.59 | rowKey | 行唯一键 | string | key001 | 必填 | 行唯一键 |
| 6.2.60 | sales14d | 14天销量 | integer | 70 | 必填 | 14天销量 |
| 6.2.61 | sales30d | 30天销量 | integer | 150 | 必填 | 30天销量 |
| 6.2.62 | sales7d | 7天销量 | integer | 40 | 必填 | 7天销量 |
| 6.2.63 | salesAmount | 销售额 | number | 1500 | 必填 | 销售额 |
| 6.2.64 | salesQty | 销量 | integer | 200 | 必填 | 销量 |
| 6.2.65 | salesRatio | 销量占比 | number | 0.15 | 必填 | 销量占比 |
| 6.2.66 | salesRevenue | 销售收益 | number | 1000 | 必填 | 销售收益 |
| 6.2.67 | sampleAmount | 样品销售额 | number | 100 | 必填 | 样品销售额 |
| 6.2.68 | sampleQty | 样品销量 | integer | 10 | 必填 | 样品销量 |
| 6.2.69 | sampleRatio | 样品销量占比 | number | 0.05 | 必填 | 样品销量占比 |
| 6.2.70 | sellerDiscount | 商品折扣 | number | 30 | 必填 | 商品折扣 |
| 6.2.71 | sellerSku | sellerSku | string | MSKU001 | 必填 | MSKU |
| 6.2.72 | sellerSkuId | MSKU ID | string | 12345 | 必填 | MSKU ID |
| 6.2.73 | settlementCurrencyCode | 结算毛利润-币种代码 | string | USD | 必填 | 结算毛利润-币种代码 |
| 6.2.74 | settlementCurrencyIcon | 结算毛利润-币种图标 | string | $ | 必填 | 结算毛利润-币种图标 |
| 6.2.75 | settlementProfit | 结算毛利润 | number | 280 | 必填 | 结算毛利润 |
| 6.2.76 | settlementProfitMargin | 结算毛利率 | number | 0.22 | 必填 | 结算毛利率 |
| 6.2.77 | shipmentFeeSubsidyAmount | 运费补贴 | number | 10 | 必填 | 运费补贴 |
| 6.2.78 | sid | 店铺ID | integer | 1 | 必填 | 店铺ID |
| 6.2.79 | siteCode | 站点原始code | string | 10011-TH | 必填 | 站点原始code |
| 6.2.80 | storeName | 店铺 | string | MyStore | 必填 | 店铺 |
| 6.2.81 | totalAvgVolume | 总销量日均 | number | 6.5 | 必填 | 总销量日均 |
| 6.2.82 | totalOrderQty | 总订单量 | integer | 160 | 必填 | 总订单量 |
| 6.2.83 | totalQty | 总销量 | integer | 215 | 必填 | 总销量 |
| 6.2.84 | totalSalesAmount | 总销售额 | number | 1600 | 必填 | 总销售额 |
| 6.2.85 | videoCount | 视频数 | integer | 5 | 必填 | 视频数 |
| 6.3 | total | 合计行数据 | object | — | 必填 | 合计行数据 |
| 6.3.1 | adFee | 广告费 | number | 5000 | 必填 | 广告费 |
| 6.3.2 | affiliateAdCommission | 联盟广告佣金 | number | 1000 | 必填 | 联盟广告佣金 |
| 6.3.3 | affiliatePartnerAdCommission | 联盟伙伴广告佣金 | number | 500 | 必填 | 联盟伙伴广告佣金 |
| 6.3.4 | affiliatePartnerCommission | 联盟伙伴佣金 | number | 400 | 必填 | 联盟伙伴佣金 |
| 6.3.5 | avgPrice | 销售均价 | number | 25.5 | 必填 | 销售均价 |
| 6.3.6 | avgSales14d | 14天日均 | number | 200 | 必填 | 14天日均 |
| 6.3.7 | avgSales30d | 30天日均 | number | 180 | 必填 | 30天日均 |
| 6.3.8 | avgSales7d | 7天日均 | number | 220 | 必填 | 7天日均 |
| 6.3.9 | avgVolume | 销量日均 | number | 190 | 必填 | 销量日均 |
| 6.3.10 | buyerFreight | 客付运费 | number | 500 | 必填 | 客付运费 |
| 6.3.11 | currencyCode | 币种代码 | string | USD | 必填 | 币种代码 |
| 6.3.12 | currencyIcon | 币种图标 | string | $ | 必填 | 币种图标 |
| 6.3.13 | estimatedCommission | 预估佣金 | number | 2500 | 必填 | 预估佣金 |
| 6.3.14 | exchangeQty | 换货量 | integer | 50 | 必填 | 换货量 |
| 6.3.15 | exchangeRate | 换货率 | number | 0.01 | 必填 | 换货率 |
| 6.3.16 | fbtAvailable | FBT可售 | integer | 10000 | 必填 | FBT可售 |
| 6.3.17 | fbtAvailableDays | FBT可售天数预估 | number | 30 | 必填 | FBT可售天数预估 |
| 6.3.18 | fbtInStock | 总在库 | integer | 15000 | 必填 | 总在库 |
| 6.3.19 | fbtInTransit | 转运中 | integer | 2000 | 必填 | 转运中 |
| 6.3.20 | fbtReserved | FBT预留 | integer | 500 | 必填 | FBT预留 |
| 6.3.21 | fbtStorageFee | FBT仓储费 | number | 1200 | 必填 | FBT仓储费 |
| 6.3.22 | fbtTotal | 总库存 | integer | 18000 | 必填 | 总库存 |
| 6.3.23 | fbtUnfulfillable | FBT不可售 | integer | 100 | 必填 | FBT不可售 |
| 6.3.24 | giftQty | 赠品销量 | integer | 100 | 必填 | 赠品销量 |
| 6.3.25 | gmvOrderQty | GMV MAX广告订单数(归因) | integer | 500 | 必填 | GMV MAX广告订单数(归因) |
| 6.3.26 | gmvSalesAmount | GMV MAX广告销售额(归因) | number | 12000 | 必填 | GMV MAX广告销售额(归因) |
| 6.3.27 | influencerCommission | 达人佣金 | number | 1500 | 必填 | 达人佣金 |
| 6.3.28 | influencerOrderQty | 达人订单数(归因) | integer | 300 | 必填 | 达人订单数(归因) |
| 6.3.29 | influencerRefundAmount | 达人退款金额 | number | 200 | 必填 | 达人退款金额 |
| 6.3.30 | influencerRefundQty | 达人退款数 | integer | 20 | 必填 | 达人退款数 |
| 6.3.31 | influencerRefundRate | 达人退款率 | number | 0.01 | 必填 | 达人退款率 |
| 6.3.32 | influencerReward | 达人奖励 | number | 500 | 必填 | 达人奖励 |
| 6.3.33 | influencerSalesAmount | 达人销售额(归因) | number | 8000 | 必填 | 达人销售额(归因) |
| 6.3.34 | influencerSalesQty | 达人销量(归因) | integer | 200 | 必填 | 达人销量(归因) |
| 6.3.35 | liveCount | 直播数 | integer | 50 | 必填 | 直播数 |
| 6.3.36 | localAvailable | 本地可用 | integer | 5000 | 必填 | 本地可用 |
| 6.3.37 | netSalesAmount | 净销售额 | number | 50000 | 必填 | 净销售额 |
| 6.3.38 | orderQty | 订单量 | integer | 5000 | 必填 | 订单量 |
| 6.3.39 | overseasAvailable | 海外可用 | integer | 3000 | 必填 | 海外可用 |
| 6.3.40 | platformSubsidy | 平台补贴 | number | 1000 | 必填 | 平台补贴 |
| 6.3.41 | productSubsidyAmount | 商品补贴 | number | 500 | 必填 | 商品补贴 |
| 6.3.42 | refundAmount | 退款金额 | number | 2000 | 必填 | 退款金额 |
| 6.3.43 | refundQty | 退款量 | integer | 100 | 必填 | 退款量 |
| 6.3.44 | refundRate | 退款率 | number | 0.02 | 必填 | 退款率 |
| 6.3.45 | sales14d | 14天销量 | integer | 2800 | 必填 | 14天销量 |
| 6.3.46 | sales30d | 30天销量 | integer | 5400 | 必填 | 30天销量 |
| 6.3.47 | sales7d | 7天销量 | integer | 1500 | 必填 | 7天销量 |
| 6.3.48 | salesAmount | 销售额 | number | 55000 | 必填 | 销售额 |
| 6.3.49 | salesQty | 销量 | integer | 6000 | 必填 | 销量 |
| 6.3.50 | salesRatio | 销量占比 | number | 1 | 必填 | 销量占比 |
| 6.3.51 | salesRevenue | 销售收益 | number | 45000 | 必填 | 销售收益 |
| 6.3.52 | sampleAmount | 样品销售额 | number | 3000 | 必填 | 样品销售额 |
| 6.3.53 | sampleQty | 样品销量 | integer | 200 | 必填 | 样品销量 |
| 6.3.54 | sampleRatio | 样品销量占比 | number | 0.03 | 必填 | 样品销量占比 |
| 6.3.55 | sellerDiscount | 商品折扣 | number | 2000 | 必填 | 商品折扣 |
| 6.3.56 | settlementCurrencyCode | 结算毛利润-币种代码 | string | USD | 必填 | 结算毛利润-币种代码 |
| 6.3.57 | settlementCurrencyIcon | 结算毛利润-币种图标 | string | $ | 必填 | 结算毛利润-币种图标 |
| 6.3.58 | settlementProfit | 结算毛利润 | number | 14000 | 必填 | 结算毛利润 |
| 6.3.59 | settlementProfitMargin | 结算毛利率 | number | 0.22 | 必填 | 结算毛利率 |
| 6.3.60 | shipmentFeeSubsidyAmount | 运费补贴 | number | 800 | 必填 | 运费补贴 |
| 6.3.61 | totalAvgVolume | 总销量日均 | number | 210 | 必填 | 总销量日均 |
| 6.3.62 | totalOrderQty | 总订单量 | integer | 5200 | 必填 | 总订单量 |
| 6.3.63 | totalQty | 总销量 | integer | 6300 | 必填 | 总销量 |
| 6.3.64 | totalSalesAmount | 总销售额 | number | 58000 | 必填 | 总销售额 |
| 6.3.65 | videoCount | 视频数 | integer | 100 | 必填 | 视频数 |
| 7 | total | 总数 | integer | 100 | 必填 | 总数 |
领星ERP的接口:查询TikTok产品表现(/basicOpen/platformStatistics/tiktokProductAnalysis/list),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。