Actions7
- Video Actions
- User Actions
- Analytics Actions
Overview
The node interacts with the TikTok API to retrieve detailed analytics data for specified videos. Specifically, the "Get Video Analytics" operation allows users to fetch various metrics and metadata about one or more TikTok videos by providing their video IDs. This is useful for content creators, marketers, and analysts who want to monitor video performance such as views, likes, comments, shares, and other relevant statistics.
Practical examples include:
- Tracking engagement metrics across multiple videos to evaluate content effectiveness.
- Gathering video metadata like duration, dimensions, and cover images for reporting or display purposes.
- Automating regular retrieval of video stats to feed dashboards or trigger alerts based on performance changes.
Properties
| Name | Meaning |
|---|---|
| Video IDs | List of TikTok video IDs to retrieve analytics for. Supports multiple values, max 20 IDs. |
| Analytics Fields | Select which analytics fields to retrieve for each video. Options include: |
| - Comment Count: Number of comments | |
| - Cover Image URL: Video cover/thumbnail image | |
| - Create Time: Video creation timestamp | |
| - Download Count: Number of downloads | |
| - Duration: Video duration in seconds | |
| - Embed URL: Video embed URL | |
| - Height: Video height in pixels | |
| - Like Count: Number of likes | |
| - Share Count: Number of shares | |
| - Title: Video title | |
| - Video ID: Unique identifier of the video | |
| - Video URL: Video description or caption | |
| - View Count: Number of views | |
| - Width: Video width in pixels |
Default selected fields are: Video ID, Title, View Count, Like Count, Comment Count, Share Count.
Output
The output JSON contains an array of objects, each representing analytics data for a requested video. Each object includes the fields specified in the "Analytics Fields" input property. For example, if "View Count" and "Like Count" are selected, each video's output will contain those numeric metrics along with any other requested fields.
No binary data is output by this operation; all returned data is structured JSON containing video analytics and metadata.
Dependencies
- Requires an active TikTok API OAuth2 credential configured in n8n to authenticate requests.
- The node makes HTTP POST requests to TikTok's official open API endpoint
https://open.tiktokapis.com. - No additional external dependencies beyond the TikTok API and proper authentication.
Troubleshooting
Common issues:
- Providing more than 20 video IDs may cause errors due to API limits.
- Requesting unsupported or misspelled analytics fields can result in incomplete or failed responses.
- Invalid or expired API credentials will cause authentication failures.
Error messages:
- Errors from the TikTok API (e.g., rate limiting, invalid parameters) will be surfaced as node execution errors.
- If the node is set to continue on fail, error details will appear in the output JSON under an
errorkey for the affected item.
Resolutions:
- Ensure video IDs are valid and do not exceed the maximum count.
- Double-check selected analytics fields against the available options.
- Verify that the TikTok API credentials are correctly configured and have not expired.
- Use the node’s "Continue On Fail" option to handle partial failures gracefully.
Links and References
- TikTok for Developers - Open API Documentation
- TikTok Video Analytics API Reference (official docs for video analytics endpoints)