Actions11
Overview
The node integrates with TikTok's API to retrieve historical analytics data for videos. It allows users to specify a date range, select which metrics to retrieve, and define the aggregation interval (daily, weekly, or monthly). This is useful for marketers, content creators, and analysts who want to track video performance trends over time on TikTok.
Practical examples include:
- Monitoring how views, likes, shares, and comments evolve daily or weekly.
- Analyzing watch time and retention rates to optimize video content.
- Aggregating engagement metrics over a month to assess overall campaign success.
Properties
| Name | Meaning |
|---|---|
| Start Date | The start date for the analytics data to retrieve. |
| End Date | The end date for the analytics data to retrieve. |
| Metrics | The specific video metrics to retrieve. Options: Comments, Engagement Rate, Likes, Retention Rate, Shares, Views, Watch Time. |
| Interval | The time interval for data aggregation. Options: Daily, Weekly, Monthly. |
Output
The node outputs JSON data containing the requested historical analytics metrics aggregated over the specified interval within the given date range. Each output item corresponds to a data point for a particular time period and metric.
The structure typically includes fields such as:
- The metric name (e.g., views, likes).
- The value of the metric for the time interval.
- The timestamp or date representing the interval.
No binary data output is produced by this operation.
Dependencies
- Requires an active TikTok API authentication token configured in n8n credentials.
- Uses TikTok's official open API endpoints for video analytics.
- Relies on network connectivity to TikTok's API servers.
- Handles rate limiting internally with automatic retries and backoff.
Troubleshooting
- Rate Limit Errors: If you encounter errors about rate limits, the node automatically retries with exponential backoff. However, if limits are exceeded repeatedly, wait before retrying or reduce request frequency.
- Invalid Date Range: Ensure that the start date is before the end date; otherwise, the API may return errors or empty results.
- Empty Metrics Selection: Selecting no metrics will result in no data returned. Always choose at least one metric.
- API Authentication Failures: Verify that the TikTok API credential is valid and has necessary permissions.
- Network Issues: Network failures or invalid responses from TikTok API will cause errors. Check your internet connection and TikTok service status.
Links and References
- TikTok Open API Documentation
- TikTok Video Analytics API Reference (hypothetical link based on context)