N8N Tools - TikTok Enhanced icon

N8N Tools - TikTok Enhanced

Comprehensive TikTok API integration for N8N workflows

Actions46

Analytics → Get User Analytics

AI-generated

Overview

The node provides enhanced integration with the TikTok API via the "N8N Tools - TikTok Enhanced" package. Specifically, for the Analytics resource and the Get User Analytics operation, it retrieves detailed analytics data about a TikTok user over a specified date range.

This node is useful for social media managers, marketers, or analysts who want to track user engagement, growth, and performance metrics on TikTok. For example, you can use it to monitor how a particular TikTok user's content performs over time, helping inform content strategy or advertising decisions.

Properties

Name Meaning
Start Date The start date for the analytics data retrieval, formatted as YYYY-MM-DD (required).
End Date The end date for the analytics data retrieval, formatted as YYYY-MM-DD (required).
Open ID The unique TikTok User Open ID identifying the user whose analytics are being retrieved.

Note: The Open ID property is required for this operation but was not included in the provided JSON properties snippet. It is used internally to specify the target user.

Output

  • The output is an array of JSON objects, each containing the analytics data returned by the TikTok API for the specified user and date range.
  • Each item corresponds to one execution input item.
  • The exact structure of the analytics data depends on TikTok's API response but typically includes metrics such as views, likes, followers gained, engagement rates, and other user performance indicators.
  • No binary data output is produced by this operation.

Dependencies

  • Requires an active subscription and valid API key credential for the external "N8N Tools API" service.
  • Requires TikTok API credentials configured in n8n to authenticate requests.
  • The node uses the bundled TikTok API client (TikTokApi) to interact with TikTok endpoints.
  • Network access to both the N8N Tools API and TikTok API endpoints is necessary.

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.
  • Date Format Issues: Ensure that the Start Date and End Date are provided in the correct YYYY-MM-DD format; otherwise, the TikTok API may reject the request.
  • Missing Open ID: The operation requires a valid TikTok User Open ID. Omitting or providing an incorrect Open ID will cause errors or empty results.
  • API Rate Limits: Be aware of TikTok API rate limits which might cause throttling or temporary failures.
  • Continue On Fail: If enabled, the node will continue processing subsequent items even if some fail, returning error details per failed item.

Links and References

Discussion