TikTok Report Query

Free-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: a list such as ['campaign_id'], ['adgroup_id','stat_time_day'], ['ad_id','gender']. metrics: 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 (30 days with stat_time_day) and rejects longer ranges with an explanatory error. filtering: TikTok filter objects with field_name, filter_type and filter_value. Reference: https://business-api.tiktok.com/portal/docs?id=1740302848100353. Read-only; reply carries the exact `period` or lifetime=true. limit controls the response page; page_token=next_page_token returns later pages without another API call or credit.