Adspirer icon

Adspirer

Manage ad campaigns across Google, Meta, LinkedIn & TikTok Ads via the Adspirer REST API

Actions119

Get Tiktok Campaign Performance

AI-generated

Summary

Retrieve TikTok Ads campaign performance metrics by specifying the advertiser ID and date range, optionally including optimization recommendations and formatted raw metric data.

Inputs

  • Platform (required) — Must be set to 'TikTok Ads' to use this operation.
  • Advertiser Id (required) — TikTok advertiser ID to identify which account's campaign performance to retrieve.
  • Start Date — Start date in YYYY-MM-DD format to define the performance data period (overrides lookback_days if set).
  • End Date — End date in YYYY-MM-DD format to define the performance data period (overrides lookback_days if set).
  • Lookback Days — Number of days to look back from today for performance data (choose 7, 14, 30, 60, or 90); ignored if start/end dates are provided.
  • Include Recommendations — Boolean to include optimization recommendations in the response. Defaults to true.
  • Raw Data — Boolean to return only raw JSON metrics without labels, bids, benchmarks, or recommendations. Defaults to false.

Output shape

a JSON object containing TikTok campaign performance metrics, with optional optimization recommendations or raw data depending on inputs.

If 'Raw Data' is true, the output is strictly raw metrics JSON; otherwise, includes additional contextual information like severity labels and suggested optimizations.

Links

Discussion