Actions11
Overview
The node integrates with TikTok's API to retrieve engagement analytics data for videos. Specifically, the "Get Engagement Analytics" operation fetches metrics related to how users interact with a video, such as likes, comments, shares, and other engagement indicators over a specified date range.
This node is beneficial for social media managers, marketers, or content creators who want to analyze the performance of their TikTok videos in terms of audience engagement. For example, it can be used to track how engagement changes over time after posting a video or to compare engagement across different videos.
Properties
| Name | Meaning |
|---|---|
| Start Date | The start date for the analytics data period to retrieve engagement metrics from TikTok. |
| End Date | The end date for the analytics data period to retrieve engagement metrics from TikTok. |
Output
The output JSON contains the engagement analytics data returned by TikTok's API for the specified video(s) and date range. This typically includes various engagement metrics such as:
- Likes
- Comments
- Shares
- Views
- Watch Time
- Engagement Rate
- Retention Rate
The exact structure depends on TikTok's response but generally consists of an array of objects where each object represents engagement data points for the video within the requested timeframe.
No binary data output is produced by this operation.
Dependencies
- Requires an active TikTok API authentication token (API key credential) configured in n8n.
- Uses TikTok's official open API endpoints for video analytics.
- Relies on network connectivity to TikTok's API servers.
- The node handles rate limiting internally and retries requests with exponential backoff if rate limits are hit.
Troubleshooting
- Rate Limit Exceeded: If too many requests are made in a short period, the node will throw a rate limit error advising to wait before retrying. Solution: Reduce request frequency or wait for the cooldown period.
- Invalid Date Range: Providing invalid or missing start/end dates may cause errors or empty results. Ensure valid ISO date strings are used.
- API Authentication Errors: Missing or expired API tokens will cause authentication failures. Verify that the TikTok API credentials are correctly set up and valid.
- Network Issues: Connectivity problems can lead to network errors. Check internet connection and TikTok API availability.
- Unexpected API Responses: If TikTok returns an unexpected response, the node throws an error indicating an invalid response. This might require checking TikTok API status or updating the node if API changes occur.