TikTok icon

TikTok

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

Actions7

Overview

This node integrates with the TikTok API to manage and retrieve information about TikTok videos. Specifically, the Video - List operation fetches a list of videos associated with the authenticated user or account. It supports pagination through a cursor and limits the number of videos returned per request.

Typical use cases include:

  • Retrieving recent videos posted by a user for reporting or analytics.
  • Displaying a user's video catalog in an external dashboard.
  • Automating workflows that process or analyze TikTok video data.

For example, you might use this node to get up to 20 of the latest videos and then trigger further processing such as downloading metadata or analyzing engagement metrics.

Properties

Name Meaning
Max Count Maximum number of videos to retrieve. Accepts values from 1 to 20.
Cursor Cursor string used for pagination. Leave empty to retrieve the first page of results.

Output

The output is a JSON array where each item represents a TikTok video object as returned by the TikTok API's /v2/video/list/ endpoint. The exact structure depends on TikTok's API response but typically includes video metadata such as IDs, titles, descriptions, URLs, and other relevant details.

No binary data output is produced by this operation.

Dependencies

  • Requires an OAuth2 API credential configured for TikTok to authenticate requests.
  • Relies on the TikTok Open API endpoint at https://open.tiktokapis.com.
  • The node uses POST requests to interact with the TikTok API.

Troubleshooting

  • Common issues:

    • Invalid or expired OAuth2 credentials will cause authentication failures.
    • Providing an invalid cursor may result in errors or empty responses.
    • Requesting more than 20 videos will be rejected due to API limits.

  • Error messages:

    • Authentication errors usually indicate problems with the API key or token; re-authenticate or refresh credentials.
    • Pagination errors may occur if the cursor is malformed or outdated; try resetting the cursor to empty.
    • Validation errors if maxCount is outside the allowed range (1-20); adjust the value accordingly.

Links and References

Discussion