TikTok icon

TikTok

Upload videos to TikTok

Actions11

Overview

The node integrates with TikTok's API to retrieve analytics data for multiple videos in a single request. Specifically, the "Get Batch Analytics" operation allows users to fetch various performance metrics across a batch of video IDs simultaneously. This is useful for marketers, content creators, or analysts who manage multiple TikTok videos and want consolidated insights without querying each video individually.

Practical examples include:

  • Aggregating engagement metrics (likes, shares, comments) for a set of campaign videos.
  • Monitoring view counts and watch time across multiple product demo videos.
  • Comparing retention rates and audience interaction on several promotional clips.

Properties

Name Meaning
Video IDs Comma-separated list of TikTok video IDs for which to retrieve analytics data.
Metrics List of specific analytics metrics to retrieve. Options: Comments, Engagement Rate, Likes, Retention Rate, Shares, Views, Watch Time.

Output

The output JSON contains an array of analytics data objects corresponding to the requested video IDs. Each object includes the requested metrics with their respective values for that video.

The structure generally looks like:

[
  {
    "video_id": "string",
    "comments": number,
    "engagement_rate": number,
    "likes": number,
    "retention_rate": number,
    "shares": number,
    "views": number,
    "watch_time": number
  },
  ...
]

Each metric field is present only if it was requested in the input properties.

No binary data output is produced by this operation.

Dependencies

  • Requires an active TikTok API authentication token (API key credential) configured in n8n credentials.
  • The node makes HTTP GET requests to TikTok's batch video analytics endpoint.
  • Handles rate limiting according to TikTok API limits, including automatic retries with exponential backoff.

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. The node automatically retries up to 5 times with increasing delays.
  • Invalid Video IDs: Providing malformed or non-existent video IDs may result in API errors. Ensure video IDs are correct and comma-separated.
  • Empty Metrics Array: If no metrics are selected, the API call might return incomplete data or an error. Always select at least one metric.
  • Network Issues: Network connectivity problems can cause request failures. Verify internet access and TikTok API availability.
  • API Errors: Any TikTok API error responses are surfaced with descriptive messages. Check the error code and message for guidance.

Links and References

Discussion