Actions46
- Videos Actions
- Users Actions
- Hashtags Actions
- Music Actions
- Analytics Actions
- Marketing/Ads Actions
- Business Actions
- Creator Actions
- Commerce/Shopping Actions
Creator → Get Live Stream Analytics
AI-generatedOverview
This node integrates with TikTok's API via the N8N Tools API to perform various operations related to TikTok content and user data. Specifically, for the Creator resource and the Get Live Stream Analytics operation, it retrieves analytics data for a specified live stream on TikTok.
This functionality is useful for content creators, marketers, or social media managers who want to monitor the performance of their live streams on TikTok. For example, you can use this node to fetch real-time or historical analytics such as viewer counts, engagement metrics, or other insights related to a particular live stream session.
Practical examples include:
- Tracking the success of a live event by analyzing viewer engagement.
- Integrating live stream analytics into broader marketing dashboards.
- Automating reports on live stream performance for stakeholders.
Properties
| Name | Meaning |
|---|---|
| Stream ID | The unique identifier of the live stream for which analytics are requested. This is a required string input. |
Output
The node outputs JSON data containing the live stream analytics retrieved from TikTok. The exact structure depends on the TikTok API response but typically includes metrics such as viewer counts, engagement statistics, and other relevant analytics for the specified live stream.
If multiple items are processed, the output is an array of objects each corresponding to one input item, with the analytics data under the json key.
No binary data output is indicated for this operation.
Dependencies
- Requires an active subscription and valid API key credential for the N8N Tools API service.
- Requires TikTok API credentials configured in n8n to authenticate requests.
- The node internally validates the API key with the N8N Tools API before making TikTok API calls.
- No additional environment variables are explicitly required beyond these credentials.
Troubleshooting
- Invalid Subscription or API Key: If the node throws an error indicating invalid subscription or API key, verify that your API key credential is correct and active.
- API Request Failures: Network issues or TikTok API changes may cause request failures. Check connectivity and ensure the TikTok API credentials have proper permissions.
- Missing or Incorrect Stream ID: Ensure the "Stream ID" property is provided and correctly corresponds to an existing live stream on TikTok.
- Continue On Fail Behavior: If enabled, the node will continue processing subsequent items even if some fail, returning errors in the output for failed items.
Links and References
- TikTok Developer Documentation
- N8N Documentation - Creating Custom Nodes
- N8N Tools API (Generic) (for reference on the external API used)