Actions11
Overview
This node operation fetches geographic analytics data for TikTok videos. It allows users to retrieve insights about the geographic distribution of video viewers over a specified date range. This is useful for content creators, marketers, and analysts who want to understand where their audience is located geographically to tailor content or marketing strategies accordingly.
Practical examples include:
- Analyzing which countries or regions engage most with a video.
- Comparing geographic reach between different videos.
- Tracking changes in geographic audience distribution over time.
Properties
| Name | Meaning |
|---|---|
| Start Date | The start date for the analytics data period to query. |
| End Date | The end date for the analytics data period to query. |
These properties define the time window for which the geographic analytics data will be retrieved.
Output
The output is a JSON array containing the geographic analytics data for the specified video(s) within the given date range. Each item in the output corresponds to an analytics record that includes geographic distribution metrics such as viewer counts or engagement broken down by location.
The exact structure depends on TikTok's API response but typically includes fields like country/region codes and associated metric values.
No binary data output is produced by this operation.
Dependencies
- Requires an API authentication token credential for TikTok's API.
- The node makes HTTP GET requests to TikTok's geographic analytics endpoint.
- Proper configuration of the TikTok API credentials in n8n is necessary.
- Network connectivity to TikTok's open API endpoint is required.
Troubleshooting
- Rate Limit Errors: If the node throws errors about rate limits, it means too many requests were made in a short time. Wait for the cooldown period before retrying.
- Invalid Date Range: Providing invalid or empty start/end dates may cause the API to reject the request or return no data.
- Missing or Invalid Video ID: Although not explicitly shown here, ensure the video ID parameter (if applicable) is correctly provided when fetching analytics.
- Network Issues: Connectivity problems can cause failures; verify network access to TikTok's API.
- API Errors: The node surfaces TikTok API error messages. Review these messages for issues like invalid parameters or expired tokens.
Links and References
(Note: URLs are indicative based on typical TikTok developer resources.)