Actions46
- Videos Actions
- Users Actions
- Hashtags Actions
- Music Actions
- Analytics Actions
- Marketing/Ads Actions
- Business Actions
- Creator Actions
- Commerce/Shopping Actions
Analytics → Get Video Analytics
AI-generatedOverview
The node provides enhanced integration with TikTok's API via the N8N Tools service, enabling access to a wide range of TikTok data and actions. Specifically, for the Analytics > Get Video Analytics operation, it retrieves detailed analytics data for a specified TikTok video over a defined date range.
This node is beneficial for social media managers, marketers, and content creators who want to monitor the performance of their TikTok videos directly within automated workflows. For example, you can track engagement metrics such as views, likes, shares, and comments on a video between two dates to evaluate its success or optimize future content strategies.
Properties
| Name | Meaning |
|---|---|
| Video ID | The unique identifier of the TikTok video for which analytics are requested. |
| Start Date | The start date (inclusive) for the analytics data in YYYY-MM-DD format. |
| End Date | The end date (inclusive) for the analytics data in YYYY-MM-DD format. |
Output
- The output JSON contains the analytics data returned by the TikTok API for the specified video and date range.
- This typically includes various performance metrics such as view counts, engagement rates, audience demographics, and other relevant statistics depending on TikTok's analytics API response.
- The output is structured as an array of JSON objects, each representing the analytics data for the input item.
- No binary data output is produced by this operation.
Dependencies
- Requires valid credentials for the N8N Tools API service, including an API key credential.
- The node internally uses a TikTok API wrapper class that communicates through the N8N Tools API endpoint.
- Proper configuration of these credentials in n8n is necessary for successful execution.
- The node performs an initial validation request to the N8N Tools API to verify subscription and API key validity before proceeding.
Troubleshooting
- Invalid Subscription or API Key: If the node throws an error indicating invalid subscription or API key, verify that your API key credential is correctly configured and active.
- Date Format Issues: Ensure that the Start Date and End Date inputs are provided in the correct YYYY-MM-DD format; otherwise, the TikTok API may reject the request.
- API Rate Limits: Frequent requests might hit rate limits imposed by the TikTok API or the N8N Tools API service, resulting in errors or throttling.
- Network or Service Errors: Temporary network issues or service downtime can cause failures; retrying after some time may resolve these.
- Continue On Fail Behavior: If enabled, the node will continue processing subsequent items even if one fails, returning error details in the output.
Links and References
- TikTok for Developers - Analytics API
- N8N Documentation - Creating Custom Nodes
- N8N Tools API Service (general reference for the external API used)