查询TikTok - 推广广告 - 广告帐号
POST
/basicOpen/multiplatform/ads/queryAdvertiserList接口信息
| API Path | 请求协议 | 请求方式 | 令牌桶容量 |
|---|---|---|---|
/basicOpen/multiplatform/ads/queryAdvertiserList | HTTPS | POST | 1 |
请求参数
endDatestringlengthintegerpageintegerstartDatestringadvertiserIdsarray<any>advertiserTypearray<any>bidStrategiesarray<any>budgetTypesarray<any>currenciesarray<any>displayTimezonesarray<any>orderFieldstringorderTypestringownerBcIdsarray<any>searchTypestringsearchValuearray<any>serviceStatusarray<any>statusarray<any>summaryCurrencystring请求cURL示例
curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/ads/queryAdvertiserList?access_token=value×tamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
"endDate": "2024-11-12",
"length": 20,
"page": 1,
"startDate": "2024-11-01",
"advertiserIds": [123456789012345],
"advertiserType": [],
"bidStrategies": [],
"budgetTypes": [],
"currencies": ["USD","CNY"],
"displayTimezones": ["America\/New_York"],
"orderField": "spend",
"orderType": "DESC",
"ownerBcIds": [],
"searchType": "advertiser_name",
"searchValue": [],
"serviceStatus": [],
"status": ["STATUS_ENABLE","STATUS_DISABLE"],
"summaryCurrency": "CNY"
}'返回结果
Json Object
codeinteger必填dataobject必填隐藏子属性
listarray<object>隐藏子属性
advertiserIdstringadvertiserNamestringaverageVideoPlaynumberaverageVideoPlayCountintegeraverageVideoPlayPerUsernumberaverageVideoPlayPerUserCountintegeraverageVideoPlayPerUserSumnumberaverageVideoPlaySumnumberbalancenumberbasicCnyRateMissingCountintegerbilledCostnumbercashSpendnumberclicksintegercnyBalancenumbercnyBilledCostnumbercnyCashSpendnumbercnyCostPerOnsiteInitiateCheckoutCountnumbercnyCostPerOnsiteInitiateCheckoutCountCountintegercnyCostPerOnsiteInitiateCheckoutCountSumnumbercnyCostPerOnsiteOnWebCartnumbercnyCostPerOnsiteOnWebCartCountintegercnyCostPerOnsiteOnWebCartSumnumbercnyCostPerOnsiteOnWebDetailnumbercnyCostPerOnsiteOnWebDetailCountintegercnyCostPerOnsiteOnWebDetailSumnumbercnyCostPerOnsiteShoppingnumbercnyCostPerOnsiteShoppingCountintegercnyCostPerOnsiteShoppingSumnumbercnySpendnumbercnyTotalOnsiteShoppingValuenumbercompanyIdstringconversionintegerconversionRatenumbercostPer1000ReachednumbercostPerConversionnumbercostPerOnsiteInitiateCheckoutCountnumbercostPerOnsiteOnWebCartnumbercostPerOnsiteOnWebDetailnumbercostPerOnsiteShoppingnumbercostPerResultnumbercountrystringcpcnumbercpmnumberctrnumbercurrencystringdisplayTimezonestringengagedViewintegerengagedView15sintegerfrequencyintegergmtOffsetstringgrossImpressionsintegeridstringimpressionsintegerliveEffectiveViewsintegerliveProductClicksintegerliveUniqueViewsintegerliveViewsintegermetricsCnyRateMissingCountintegeronsiteInitiateCheckoutCountintegeronsiteInitiateCheckoutCountRatenumberonsiteInitiateCheckoutCountRateCountintegeronsiteInitiateCheckoutCountRateSumnumberonsiteOnWebCartintegeronsiteOnWebCartRatenumberonsiteOnWebCartRateCountintegeronsiteOnWebCartRateSumnumberonsiteOnWebDetailintegeronsiteOnWebDetailRatenumberonsiteOnWebDetailRateCountintegeronsiteOnWebDetailRateSumnumberonsiteShoppingintegeronsiteShoppingRatenumberonsiteShoppingRateCountintegeronsiteShoppingRateSumnumberonsiteShoppingRoasnumberonsiteShoppingRoasCountintegeronsiteShoppingRoasSumnumberownerBcIdstringownerBcNamestringreachintegerrealTimeConversionintegerrealTimeConversionRateV2numberrealTimeCostPerConversionnumberrealTimeCostPerResultnumberrealTimeResultintegerreportDatestringreportUpdateTimestringresultintegerresultRatenumberserviceStatusstringspendnumberstatusstringtotalOnsiteInitiateCheckoutCountValuenumbertotalOnsiteOnWebCartValuenumbertotalOnsiteOnWebDetailValuenumbertotalOnsiteShoppingValuenumbervaluePerOnsiteInitiateCheckoutCountnumbervaluePerOnsiteInitiateCheckoutCountCountintegervaluePerOnsiteInitiateCheckoutCountSumnumbervaluePerOnsiteOnWebCartnumbervaluePerOnsiteOnWebCartCountintegervaluePerOnsiteOnWebCartSumnumbervaluePerOnsiteOnWebDetailnumbervaluePerOnsiteOnWebDetailCountintegervaluePerOnsiteOnWebDetailSumnumbervaluePerOnsiteShoppingnumbervaluePerOnsiteShoppingCountintegervaluePerOnsiteShoppingSumnumbervideoCompletionRatenumbervideoPlayActionsintegervideoViews2sRatenumbervideoViews6sRatenumbervideoViewsP100integervideoViewsP25integervideoViewsP25RatenumbervideoViewsP50integervideoViewsP50RatenumbervideoViewsP75integervideoViewsP75RatenumbervideoWatched2sintegervideoWatched6sintegertotalintegererror_detailsarray<any>必填messagestring必填request_idstring必填response_timestring必填totalinteger必填返回成功示例
{
"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
}