AdspirerInstall

Summary

Retrieve TikTok Ads audience insights based on specified parameters such as advertiser ID, date range, breakdown type, and data detail preferences.

Inputs

• Platform (required) — Select 'TikTok Ads' to fetch TikTok audience insights.
• Advertiser Id (required) — TikTok advertiser ID to specify which advertiser's audience insights to retrieve.
• Breakdown Type — Specify the breakdown for audience insights: age, gender, age_gender, or all (default).
• Start Date — Start date for the data range in YYYY-MM-DD format.
• End Date — End date for the data range in YYYY-MM-DD format.
• Lookback Days — Number of days to analyze; if specified, overrides date range.
• Include Saturation — Boolean to include saturation trend analysis in the result (default true).
• Raw Data — If true, returns only raw metrics as a JSON code block without additional labels or recommendations.

Output shape

a JSON object containing TikTok audience insights data per the specified parameters

The returned data structure includes audience metrics possibly with saturation trends, severity labels, suggested bids/budgets, industry benchmarks, and optimization recommendations unless 'Raw Data' is true, in which case only raw metrics JSON is returned. Date parameters are optional but recommended to define the analysis period. If 'Lookback Days' is provided, it overrides the start/end dates.

Examples

Example 1: Fetch audience insights for a TikTok advertiser with ID 123456 for the last 30 days with gender and age breakdown.

Set Platform to TikTok Ads, Advertiser Id to '123456', Lookback Days to '30', Breakdown Type to 'age_gender', include saturation analysis, and Raw Data to false.

Links

• n8n community nodes installation guide