TikTok icon

TikTok

Interact with TikTok API - post content, get user stats and analytics
Join our community

Actions7

Overview

This node interacts with the TikTok API to retrieve various user-related statistics. Specifically, the User - Get Stats operation fetches key metrics about a TikTok user’s account such as follower count, following count, total likes received, and number of videos posted.

This node is beneficial for social media managers, marketers, or developers who want to monitor TikTok user performance programmatically. For example, it can be used to track growth in followers over time, analyze engagement by comparing likes and video counts, or integrate TikTok stats into dashboards and reports.

Properties

Name Meaning
Statistics Fields Select which user statistics to retrieve. Options include:
- Follower Count: Number of followers
- Following Count: Number of accounts the user is following
- Likes Count: Total likes received
- Video Count: Total number of videos posted

By default, all four fields are selected.

Output

The output JSON contains the requested user statistics as key-value pairs. For example, if all fields are requested, the output might look like:

{
  "follower_count": 12345,
  "following_count": 678,
  "likes_count": 91011,
  "video_count": 42
}

Each field corresponds to the respective metric for the TikTok user. The node does not output binary data for this operation.

Dependencies

  • Requires an active TikTok API OAuth2 credential configured in n8n to authenticate requests.
  • Uses the TikTok Open API endpoint https://open.tiktokapis.com/v2/user/info/ with query parameters specifying the requested statistics fields.
  • The node depends on internal helper functions to make authenticated HTTP GET requests to the TikTok API.

Troubleshooting

  • Common issues:

    • Invalid or expired API credentials will cause authentication errors.
    • Requesting unsupported or misspelled statistics fields may result in API errors or empty responses.
    • Network connectivity problems can prevent successful API calls.

  • Error messages:

    • Authentication failures typically return errors indicating invalid tokens or unauthorized access. Re-authenticate or update credentials.
    • If the API returns an error about invalid parameters, verify that the selected statistics fields are valid.
    • Rate limiting errors from TikTok API require waiting before retrying or adjusting request frequency.

Links and References

Discussion