Actions11
Overview
This node integrates with TikTok's API to retrieve audience analytics data for videos. Specifically, the "Get Audience Analytics" operation fetches demographic information about the viewers of a specified video within a given date range. This is useful for content creators, marketers, and analysts who want to understand the composition of their audience on TikTok, such as age groups, gender distribution, or other demographic insights.
Practical examples include:
- Analyzing the demographics of viewers to tailor future video content.
- Measuring how audience composition changes over time.
- Comparing audience profiles across different videos to optimize marketing strategies.
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 audience analytics data will be retrieved.
Output
The output is a JSON array where each item corresponds to the audience analytics data returned by TikTok for the requested video and date range. The structure typically includes demographic metrics such as age ranges, gender distribution, and possibly other audience characteristics as provided by TikTok's API.
Each output item contains a json field with the analytics data structured according to TikTok's response format under the .data property.
No binary data output is produced by this operation.
Dependencies
- Requires an API authentication token credential for TikTok's API.
- The node makes HTTP requests to TikTok's official open API endpoints.
- No additional environment variables are required beyond the configured API credentials.
Troubleshooting
- Rate Limit Errors: If the node throws errors indicating rate limits have been exceeded, wait for the specified retry duration before making further requests. The node implements automatic retries with exponential backoff up to a maximum number of attempts.
- Invalid Date Range: Ensure that the start and end dates are valid and that the start date is not after the end date.
- Missing or Invalid Video ID: Although not explicitly shown in the provided snippet for this operation, generally ensure the video ID parameter (if applicable) is correctly set and corresponds to an existing video.
- API Errors: The node surfaces TikTok API error messages. Common issues include invalid tokens, expired credentials, or malformed requests. Verify API credentials and input parameters.
- Network Issues: Network connectivity problems can cause failures; verify internet access and TikTok API availability.
Links and References
(Note: URLs are indicative based on typical TikTok developer documentation paths.)