The Get Report node lets you fetch TikTok Ads performance data across one or more accounts using specified metrics, dimensions, and filters. This is an AI-powered node that can understand natural language instructions.

​
When to Use It

Use this node to:
  • Generate automated performance reports and dashboards
  • Track campaign metrics and KPIs over time
  • Create data-driven insights for optimization decisions
  • Export data for further analysis in external tools

​
Inputs

FieldTypeRequiredDescription
AccountsDynamic multi-selectYesSelect one or more TikTok Ads accounts to query
Date RangeDate range pickerYesSelect date range for the report
MetricsMulti-selectYesSelect metrics to include in the report
DimensionsMulti-selectNoSelect dimensions to segment your data
FiltersRule-based filtersNoAdd filters to refine your data
Order BySort configurationNoSet the order of results
LimitNumberNoMaximum number of rows to return
OptionsReport optionsNoAdditional options for the report

​
Filters

Filters allow you to refine your data by applying conditions to specific dimensions or metrics. Multiple filters use AND logic - all conditions must be met for a row to be included in the results.

​
Available Filter Operators

OperatorDescriptionExample Use Case
EQUALSExact matchCampaign name equals “Summer Sale 2024”
NOT_EQUALSDoes not match exactlyCampaign status not equals “PAUSED”
CONTAINSContains substringCampaign name contains “2024”
NOT_CONTAINSDoes not contain substringCampaign name doesn’t contain “test”
IN_LISTMatches any value in listPlacement in [“TikTok”, “Pangle”]
NOT_IN_LISTDoesn’t match any value in listDevice not in [“DESKTOP”]
REGEXP_MATCHMatches regular expressionCampaign name matches ”.(viral|trending).”
NOT_REGEXP_MATCHDoesn’t match regexCampaign name doesn’t match “test.*“
GREATER_THANNumeric greater thanSpend > 100
LESS_THANNumeric less thanCPC < 1.50
IS_NULLField has no valueConversion value is null
IS_NOT_NULLField has a valueConversion value is not null

​
Filter Examples

Example 1: High-performing active campaigns 
- Spend > 50 (GREATER_THAN)
- Campaign status = "ENABLE" (EQUALS)
- Impressions > 10000 (GREATER_THAN)
Example 2: Video content campaigns using regex (OR logic) 
- Campaign name matches ".*(video|viral|content).*" (REGEXP_MATCH)
Example 3: Exclude test campaigns 
- Campaign name does not contain "test" (NOT_CONTAINS)
- Campaign name does not contain "draft" (NOT_CONTAINS)

​
OR Logic with Filters

Since multiple filters use AND logic, use these approaches for OR conditions:
  1. IN_LIST operator: Placement IN ["TikTok", "Pangle", "Global_App_Bundle"]
  2. REGEXP_MATCH operator: Campaign name REGEXP_MATCH ".*(video|viral|content).*"
  3. Run separate queries: Create different workflows for different conditions

​
Options Reference

These optional settings let you format the output from TikTok Ads before passing it to other nodes.
OptionDescription
Pretty Column NamesConverts column headers to Title Case (e.g. campaignName becomes Campaign Name)
Add Percent Sign to RatiosAppends % to ratio metrics like CTR or Engagement Rate
Display Currency SymbolAdds $ or local currency symbol to monetary metrics
Compact NumbersConverts large numbers to short format (e.g. 10K instead of 10,000)
Pivot Dimensions as ColumnsTransforms dimension values into separate columns for easier comparison

​
Output

The node returns a structured dataset with performance metrics and dimensions. The exact format depends on your configuration and the data returned from TikTok Ads. Typical Output Structure:
  • Data Rows: Performance metrics and dimensions
  • Metadata: Account information, date ranges, and query details
  • Summary Statistics: Total records, data freshness, execution time
Can be passed to:
  • AI nodes like Analyze Data or Structured Output
  • Export nodes (e.g., Google Sheets)
  • Email or Slides nodes

​
Credit Cost

  • Cost per run: 1 credit per account

​
Example Setup

Scheduler (Daily 8 AM) →
Get Report →
AI Analysis →
Google Slides Report →
Slack Notification
Configuration Example:
  • Date Range: Last 7 days
  • Metrics: Impressions, Clicks, Cost, Conversions
  • Dimensions: Campaign Name, Date
  • Filters: Impressions > 0 (only active campaigns)
  • Limit: 1000 rows

​
FAQs