TikTok Reports
AdvertisingPull TikTok ad performance data with AI agents. Agents run integrated reports grouped by campaign, ad group, ad, or time, fetch spend, impressions, clicks, and conversions synchronously, or start async report tasks for large date ranges and poll for the finished file.
What This Integration Enables
Paid social reporting fails in a specific way: the channels that automate their exports get watched daily, and the ones that require a login get watched when something already looks wrong. This connector puts TikTok in the first group. FlowRunner agents run integrated reports against the configured advertiser at whatever grain the question needs, advertiser, campaign, ad group, or ad level, grouped by entity or time dimensions, returning the metrics that matter: spend, impressions, clicks, conversions, CTR, CPC. - Pull synchronous, paginated reports for daily and weekly monitoring - Choose report type and data level per pull, from advertiser rollups down to individual ads - Run large historical exports asynchronously and poll for the finished file - Feed TikTok delivery data into cross-channel reports beside Google and Meta numbers - Check thresholds on every pull and alert a person the moment a metric crosses one This is a read-only window into ad performance. The decisions it informs, budget shifts, pauses, creative rotations, are exactly where FlowRunner routes through [human-in-the-loop](/concepts/human-in-the-loop) review, because the report should be automated and the reaction to it should not.
Without FlowRunner
With FlowRunner
Use Case Scenarios
The cross-channel morning report
Each morning the agent calls Get Report for campaign-level spend and conversions, a parallel branch pulls the same window from [Google Ads](/integrations/google-ads), and both land in one [Google Sheets](/integrations/google-sheets) tab with normalized columns. The [Slack](/integrations/slack) digest ranks yesterday's movers across networks. TikTok stops being the channel whose numbers are always a day behind the conversation.
Threshold alerts with a human on the trigger
On an hourly cadence, Get Report pulls advertiser-level spend for the current day. When spend pace or CPC crosses the configured threshold, the agent posts the numbers, the trailing baseline, and the offending campaigns to the paid social manager. The manager decides whether to intervene in Ads Manager. The agent's job ends at accurate, early escalation; the budget call carries a human's name.
The quarter-long lookback that runs itself
For a quarterly review, the agent calls Create Report Task for ad-level data across the full 90-day range, then polls Check Report Task until the status is SUCCESS and a download URL appears. The file lands in the data warehouse staging area and the analyst gets a notification that the export is ready. Nobody babysits a QUEUING status screen, and the temporary URL gets collected before it expires.
Human-in-Loop Highlight
Check Report Task returns a temporary download URL once an async task hits SUCCESS, and a report generated over a 90-day ad-level range is not something anyone wants to regenerate because the link lapsed over a weekend. The agent owns that collection deadline end to end: poll, detect the terminal status, fetch the file, deliver it. The human's seat in this connector's workflows is the escalation on the numbers themselves. When the hourly pull shows a campaign spending at twice its usual pace with conversions flat, the agent does not have a lever to pull, by design, and it should not. It assembles the evidence and pages the paid social manager, who makes the spend decision inside the ad platform with full context already in hand. Reporting runs at machine speed; spending decisions stay human.
Agent Capabilities
3 actionsReports
3- Get Report Fetches a synchronous integrated ads report for the configured advertiser. Group by one or more dimensions such as campaign_id, adgroup_id, ad_id, or stat_time_day, and request metrics like spend, impressions, clicks, conversion, ctr, and cpc. Supports report type and data level selection with paginated inline results. The workhorse for daily and weekly pulls.
- Create Report Task Creates an asynchronous report task and returns a task_id, configured with the same report type, data level, dimensions, metrics, and date range as a synchronous report. The right path for large date ranges and high-volume exports that would be too slow inline.
- Check Report Task Checks an async task by task_id and returns its status: QUEUING, PROCESSING, SUCCESS, or FAILED, plus a temporary download URL once the task completes. Polled until terminal, with the file collected promptly.
Frequently Asked Questions
What can FlowRunner do with TikTok Reports?
FlowRunner agents can run Get Report, Create Report Task, and Check Report Task in TikTok Reports.
Does connecting TikTok Reports to FlowRunner require OAuth?
No. TikTok Reports connects to FlowRunner with an API key, no OAuth flow required.
Can TikTok Reports trigger a FlowRunner workflow automatically?
TikTok Reports doesn't currently expose triggers in FlowRunner. It connects as an action step inside workflows started by another trigger.
Start building with TikTok Reports
$100 in credits. No card required. Connect in minutes.