AdspirerInstall

Summary

Retrieve TikTok ad performance metrics using specified advertiser ID, date range, pagination, and data preferences.

Inputs

• advertiser_id (required) — TikTok advertiser ID to fetch performance data for.
• start_date — Start date for performance data in YYYY-MM-DD format.
• end_date — End date for performance data in YYYY-MM-DD format.
• limit — Maximum number of ads to return (1-50). Leave blank to omit.
• offset — Pagination offset as a numeric value. Leave blank to omit.
• lookback_days — Number of days to analyze. Numeric. Leave blank to omit.
• raw_data — Boolean flag to return only raw metrics as JSON without additional labels or recommendations.

Output shape

JSON object containing TikTok ad performance data, including metrics for ads within the specified parameters.

Output includes performance metrics filtered by advertiser ID and date range. If 'raw_data' is true, the response excludes severity labels, benchmarks, and optimization suggestions. Supports pagination via limit and offset parameters.

Examples

Example 1: Fetch last 30 days of performance for a TikTok advertiser, returning up to 30 ads with enriched analytics.

Set 'advertiser_id' to the TikTok account, 'lookback_days' to 30, 'limit' to 30, and 'raw_data' to false.

Links

• n8n community nodes installation guide