TikTok Report Query
tiktok_report_queryFree-form READ of TikTok's integrated report endpoint (/report/integrated/get/) — any metric and dimension TikTok supports. report_type: BASIC (performance) | AUDIENCE (age, gender, country_code, province_id, platform, placement...) | PLAYABLE_MATERIAL | CATALOG | BC | TT_SHOP. data_level: AUCTION_ADVERTISER | AUCTION_CAMPAIGN | AUCTION_ADGROUP | AUCTION_AD. dimensions: e.g. ['campaign_id'], ['adgroup_id','stat_time_day'], ['ad_id','gender']. metrics: e.g. spend, impressions, clicks, ctr, cpc, cpm, reach, frequency, conversion, cost_per_conversion, result, cost_per_result, video_play_actions, video_watched_6s, average_video_play, likes, comments, shares, follows, profile_visits. lifetime=true returns totals since the start of each object (no date range). Otherwise days = last N full days excluding today, or start_date/end_date (YYYY-MM-DD); TikTok limits the range (with stat_time_day it is 30 days) and rejects longer ranges with an explanatory error. filtering: TikTok filter objects, e.g. [{"field_name": "campaign_ids", "filter_type": "IN", "filter_value": "["123"]"}]. Reference: https://business-api.tiktok.com/portal/docs?id=1740302848100353. Read-only; reply carries the exact period or lifetime=true.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | ||
| limit | No | ||
| metrics | Yes | ||
| end_date | No | ||
| lifetime | No | ||
| filtering | No | ||
| data_level | No | AUCTION_CAMPAIGN | |
| dimensions | Yes | ||
| start_date | No | ||
| report_type | No | BASIC | |
| advertiser_id | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||