Actions11
Overview
This node integrates with TikTok's API to retrieve analytics data for videos. Specifically, the "Get Analytics" operation fetches various performance metrics for a single video, such as views, likes, comments, shares, watch time, engagement rate, and retention rate.
Use cases include monitoring how well a TikTok video is performing, analyzing audience engagement, and making data-driven decisions to optimize content strategy. For example, marketers can track which videos generate the most shares or have the highest retention rates to tailor future campaigns.
Properties
| Name | Meaning |
|---|---|
| Metrics | The specific video performance metrics to retrieve. Options: Comments, Engagement Rate, Likes, Retention Rate, Shares, Views, Watch Time |
Output
The node outputs JSON data containing the requested analytics metrics for the specified video. The structure includes a data field with metric values corresponding to the selected metrics. Each output item corresponds to one input item, enriched with the analytics data.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for authenticating with the TikTok API.
- The node makes HTTP requests to TikTok's official open API endpoints.
- Proper configuration of the TikTok API credentials in n8n is necessary.
Troubleshooting
- Rate Limit Errors: If the node returns errors about rate limits being exceeded, wait for the specified cooldown period before retrying. The node implements automatic retries with exponential backoff but will fail after maximum retries.
- Invalid Video ID: Providing an incorrect or non-existent video ID will cause the API to return an error. Verify that the video ID is correct.
- Empty Metrics Selection: If no metrics are selected, the response may be empty or incomplete. Always select at least one metric to retrieve meaningful data.
- Network Issues: Network connectivity problems can cause request failures. Ensure stable internet access.
- API Changes: If TikTok changes their API, some fields or endpoints might become deprecated, causing errors.
Links and References
- TikTok Open API Documentation
- TikTok Video Analytics API Reference (hypothetical link based on typical docs)
This summary is based solely on static analysis of the provided source code and property definitions.