Qeasy Cloud
Get Started

领星ERP 查询TikTok - 推广广告 - 广告 API

Platform
领星ERP
Type
WebAPI
Effect
QUERY
API Version
1.0
Adapter
\Adapter\LingXing\LXQueryAdapter
Auth Mode
OTHER
Description
多平台 / 广告 / TikTok广告 · POST · 请求参数 22 个(必填 0) · 响应参数 97 个 · 限流令牌桶容量 1
Updated At
2026-11-21

查询TikTok - 推广广告 - 广告

POST/basicOpen/multiplatform/ads/queryTiktokAdList
Factory
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/multiplatform/ads/queryTiktokAdList"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/ads/queryTiktokAdList?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    \"adIds\": [\"1111111111\"],\n    \"adStyles\": [\"VIDEO_AD\"],\n    \"adgroupIds\": [\"9876543210\"],\n    \"advertiserIds\": [\"123456789012345\"],\n    \"bidStrategies\": [\"LOWEST_COST\"],\n    \"budgetTypes\": [\"DAILY\"],\n    \"campaignIds\": [\"1234567890\"],\n    \"creativeMaterialTypes\": [\"CUSTOMIZED_CREATIVE\"],\n    \"currencies\": [\"USD\",\"CNY\"],\n    \"orderField\": \"spend\",\n    \"orderType\": \"DESC\",\n    \"ownerBcIds\": [\"123456\"],\n    \"searchType\": \"ad_name\",\n    \"searchValue\": [\"\\u6d4b\\u8bd5\\u5e7f\\u544a\"],\n    \"serviceStatus\": [\"ACTIVE\"],\n    \"status\": [\"STATUS_ENABLE\",\"SYSTEM_STATUS_IN_REVIEW\"],\n    \"summaryCurrency\": \"CNY\",\n    \"videoTypes\": [\"USER_GENERATE\"]\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
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1endDate结束日期string—Optional结束日期,必填,格式:yyyy-MM-dd,与开始日期间隔不超过31天
2length每页条数integer—Optional每页条数,必填,小于2000
3page页码integer—Optional页码,必填
4startDate开始日期string—Optional开始日期,必填,格式:yyyy-MM-dd
5adIds广告id列表array<any>—Optional广告id列表,Long数组
6adStyles广告样式列表array<any>—Optional广告样式列表,String数组
7adgroupIds广告组id列表array<any>—Optional广告组id列表,String数组
8advertiserIds广告账号Id列表array<any>—Optional广告账号Id列表,Long数组
9bidStrategies出价策略列表array<any>—Optional出价策略列表,String数组
10budgetTypes预算类型列表array<any>—Optional预算类型列表,String数组
11campaignIds推广系列id列表array<any>—Optional推广系列id列表,String数组
12creativeMaterialTypes创意素材类型列表array<any>—Optional创意素材类型列表,String数组
13currencies币种列表array<any>—Optional币种列表,String数组
14orderField排序字段(驼峰)string—Optional排序字段(驼峰)
15orderType排序方式string—Optional排序方式,枚举值:ASC-升序, DESC-降序
16ownerBcIds广告主BusinessId列表array<any>—Optional广告主BusinessId列表,Long数组
17searchType搜索字段string—Optional搜索字段,枚举值:advertiser_name-广告账号, ad_group_name-广告组, campaign_name-推广系列, ad_name-广告
18searchValue搜索值array<any>—Optional搜索值,String数组
19serviceStatus服务状态列表array<any>—Optional服务状态列表,String数组
20status状态列表array<any>—Optional状态列表,String数组,枚举值:STATUS_ENABLE-已启用, SYSTEM_STATUS_IN_REVIEW-审核中, SYSTEM_STATUS_NOT_PASS-未通过, STATUS_LIMIT-惩罚中, STATUS_DISABLE-已关户
21summaryCurrency汇总币种string—Optional汇总币种
22videoTypes视频类型列表array<any>—Optional视频类型列表,String数组

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code响应码integer—Required响应码
2data返回数据object—Required返回数据
2.1list列表数据array<object>—Required列表数据
2.1.1adFormat广告样式stringVIDEO_ADOptional广告样式
2.1.2adGroupId广告组Idstring7023456789012345678Optional广告组Id
2.1.3adGroupName广告组名称string测试广告组Optional广告组名称
2.1.4adId广告Idstring7123456789012345678Optional广告Id
2.1.5adName广告名称string测试广告Optional广告名称
2.1.6advertiserId广告账号Idstring123456789012345Optional广告账号Id
2.1.7advertiserName广告账号名称string测试账号Optional广告账号名称
2.1.8averageVideoPlay平均视频播放时长string15.5Optional平均视频播放时长,单位:秒
2.1.9averageVideoPlayPerUser用户平均播放时长string18.2Optional用户平均播放时长,单位:秒
2.1.10billedCost净消耗string1200Optional净消耗
2.1.11campaignId推广系列Idstring6923456789012345678Optional推广系列Id
2.1.12campaignName推广系列名称string测试推广系列Optional推广系列名称
2.1.13cashSpend现金消耗(只支持广告组层级)string1100Optional现金消耗(只支持广告组层级)
2.1.14clicks点击量integer500Optional点击量
2.1.15companyId公司idstring100001Optional公司id
2.1.16conversion转化量integer25Optional转化量
2.1.17conversionRate转化率string0.05Optional转化率
2.1.18costPer1000Reached覆盖千人成本string150Optional覆盖千人成本
2.1.19costPerConversion平均转化成本string50.02Optional平均转化成本
2.1.20costPerOnsiteInitiateCheckoutCount开始结账平均成本(商店)string31.26Optional开始结账平均成本(商店)
2.1.21costPerOnsiteOnWebCart加入购物车平均成本(商店)string15.63Optional加入购物车平均成本(商店)
2.1.22costPerOnsiteOnWebDetail商品页浏览平均成本(商店)string6.25Optional商品页浏览平均成本(商店)
2.1.23costPerOnsiteShopping平均付费成本(商店)string50.02Optional平均付费成本(商店)
2.1.24costPerResult平均成效成本string41.68Optional平均成效成本
2.1.25cpccpcstring2.5OptionalCPC,单次点击成本
2.1.26cpmcpmstring125.05OptionalCPM,千次展示成本
2.1.27createTime创建时间string2024-11-01 10:00:00Optional创建时间,格式:yyyy-MM-dd HH:mm:ss
2.1.28creativeType创意素材类型stringCUSTOMIZED_CREATIVEOptional创意素材类型
2.1.29ctr点击率string0.05Optional点击率
2.1.30currency币种stringUSDOptional币种
2.1.31displayTimezone地区&时区(地区中文)stringAsia/ShanghaiOptional地区&时区(地区中文)
2.1.32engagedView播放6秒次数(专注观看)integer750Optional播放6秒次数(专注观看)
2.1.33engagedView15s播放15秒次数(专注观看)integer600Optional播放15秒次数(专注观看)
2.1.34frequency频次integer2Optional频次
2.1.35gmtOffset地区&时区(时区)string+08:00Optional地区&时区(时区)
2.1.36grossImpressions总展示数(包含无效展示)integer10500Optional总展示数(包含无效展示)
2.1.37ididstring7123456789012345678Optionalid,与各层级的维度id如campaignId,adgroupId,adId相同
2.1.38impressions展示量integer10000Optional展示量
2.1.39liveEffectiveViews直播播放10秒次数integer3800Optional直播播放10秒次数
2.1.40liveProductClicks直播商品点击数integer150Optional直播商品点击数
2.1.41liveUniqueViews直播去重播放量integer4500Optional直播去重播放量
2.1.42liveViews直播播放量integer5000Optional直播播放量
2.1.43modifyTime修改时间string2024-11-12 15:30:00Optional修改时间,格式:yyyy-MM-dd HH:mm:ss
2.1.44onsiteInitiateCheckoutCount开始结账数(商店)integer40Optional开始结账数(商店)
2.1.45onsiteInitiateCheckoutCountRate开始结账率(商店)string0.08Optional开始结账率(商店)
2.1.46onsiteOnWebCart加入购物车数(商店)integer80Optional加入购物车数(商店)
2.1.47onsiteOnWebCartRate加入购物车率(商店)string0.16Optional加入购物车率(商店)
2.1.48onsiteOnWebDetail商品页浏览数(商店)integer200Optional商品页浏览数(商店)
2.1.49onsiteOnWebDetailRate商品页浏览率(商店)string0.4Optional商品页浏览率(商店)
2.1.50onsiteShopping付费数(商店)integer25Optional付费数(商店)
2.1.51onsiteShoppingRate付费率(商店)string0.05Optional付费率(商店)
2.1.52onsiteShoppingRoasROAS(商店)string2.5OptionalROAS(商店),广告支出回报率
2.1.53ownerBcId广告主BusinessIdstring123456Optional广告主BusinessId
2.1.54ownerBcName广告主Business名称string测试广告主Optional广告主Business名称
2.1.55reach覆盖人数integer8000Optional覆盖人数
2.1.56realTimeConversion实时转化量integer28Optional实时转化量
2.1.57realTimeConversionRateV2实时转化率(展示)string0.0028Optional实时转化率(展示)
2.1.58realTimeCostPerConversion实时平均转化成本string44.66Optional实时平均转化成本
2.1.59realTimeCostPerResult实时平均成效成本string39.08Optional实时平均成效成本
2.1.60realTimeResult实时成效数integer32Optional实时成效数
2.1.61result成效数integer30Optional成效数
2.1.62resultRate成效率string0.06Optional成效率
2.1.63serviceStatus服务状态stringACTIVEOptional服务状态
2.1.64spend花费string1250.5Optional花费
2.1.65status状态stringSTATUS_ENABLEOptional状态,枚举值:STATUS_ENABLE-已启用, SYSTEM_STATUS_IN_REVIEW-审核中, SYSTEM_STATUS_NOT_PASS-未通过, STATUS_LIMIT-惩罚中, STATUS_DISABLE-已关户
2.1.66totalOnsiteInitiateCheckoutCountValue开始结账价值(商店)string3125.6Optional开始结账价值(商店)
2.1.67totalOnsiteOnWebCartValue加入购物车价值(商店)string3125.6Optional加入购物车价值(商店)
2.1.68totalOnsiteOnWebDetailValue商品页浏览价值(商店)string3125Optional商品页浏览价值(商店)
2.1.69totalOnsiteShoppingValue总收入(商店)string3125.5Optional总收入(商店)
2.1.70valuePerOnsiteInitiateCheckoutCount开始结账平均价值(商店)string78.14Optional开始结账平均价值(商店)
2.1.71valuePerOnsiteOnWebCart加入购物车平均价值(商店)string39.07Optional加入购物车平均价值(商店)
2.1.72valuePerOnsiteOnWebDetail商品页浏览平均价值(商店)string15.63Optional商品页浏览平均价值(商店)
2.1.73valuePerOnsiteShopping平均订单价值(商店)string125.02Optional平均订单价值(商店)
2.1.74videoCompletionRate完播率string0.35Optional完播率
2.1.75videoId视频Idstringv1234567890Optional视频Id
2.1.76videoPlayActions视频播放量integer1200Optional视频播放量
2.1.77videoType视频类型stringUSER_GENERATEOptional视频类型
2.1.78videoViews2sRate2s完播率string0.83Optional2s完播率
2.1.79videoViews6sRate6s完播率string0.67Optional6s完播率
2.1.80videoViewsP100播放完成次数integer420Optional播放完成次数
2.1.81videoViewsP25播放25%次数integer900Optional播放25%次数
2.1.82videoViewsP25Rate播放25%占比string0.75Optional播放25%占比
2.1.83videoViewsP50播放50%次数integer700Optional播放50%次数
2.1.84videoViewsP50Rate播放50%占比string0.58Optional播放50%占比
2.1.85videoViewsP75播放75%次数integer500Optional播放75%次数
2.1.86videoViewsP75Rate播放75%占比string0.42Optional播放75%占比
2.1.87videoWatched2s视频播放2秒次数integer1000Optional视频播放2秒次数
2.1.88videoWatched6s视频播放6秒次数integer800Optional视频播放6秒次数
2.2total总记录数integer100Required总记录数
3error_details错误详情array<any>—Required错误详情
4message提示信息string—Required提示信息
5request_id请求idstring—Required请求id
6response_time响应时间string—Required响应时间
7total总记录数integer—Required总记录数

The 查询TikTok - 推广广告 - 广告 API (/basicOpen/multiplatform/ads/queryTiktokAdList) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.