查询TikTok - 推广广告 - 广告
POST
/basicOpen/multiplatform/ads/queryTiktokAdList接口信息
| API Path | 请求协议 | 请求方式 | 令牌桶容量 |
|---|---|---|---|
/basicOpen/multiplatform/ads/queryTiktokAdList | HTTPS | POST | 1 |
请求参数
endDatestringlengthintegerpageintegerstartDatestringadIdsarray<any>adStylesarray<any>adgroupIdsarray<any>advertiserIdsarray<any>bidStrategiesarray<any>budgetTypesarray<any>campaignIdsarray<any>creativeMaterialTypesarray<any>currenciesarray<any>orderFieldstringorderTypestringownerBcIdsarray<any>searchTypestringsearchValuearray<any>serviceStatusarray<any>statusarray<any>summaryCurrencystringvideoTypesarray<any>请求cURL示例
curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/ads/queryTiktokAdList?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",
"adIds": ["1111111111"],
"adStyles": ["VIDEO_AD"],
"adgroupIds": ["9876543210"],
"advertiserIds": ["123456789012345"],
"bidStrategies": ["LOWEST_COST"],
"budgetTypes": ["DAILY"],
"campaignIds": ["1234567890"],
"creativeMaterialTypes": ["CUSTOMIZED_CREATIVE"],
"currencies": ["USD","CNY"],
"orderField": "spend",
"orderType": "DESC",
"ownerBcIds": ["123456"],
"searchType": "ad_name",
"searchValue": ["\u6d4b\u8bd5\u5e7f\u544a"],
"serviceStatus": ["ACTIVE"],
"status": ["STATUS_ENABLE","SYSTEM_STATUS_IN_REVIEW"],
"summaryCurrency": "CNY",
"videoTypes": ["USER_GENERATE"]
}'返回结果
Json Object
codeinteger必填dataobject必填隐藏子属性
listarray<object>必填隐藏子属性
adFormatstringadGroupIdstringadGroupNamestringadIdstringadNamestringadvertiserIdstringadvertiserNamestringaverageVideoPlaystringaverageVideoPlayPerUserstringbilledCoststringcampaignIdstringcampaignNamestringcashSpendstringclicksintegercompanyIdstringconversionintegerconversionRatestringcostPer1000ReachedstringcostPerConversionstringcostPerOnsiteInitiateCheckoutCountstringcostPerOnsiteOnWebCartstringcostPerOnsiteOnWebDetailstringcostPerOnsiteShoppingstringcostPerResultstringcpcstringcpmstringcreateTimestringcreativeTypestringctrstringcurrencystringdisplayTimezonestringengagedViewintegerengagedView15sintegerfrequencyintegergmtOffsetstringgrossImpressionsintegeridstringimpressionsintegerliveEffectiveViewsintegerliveProductClicksintegerliveUniqueViewsintegerliveViewsintegermodifyTimestringonsiteInitiateCheckoutCountintegeronsiteInitiateCheckoutCountRatestringonsiteOnWebCartintegeronsiteOnWebCartRatestringonsiteOnWebDetailintegeronsiteOnWebDetailRatestringonsiteShoppingintegeronsiteShoppingRatestringonsiteShoppingRoasstringownerBcIdstringownerBcNamestringreachintegerrealTimeConversionintegerrealTimeConversionRateV2stringrealTimeCostPerConversionstringrealTimeCostPerResultstringrealTimeResultintegerresultintegerresultRatestringserviceStatusstringspendstringstatusstringtotalOnsiteInitiateCheckoutCountValuestringtotalOnsiteOnWebCartValuestringtotalOnsiteOnWebDetailValuestringtotalOnsiteShoppingValuestringvaluePerOnsiteInitiateCheckoutCountstringvaluePerOnsiteOnWebCartstringvaluePerOnsiteOnWebDetailstringvaluePerOnsiteShoppingstringvideoCompletionRatestringvideoIdstringvideoPlayActionsintegervideoTypestringvideoViews2sRatestringvideoViews6sRatestringvideoViewsP100integervideoViewsP25integervideoViewsP25RatestringvideoViewsP50integervideoViewsP50RatestringvideoViewsP75integervideoViewsP75RatestringvideoWatched2sintegervideoWatched6sintegertotalinteger必填error_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
}