Sample

 

https://connectors.windsor.ai/tiktok?api_key=[your API key]&date_preset=last_7d&fields=campaign,clicks,spend,impressions,date,source&_renderer=csv


Fields

IDTypeNameDescription
acTEXTACGroup by network
account_idTEXTAccount IDThe TikTok Ads account ID
account_nameTEXTAccount NameThe TikTok Ads account name
ad_idTEXTAd IDAd ID
ad_nameTEXTAd NameAd Name
ageTEXTAge RangeThe Age Range of the Audience
average_video_playNUMERICVideo Average Watch Time Per Video ViewThe average time your video was played per single video view, including any time spent replaying the video.
average_video_play_per_userNUMERICVideo Average Watch Time Per PersonThe average time your video was played per person, including any time spent replaying the video. This metric is estimated.
campaignTEXTCampaignThe Campaign Name
clicksNUMERICClicksThe Number of Clicks
countryTEXTCountryThe Country of the Audience
dateDATEDateThe Date
genderTEXTgenderThe Gender of the Audience
impressionsNUMERICImpressionsThe Number of Impressions
interest_categoryTEXTInterest CategoryThe Interest Category of the Audience
languageTEXTLanguageThe Language of the Audience
placementTEXTPlacementThe Placement Name
platformTEXTPlatformThe Operating System of the Audience
play_duration_2sNUMERIC2-Second Video ViewsThe number of times your video played for at least 2 seconds. Replays will not be counted.
play_duration_6sNUMERIC6-Second Video ViewsThe number of times your video played for at least 6 seconds, or completely played. Replays will not be counted.
play_first_quartileNUMERICVideo Views at 25%The number of times your video was played at 25% of its length. Replays will not be counted.
play_overNUMERICVideo Views at 100%The number of times your video was played at 100% of its length. Replays will not be counted.
play_third_quartileNUMERICVideo Views at 75%The number of times your video was played at 75% of its length. Replays will not be counted.
spendNUMERICspendThe Media Spend
total_playNUMERICVideo ViewsThe number of times your video starts to play. Replays will not be counted.
totalcostNUMERICTotal CostThe Media Spend (Duplicate)