TikTok icon

TikTok

Crie e gerencie posts no TikTok

Actions4

Overview

This node integrates with TikTok to retrieve analytics data, specifically focusing on post statistics when using the "Get Post Stats" operation under the "Analytics" resource. It allows users to fetch various engagement metrics for their TikTok posts over selectable date ranges. This is useful for social media managers, marketers, or content creators who want to monitor the performance of their TikTok posts by analyzing views, likes, comments, shares, profile views, and follower counts.

Practical examples include:

  • Tracking how many views and likes a recent post received in the last 7 days.
  • Comparing engagement metrics such as comments and shares over the last 30 or 60 days.
  • Monitoring follower growth alongside post interactions to evaluate content effectiveness.

Properties

Name Meaning
Metrics The engagement metrics to analyze. Options: Views, Likes, Comments, Shares, Profile Views, Followers. Multiple can be selected. Default is Views and Likes.
Date Range The time period for which to retrieve analytics data. Options: Last 7 Days, Last 30 Days, Last 60 Days. Default is Last 7 Days.

Output

The node outputs JSON data containing the requested post statistics for the selected metrics over the specified date range. The structure typically includes metric names as keys with their corresponding values representing counts or totals during that period.

If binary data were involved (not applicable here), it would represent media files or similar content, but this operation focuses solely on JSON analytics data.

Dependencies

  • Requires an API key credential for TikTok's API with appropriate permissions to access analytics data.
  • The node uses TikTok's official open API endpoints, switching between production and sandbox environments based on configuration.
  • Proper network connectivity to TikTok's API servers is necessary.

Troubleshooting

  • Common Issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Requesting metrics not supported or invalid date ranges may result in errors or empty responses.
    • Network issues or TikTok API downtime can lead to request timeouts or failures.

  • Error Messages:

    • Authentication errors indicate problems with the provided API key or token; verify credentials and permissions.
    • Validation errors suggest incorrect property values; ensure metrics and date ranges are selected from the allowed options.
    • Rate limiting errors mean too many requests in a short time; implement retries with backoff or reduce request frequency.

Links and References

Discussion