轻易云
注册体验

领星ERP查询TikTok - 推广广告 - 广告帐号接口

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

查询TikTok - 推广广告 - 广告帐号

POST/basicOpen/multiplatform/ads/queryAdvertiserList
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/multiplatform/ads/queryAdvertiserList"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/ads/queryAdvertiserList?access_token=value&timestamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"endDate\": \"2024-11-12\",\n    \"length\": 20,\n    \"page\": 1,\n    \"startDate\": \"2024-11-01\",\n    \"advertiserIds\": [123456789012345],\n    \"advertiserType\": [],\n    \"bidStrategies\": [],\n    \"budgetTypes\": [],\n    \"currencies\": [\"USD\",\"CNY\"],\n    \"displayTimezones\": [\"America\\/New_York\"],\n    \"orderField\": \"spend\",\n    \"orderType\": \"DESC\",\n    \"ownerBcIds\": [],\n    \"searchType\": \"advertiser_name\",\n    \"searchValue\": [],\n    \"serviceStatus\": [],\n    \"status\": [\"STATUS_ENABLE\",\"STATUS_DISABLE\"],\n    \"summaryCurrency\": \"CNY\"\n}'",
  "responseExample": {
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583.178.17255922733991817",
    "response_time": "2024-11-12 16:00:00",
    "data": {
      "list": [],
      "total": 100
    },
    "total": 1
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1endDate结束日期string—可选结束日期,必填,格式:yyyy-MM-dd,与开始日期间隔不超过31天
2length每页条数integer—可选每页条数,必填,小于2000
3page页码integer—可选页码,必填
4startDate开始日期string—可选开始日期,必填,格式:yyyy-MM-dd
5advertiserIds广告账号Id列表array<any>—可选广告账号Id列表,Long数组
6advertiserType广告主类型列表array<any>—可选广告主类型列表,String数组
7bidStrategies出价策略列表array<any>—可选出价策略列表,String数组
8budgetTypes预算类型列表array<any>—可选预算类型列表,String数组
9currencies币种列表array<any>—可选币种列表,String数组
10displayTimezones地区时区列表array<any>—可选地区时区列表,String数组
11orderField排序字段(驼峰格式)string—可选排序字段(驼峰格式)
12orderType排序方式string—可选排序方式
13ownerBcIds广告主BusinessId列表array<any>—可选广告主BusinessId列表,Long数组
14searchType搜索字段string—可选搜索字段,当字段searchValue有值时该字段也必须有值,枚举值:advertiser_name-广告账号, ad_group_name-广告组, campaign_name-推广系列, ad_name-广告
15searchValue搜索值列表array<any>—可选搜索值列表
16serviceStatus服务状态列表array<any>—可选服务状态列表,String数组
17status状态列表array<any>—可选状态列表,String数组,枚举值:STATUS_ENABLE-已启用, SYSTEM_STATUS_IN_REVIEW-审核中, SYSTEM_STATUS_NOT_PASS-未通过, STATUS_LIMIT-惩罚中, STATUS_DISABLE-已关户
18summaryCurrency汇总币种string—可选汇总币种

接口响应参数

序号字段名称类型默认值必填描述
1code响应码integer—必填响应码
2data返回数据object—必填返回数据
2.1list数据列表array<object>—可选数据列表
2.1.1advertiserId广告账号Idstring1234567890123456可选广告账号Id
2.1.2advertiserName广告账号名称string示例广告账号可选广告账号名称
2.1.3averageVideoPlay平均视频播放时长(秒)number15.5可选平均视频播放时长(秒)
2.1.4averageVideoPlayCount平均视频播放时长计数integer200可选平均视频播放时长计数
2.1.5averageVideoPlayPerUser用户平均播放时长(秒)number12.3可选用户平均播放时长(秒)
2.1.6averageVideoPlayPerUserCount用户平均播放时长计数integer150可选用户平均播放时长计数
2.1.7averageVideoPlayPerUserSum用户平均播放时长汇总number12.3可选用户平均播放时长汇总
2.1.8averageVideoPlaySum平均视频播放时长汇总number15.5可选平均视频播放时长汇总
2.1.9balance账号余额number1000.5可选账号余额
2.1.10basicCnyRateMissingCount基础人民币汇率缺失计数integer0可选基础人民币汇率缺失计数
2.1.11billedCost净消耗number4800可选净消耗
2.1.12cashSpend现金消耗(仅支持广告组层级)number4500可选现金消耗(仅支持广告组层级)
2.1.13clicks点击量integer5000可选点击量
2.1.14cnyBalance人民币余额number7000可选人民币余额
2.1.15cnyBilledCost人民币净消耗number33600可选人民币净消耗
2.1.16cnyCashSpend人民币现金消耗number31500可选人民币现金消耗
2.1.17cnyCostPerOnsiteInitiateCheckoutCount人民币开始结账平均成本(商店)number116.67可选人民币开始结账平均成本(商店)
2.1.18cnyCostPerOnsiteInitiateCheckoutCountCount人民币开始结账平均成本计数integer5可选人民币开始结账平均成本计数
2.1.19cnyCostPerOnsiteInitiateCheckoutCountSum人民币开始结账平均成本汇总number30可选人民币开始结账平均成本汇总
2.1.20cnyCostPerOnsiteOnWebCart人民币加入购物车平均成本(商店)number43.75可选人民币加入购物车平均成本(商店)
2.1.21cnyCostPerOnsiteOnWebCartCount人民币加入购物车平均成本计数integer50可选人民币加入购物车平均成本计数
2.1.22cnyCostPerOnsiteOnWebCartSum人民币加入购物车平均成本汇总number20可选人民币加入购物车平均成本汇总
2.1.23cnyCostPerOnsiteOnWebDetail人民币商品页浏览平均成本(商店)number7可选人民币商品页浏览平均成本(商店)
2.1.24cnyCostPerOnsiteOnWebDetailCount人民币商品页浏览平均成本计数integer100可选人民币商品页浏览平均成本计数
2.1.25cnyCostPerOnsiteOnWebDetailSum人民币商品页浏览平均成本汇总number10可选人民币商品页浏览平均成本汇总
2.1.26cnyCostPerOnsiteShopping人民币平均付费成本(商店)number233.33可选人民币平均付费成本(商店)
2.1.27cnyCostPerOnsiteShoppingCount人民币付费平均成本计数integer10可选人民币付费平均成本计数
2.1.28cnyCostPerOnsiteShoppingSum人民币付费平均成本汇总number50可选人民币付费平均成本汇总
2.1.29cnySpend人民币花费number35000可选人民币花费
2.1.30cnyTotalOnsiteShoppingValue人民币总收入(商店)number122500可选人民币总收入(商店)
2.1.31companyId公司idstringcompany_123可选公司id
2.1.32conversion转化量integer100可选转化量
2.1.33conversionRate转化率number0.02可选转化率
2.1.34costPer1000Reached覆盖千人成本number100可选覆盖千人成本
2.1.35costPerConversion平均转化成本number50可选平均转化成本
2.1.36costPerOnsiteInitiateCheckoutCount开始结账平均成本(商店)number16.67可选开始结账平均成本(商店)
2.1.37costPerOnsiteOnWebCart加入购物车平均成本(商店)number6.25可选加入购物车平均成本(商店)
2.1.38costPerOnsiteOnWebDetail商品页浏览平均成本(商店)number1可选商品页浏览平均成本(商店)
2.1.39costPerOnsiteShopping平均付费成本(商店)number33.33可选平均付费成本(商店)
2.1.40costPerResult平均成效成本number33.33可选平均成效成本
2.1.41country国家stringUS可选国家
2.1.42cpcCPC(单次点击成本)number1可选CPC(单次点击成本)
2.1.43cpmCPM(千次展示成本)number50可选CPM(千次展示成本)
2.1.44ctr点击率number0.05可选点击率
2.1.45currency币种stringUSD可选币种
2.1.46displayTimezone地区&时区(地区中文)string美国东部时间可选地区&时区(地区中文)
2.1.47engagedView播放6秒次数(专注观看)integer45000可选播放6秒次数(专注观看)
2.1.48engagedView15s播放15秒次数(专注观看)integer30000可选播放15秒次数(专注观看)
2.1.49frequency频次integer2可选频次
2.1.50gmtOffset地区&时区(时区)string-05:00可选地区&时区(时区)
2.1.51grossImpressions总展示数(包含无效展示)integer105000可选总展示数(包含无效展示)
2.1.52idid(与各层级的维度id如campaignIdstring1234567890123456可选id(与各层级的维度id如campaignId,adgroupId,adId相同)
2.1.53impressions展示量integer100000可选展示量
2.1.54liveEffectiveViews直播播放10秒次数integer10000可选直播播放10秒次数
2.1.55liveProductClicks直播商品点击数integer1200可选直播商品点击数
2.1.56liveUniqueViews直播去重播放量integer12000可选直播去重播放量
2.1.57liveViews直播播放量integer15000可选直播播放量
2.1.58metricsCnyRateMissingCount指标人民币汇率缺失计数integer0可选指标人民币汇率缺失计数
2.1.59onsiteInitiateCheckoutCount开始结账数(商店)integer300可选开始结账数(商店)
2.1.60onsiteInitiateCheckoutCountRate开始结账率(商店)number0.05可选开始结账率(商店)
2.1.61onsiteInitiateCheckoutCountRateCount开始结账率计数integer40可选开始结账率计数
2.1.62onsiteInitiateCheckoutCountRateSum开始结账率汇总number0.05可选开始结账率汇总
2.1.63onsiteOnWebCart加入购物车数(商店)integer800可选加入购物车数(商店)
2.1.64onsiteOnWebCartRate加入购物车率(商店)number0.08可选加入购物车率(商店)
2.1.65onsiteOnWebCartRateCount加入购物车率计数integer60可选加入购物车率计数
2.1.66onsiteOnWebCartRateSum加入购物车率汇总number0.08可选加入购物车率汇总
2.1.67onsiteOnWebDetail商品页浏览数(商店)integer5000可选商品页浏览数(商店)
2.1.68onsiteOnWebDetailRate商品页浏览率(商店)number0.15可选商品页浏览率(商店)
2.1.69onsiteOnWebDetailRateCount商品页浏览率计数integer80可选商品页浏览率计数
2.1.70onsiteOnWebDetailRateSum商品页浏览率汇总number0.15可选商品页浏览率汇总
2.1.71onsiteShopping付费数(商店)integer150可选付费数(商店)
2.1.72onsiteShoppingRate付费率(商店)number0.03可选付费率(商店)
2.1.73onsiteShoppingRateCount付费率计数integer30可选付费率计数
2.1.74onsiteShoppingRateSum付费率汇总number0.03可选付费率汇总
2.1.75onsiteShoppingRoasROAS(商店)number3.5可选ROAS(商店)
2.1.76onsiteShoppingRoasCountROAS(商店)计数integer20可选ROAS(商店)计数
2.1.77onsiteShoppingRoasSumROAS(商店)汇总number3.5可选ROAS(商店)汇总
2.1.78ownerBcId广告主BusinessIdstring987654321可选广告主BusinessId
2.1.79ownerBcName广告主Business名称string示例商家可选广告主Business名称
2.1.80reach覆盖人数integer50000可选覆盖人数
2.1.81realTimeConversion实时转化量integer120可选实时转化量
2.1.82realTimeConversionRateV2实时转化率(展示)number0.025可选实时转化率(展示)
2.1.83realTimeCostPerConversion实时平均转化成本number41.67可选实时平均转化成本
2.1.84realTimeCostPerResult实时平均成效成本number27.78可选实时平均成效成本
2.1.85realTimeResult实时成效数integer180可选实时成效数
2.1.86reportDate报告日期string2024-11-01可选报告日期,格式:yyyy-MM-dd
2.1.87reportUpdateTime报告更新时间(北京时间)string2024-11-17 14:44:05可选报告更新时间(北京时间)
2.1.88result成效数integer150可选成效数
2.1.89resultRate成效率number0.03可选成效率
2.1.90serviceStatus服务状态stringACTIVE可选服务状态
2.1.91spend花费number5000可选花费
2.1.92status状态stringSTATUS_ENABLE可选状态,枚举值:STATUS_ENABLE-已启用, SYSTEM_STATUS_IN_REVIEW-审核中, SYSTEM_STATUS_NOT_PASS-未通过, STATUS_LIMIT-惩罚中, STATUS_DISABLE-已关户
2.1.93totalOnsiteInitiateCheckoutCountValue开始结账价值(商店)number30000可选开始结账价值(商店)
2.1.94totalOnsiteOnWebCartValue加入购物车价值(商店)number64000可选加入购物车价值(商店)
2.1.95totalOnsiteOnWebDetailValue商品页浏览价值(商店)number250000可选商品页浏览价值(商店)
2.1.96totalOnsiteShoppingValue总收入(商店)number17500可选总收入(商店)
2.1.97valuePerOnsiteInitiateCheckoutCount开始结账平均价值(商店)number100可选开始结账平均价值(商店)
2.1.98valuePerOnsiteInitiateCheckoutCountCount开始结账平均价值计数integer40可选开始结账平均价值计数
2.1.99valuePerOnsiteInitiateCheckoutCountSum开始结账平均价值汇总number100可选开始结账平均价值汇总
2.1.100valuePerOnsiteOnWebCart加入购物车平均价值(商店)number80可选加入购物车平均价值(商店)
2.1.101valuePerOnsiteOnWebCartCount加入购物车平均价值计数integer60可选加入购物车平均价值计数
2.1.102valuePerOnsiteOnWebCartSum加入购物车平均价值汇总number80可选加入购物车平均价值汇总
2.1.103valuePerOnsiteOnWebDetail商品页浏览平均价值(商店)number50可选商品页浏览平均价值(商店)
2.1.104valuePerOnsiteOnWebDetailCount商品页浏览平均价值计数integer100可选商品页浏览平均价值计数
2.1.105valuePerOnsiteOnWebDetailSum商品页浏览平均价值汇总number50可选商品页浏览平均价值汇总
2.1.106valuePerOnsiteShopping平均订单价值(商店)number116.67可选平均订单价值(商店)
2.1.107valuePerOnsiteShoppingCount平均订单价值计数integer30可选平均订单价值计数
2.1.108valuePerOnsiteShoppingSum平均订单价值汇总number120可选平均订单价值汇总
2.1.109videoCompletionRate完播率number0.25可选完播率
2.1.110videoPlayActions视频播放量integer80000可选视频播放量
2.1.111videoViews2sRate2s完播率number0.875可选2s完播率
2.1.112videoViews6sRate6s完播率number0.625可选6s完播率
2.1.113videoViewsP100播放完成次数integer20000可选播放完成次数
2.1.114videoViewsP25播放25%次数integer60000可选播放25%次数
2.1.115videoViewsP25Rate播放25%占比number0.75可选播放25%占比
2.1.116videoViewsP50播放50%次数integer40000可选播放50%次数
2.1.117videoViewsP50Rate播放50%占比number0.5可选播放50%占比
2.1.118videoViewsP75播放75%次数integer25000可选播放75%次数
2.1.119videoViewsP75Rate播放75%占比number0.3125可选播放75%占比
2.1.120videoWatched2s视频播放2秒次数integer70000可选视频播放2秒次数
2.1.121videoWatched6s视频播放6秒次数integer50000可选视频播放6秒次数
2.2total总条数integer1000可选总条数
3error_details错误详情array<any>—必填错误详情
4message提示信息string—必填提示信息
5request_id请求idstring—必填请求id
6response_time响应时间string—必填响应时间
7total总记录数integer—必填总记录数

领星ERP的接口:查询TikTok - 推广广告 - 广告帐号(/basicOpen/multiplatform/ads/queryAdvertiserList),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

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