Actions46
- Videos Actions
- Users Actions
- Hashtags Actions
- Music Actions
- Analytics Actions
- Marketing/Ads Actions
- Business Actions
- Creator Actions
- Commerce/Shopping Actions
Videos → Get Video Analytics
AI-generatedOverview
This node operation fetches detailed analytics data for a specific TikTok video within a given date range. It is useful for marketers, content creators, and social media analysts who want to track the performance of their TikTok videos over time. By retrieving metrics such as views, likes, shares, and other engagement statistics, users can evaluate the effectiveness of their video content and optimize future posts.
Practical examples:
- A social media manager wants to analyze how a promotional video performed during a campaign period.
- A content creator tracks engagement trends on a viral video to understand audience interaction.
- An analyst compares video analytics across different time frames to identify peak activity periods.
Properties
| Name | Meaning |
|---|---|
| Video ID | The unique identifier of the TikTok video for which analytics are requested. |
| Start Date | The start date (YYYY-MM-DD) defining the beginning of the analytics reporting period. |
| End Date | The end date (YYYY-MM-DD) defining the end of the analytics reporting period. |
Output
The node outputs JSON data containing the analytics information for the specified video and date range. This typically includes various performance metrics such as:
- Number of views
- Likes count
- Shares count
- Comments count
- Other engagement or reach statistics provided by TikTok's analytics API
The exact structure depends on TikTok's API response but generally provides comprehensive insights into video performance.
No binary data output is involved in this operation.
Dependencies
- Requires an active subscription and valid API key for the external "N8N Tools API" service, which acts as a proxy or validation layer for TikTok API requests.
- Requires TikTok API credentials configured in n8n to authenticate requests.
- The node uses an internal TikTok API wrapper class to interact with TikTok endpoints.
Troubleshooting
- Invalid subscription or API key error: If the node throws an error indicating invalid subscription or API key, verify that the API key credential is correctly set up and active.
- Date format issues: Ensure that the start and end dates are provided in the correct YYYY-MM-DD format; otherwise, the API may reject the request.
- Video ID errors: Confirm that the Video ID is valid and corresponds to an existing TikTok video accessible by the authenticated user.
- API rate limits: Frequent requests might hit TikTok or the proxy API rate limits, causing temporary failures.
- Continue on Fail: If enabled, the node will continue processing subsequent items even if one fails, returning error details in the output.