轻易云
注册体验

领星ERP查询TikTok产品表现接口

所属平台
领星ERP
类型
WebAPI
作用
QUERY
接口版本
1.0
适配器
\Adapter\LingXing\LXQueryAdapter
授权方式
OTHER
描述
多平台 / 统计 · POST · 请求参数 16 个(必填 3) · 响应参数 179 个 · 限流令牌桶容量 1
更新日期
2026-11-21

查询TikTok产品表现

POST/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&timestamp=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
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1sids店铺ID列表array<any>—可选店铺ID列表
2siteCodes站点筛选(多选array<any>—可选站点筛选(多选, 传原始site_code, 如10011-TH); 空=全部站点
3dimensionType维度类型integer—必填维度类型:1=MSKU,2=商品ID,3=SKU,4=店铺
4startDate查询范围开始日期string—必填查询范围开始日期
5endDate查询范围结束日期string—必填查询范围结束日期
6currencyCode币种string—可选币种,传空则为原币种
7searchField搜索字段类型integer—可选搜索字段类型:1=商品ID,2=MSKU ID,3=MSKU,4=标题,5=品名,6=SKU
8searchValue搜索关键词array<any>—可选搜索关键词,单个关键词支持模糊匹配,多个关键词支持精确匹配
9brandIds品牌IDarray<any>—可选品牌ID
10categoryIds分类IDarray<any>—可选分类ID
11productStatus商品状态列表array<any>—可选商品状态列表: DRAFT=草稿 PENDING=审核中 FAILED=失败 ACTIVATE=在售 SELLER_DEACTIVATED=已下架 PLATFORM_DEACTIVATED=平台停用 FREEZE=冻结 DELETED=删除 OTHER=其他状态
12sortField排序字段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
13sortType排序类型string—可选排序类型:asc、desc,默认desc
14pageNum当前页码integer—可选当前页码
15pageSize页大小integer—可选页大小
16parentKey展开子行的父行标识string—可选展开子行的父行标识,商品ID维度传platformProductId和sid的拼接值,SKU维度传localSku

接口响应参数

序号字段名称类型默认值必填描述
1code状态码integer0必填状态码,0:成功
2message消息提示stringsuccess必填消息提示
3error_details数据校验失败时的错误详情array<any>—必填数据校验失败时的错误详情
4request_id请求链路idstringa0d54debf93140f3b58d1ed81e8e3583必填请求链路id
5response_time响应时间string2026-06-01 12:00:00必填响应时间
6data响应数据object—必填响应数据
6.1netSalesAmountDesc净销售额公式说明string净销售额=销售额-退款金额必填净销售额公式说明
6.2data列表数据array<object>—必填列表数据
6.2.1adFee广告费number100.5必填广告费
6.2.2affiliateAdCommission联盟广告佣金number20必填联盟广告佣金
6.2.3affiliatePartnerAdCommission联盟伙伴广告佣金number10必填联盟伙伴广告佣金
6.2.4affiliatePartnerCommission联盟伙伴佣金number8必填联盟伙伴佣金
6.2.5area站点string泰国必填站点
6.2.6avgPrice销售均价number25.5必填销售均价
6.2.7avgSales14d14天日均number5.2必填14天日均
6.2.8avgSales30d30天日均number4.8必填30天日均
6.2.9avgSales7d7天日均number6.1必填7天日均
6.2.10avgVolume销量日均number5必填销量日均
6.2.11baseInfoListMSKU子行明细array<object>—必填MSKU子行明细
6.2.11.1area站点string泰国必填站点
6.2.11.2bid品牌IDinteger1必填品牌ID
6.2.11.3bname品牌名称stringBrandA必填品牌名称
6.2.11.4cid分类IDinteger10必填分类ID
6.2.11.5cname分类名称string电子产品必填分类名称
6.2.11.6imageUrl主图URLstringhttps://img.example.com/1.jpg必填主图URL
6.2.11.7localSku本地SKUstringSKU001必填本地SKU
6.2.11.8platformProductId商品IDstringPROD001必填商品ID
6.2.11.9platformProductName商品标题string示例商品标题必填商品标题
6.2.11.10platformStatus平台状态stringLIVE必填平台状态
6.2.11.11pname品名string商品A必填品名
6.2.11.12price价格number29.99必填价格
6.2.11.13rowKey子行唯一键string12345$&#124;$1必填子行唯一键
6.2.11.14salesQtyMSKU在所选区间的总销量integer200必填MSKU在所选区间的总销量
6.2.11.15sellerSkuMSKU名称stringMSKU001必填MSKU名称
6.2.11.16sellerSkuIdMSKU IDstring12345必填MSKU ID
6.2.11.17sid店铺IDinteger1必填店铺ID
6.2.11.18siteCode站点原始codestring10011-TH必填站点原始code
6.2.11.19storeName店铺名称stringMyStore必填店铺名称
6.2.12bid品牌IDinteger1必填品牌ID
6.2.13bname品牌stringBrandA必填品牌
6.2.14buyerFreight客付运费number3.5必填客付运费
6.2.15cid分类IDinteger10必填分类ID
6.2.16cname分类string电子产品必填分类
6.2.17currencyCode币种代码stringUSD必填币种代码
6.2.18currencyIcon币种图标string$必填币种图标
6.2.19estimatedCommission预估佣金number50必填预估佣金
6.2.20exchangeQty换货量integer2必填换货量
6.2.21exchangeRate换货率number0.01必填换货率
6.2.22fbtAvailableFBT可售integer500必填FBT可售
6.2.23fbtAvailableDaysFBT可售天数预估number30.5必填FBT可售天数预估
6.2.24fbtInStock总在库integer800必填总在库
6.2.25fbtInTransit转运中integer100必填转运中
6.2.26fbtReservedFBT预留integer50必填FBT预留
6.2.27fbtStorageFeeFBT仓储费number25必填FBT仓储费
6.2.28fbtTotal总库存integer950必填总库存
6.2.29fbtUnfulfillableFBT不可售integer10必填FBT不可售
6.2.30giftQty赠品销量integer5必填赠品销量
6.2.31gmvOrderQtyGMV MAX广告订单数(归因)integer20必填GMV MAX广告订单数(归因)
6.2.32gmvSalesAmountGMV MAX广告销售额(归因)number500必填GMV MAX广告销售额(归因)
6.2.33imageUrl主图URLstringhttps://img.example.com/1.jpg必填主图URL
6.2.34influencerCommission达人佣金number30必填达人佣金
6.2.35influencerOrderQty达人订单数(归因)integer10必填达人订单数(归因)
6.2.36influencerRefundAmount达人退款金额number5必填达人退款金额
6.2.37influencerRefundQty达人退款数integer1必填达人退款数
6.2.38influencerRefundRate达人退款率number0.01必填达人退款率
6.2.39influencerReward达人奖励number10必填达人奖励
6.2.40influencerSalesAmount达人销售额(归因)number200必填达人销售额(归因)
6.2.41influencerSalesQty达人销量(归因)integer8必填达人销量(归因)
6.2.42liveCount直播数integer3必填直播数
6.2.43localAvailable本地可用integer200必填本地可用
6.2.44localSkulocalSkustringSKU001必填SKU
6.2.45mskuCountMSKU子行数量integer2必填MSKU子行数量
6.2.46netSalesAmount净销售额number1200必填净销售额
6.2.47orderQty订单量integer150必填订单量
6.2.48overseasAvailable海外可用integer100必填海外可用
6.2.49platformProductId商品IDstringPROD001必填商品ID
6.2.50platformProductName标题string示例商品标题必填标题
6.2.51platformStatus状态stringLIVE必填状态
6.2.52platformSubsidy平台补贴number20必填平台补贴
6.2.53pname品名string商品A必填品名
6.2.54price售价number29.99必填售价
6.2.55productSubsidyAmount商品补贴number5必填商品补贴
6.2.56refundAmount退款金额number50必填退款金额
6.2.57refundQty退款量integer3必填退款量
6.2.58refundRate退款率number0.02必填退款率
6.2.59rowKey行唯一键stringkey001必填行唯一键
6.2.60sales14d14天销量integer70必填14天销量
6.2.61sales30d30天销量integer150必填30天销量
6.2.62sales7d7天销量integer40必填7天销量
6.2.63salesAmount销售额number1500必填销售额
6.2.64salesQty销量integer200必填销量
6.2.65salesRatio销量占比number0.15必填销量占比
6.2.66salesRevenue销售收益number1000必填销售收益
6.2.67sampleAmount样品销售额number100必填样品销售额
6.2.68sampleQty样品销量integer10必填样品销量
6.2.69sampleRatio样品销量占比number0.05必填样品销量占比
6.2.70sellerDiscount商品折扣number30必填商品折扣
6.2.71sellerSkusellerSkustringMSKU001必填MSKU
6.2.72sellerSkuIdMSKU IDstring12345必填MSKU ID
6.2.73settlementCurrencyCode结算毛利润-币种代码stringUSD必填结算毛利润-币种代码
6.2.74settlementCurrencyIcon结算毛利润-币种图标string$必填结算毛利润-币种图标
6.2.75settlementProfit结算毛利润number280必填结算毛利润
6.2.76settlementProfitMargin结算毛利率number0.22必填结算毛利率
6.2.77shipmentFeeSubsidyAmount运费补贴number10必填运费补贴
6.2.78sid店铺IDinteger1必填店铺ID
6.2.79siteCode站点原始codestring10011-TH必填站点原始code
6.2.80storeName店铺stringMyStore必填店铺
6.2.81totalAvgVolume总销量日均number6.5必填总销量日均
6.2.82totalOrderQty总订单量integer160必填总订单量
6.2.83totalQty总销量integer215必填总销量
6.2.84totalSalesAmount总销售额number1600必填总销售额
6.2.85videoCount视频数integer5必填视频数
6.3total合计行数据object—必填合计行数据
6.3.1adFee广告费number5000必填广告费
6.3.2affiliateAdCommission联盟广告佣金number1000必填联盟广告佣金
6.3.3affiliatePartnerAdCommission联盟伙伴广告佣金number500必填联盟伙伴广告佣金
6.3.4affiliatePartnerCommission联盟伙伴佣金number400必填联盟伙伴佣金
6.3.5avgPrice销售均价number25.5必填销售均价
6.3.6avgSales14d14天日均number200必填14天日均
6.3.7avgSales30d30天日均number180必填30天日均
6.3.8avgSales7d7天日均number220必填7天日均
6.3.9avgVolume销量日均number190必填销量日均
6.3.10buyerFreight客付运费number500必填客付运费
6.3.11currencyCode币种代码stringUSD必填币种代码
6.3.12currencyIcon币种图标string$必填币种图标
6.3.13estimatedCommission预估佣金number2500必填预估佣金
6.3.14exchangeQty换货量integer50必填换货量
6.3.15exchangeRate换货率number0.01必填换货率
6.3.16fbtAvailableFBT可售integer10000必填FBT可售
6.3.17fbtAvailableDaysFBT可售天数预估number30必填FBT可售天数预估
6.3.18fbtInStock总在库integer15000必填总在库
6.3.19fbtInTransit转运中integer2000必填转运中
6.3.20fbtReservedFBT预留integer500必填FBT预留
6.3.21fbtStorageFeeFBT仓储费number1200必填FBT仓储费
6.3.22fbtTotal总库存integer18000必填总库存
6.3.23fbtUnfulfillableFBT不可售integer100必填FBT不可售
6.3.24giftQty赠品销量integer100必填赠品销量
6.3.25gmvOrderQtyGMV MAX广告订单数(归因)integer500必填GMV MAX广告订单数(归因)
6.3.26gmvSalesAmountGMV MAX广告销售额(归因)number12000必填GMV MAX广告销售额(归因)
6.3.27influencerCommission达人佣金number1500必填达人佣金
6.3.28influencerOrderQty达人订单数(归因)integer300必填达人订单数(归因)
6.3.29influencerRefundAmount达人退款金额number200必填达人退款金额
6.3.30influencerRefundQty达人退款数integer20必填达人退款数
6.3.31influencerRefundRate达人退款率number0.01必填达人退款率
6.3.32influencerReward达人奖励number500必填达人奖励
6.3.33influencerSalesAmount达人销售额(归因)number8000必填达人销售额(归因)
6.3.34influencerSalesQty达人销量(归因)integer200必填达人销量(归因)
6.3.35liveCount直播数integer50必填直播数
6.3.36localAvailable本地可用integer5000必填本地可用
6.3.37netSalesAmount净销售额number50000必填净销售额
6.3.38orderQty订单量integer5000必填订单量
6.3.39overseasAvailable海外可用integer3000必填海外可用
6.3.40platformSubsidy平台补贴number1000必填平台补贴
6.3.41productSubsidyAmount商品补贴number500必填商品补贴
6.3.42refundAmount退款金额number2000必填退款金额
6.3.43refundQty退款量integer100必填退款量
6.3.44refundRate退款率number0.02必填退款率
6.3.45sales14d14天销量integer2800必填14天销量
6.3.46sales30d30天销量integer5400必填30天销量
6.3.47sales7d7天销量integer1500必填7天销量
6.3.48salesAmount销售额number55000必填销售额
6.3.49salesQty销量integer6000必填销量
6.3.50salesRatio销量占比number1必填销量占比
6.3.51salesRevenue销售收益number45000必填销售收益
6.3.52sampleAmount样品销售额number3000必填样品销售额
6.3.53sampleQty样品销量integer200必填样品销量
6.3.54sampleRatio样品销量占比number0.03必填样品销量占比
6.3.55sellerDiscount商品折扣number2000必填商品折扣
6.3.56settlementCurrencyCode结算毛利润-币种代码stringUSD必填结算毛利润-币种代码
6.3.57settlementCurrencyIcon结算毛利润-币种图标string$必填结算毛利润-币种图标
6.3.58settlementProfit结算毛利润number14000必填结算毛利润
6.3.59settlementProfitMargin结算毛利率number0.22必填结算毛利率
6.3.60shipmentFeeSubsidyAmount运费补贴number800必填运费补贴
6.3.61totalAvgVolume总销量日均number210必填总销量日均
6.3.62totalOrderQty总订单量integer5200必填总订单量
6.3.63totalQty总销量integer6300必填总销量
6.3.64totalSalesAmount总销售额number58000必填总销售额
6.3.65videoCount视频数integer100必填视频数
7total总数integer100必填总数

领星ERP的接口:查询TikTok产品表现(/basicOpen/platformStatistics/tiktokProductAnalysis/list),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。