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 videos, specifically allowing users to publish previously uploaded videos. The Publish operation under the Video resource finalizes and publishes a video on TikTok using a publishId obtained from an earlier upload step.

Typical use cases include:

  • Automating the publishing of TikTok videos after uploading them.
  • Setting video metadata such as title, description, and privacy level at the time of publishing.
  • Managing video visibility by choosing between public, friends-only, or private settings.

For example, after uploading a video via the node’s upload operation, you can use this Publish operation to make the video live on TikTok with a custom title and description.

Properties

Name Meaning
Title The title for the video that will appear on TikTok.
Description A caption or description text for the video.
Privacy Level The visibility setting for the video. Options:
- Public to Everyone
- Friends Only
- Private (Self Only)
Publish ID The unique identifier returned from the upload operation, required to publish the video.

Output

The output JSON contains the response from the TikTok API after attempting to publish the video. This typically includes details about the published video such as its status and identifiers confirming successful publication.

No binary data is output by this operation.

Dependencies

  • Requires an active TikTok API OAuth2 credential configured in n8n to authenticate requests.
  • Relies on the TikTok Open API endpoint https://open.tiktokapis.com.
  • The node uses internal helper functions to send HTTP POST requests to TikTok’s /v2/post/publish/ endpoint.

Troubleshooting

  • Common issues:

    • Using an invalid or expired publishId will cause the publish request to fail.
    • Missing or incorrect OAuth2 credentials will result in authentication errors.
    • Providing empty or invalid values for required fields like publishId may cause errors.

  • Error messages:

    • Errors from TikTok API are passed through; typical messages might indicate invalid publish IDs or permission issues.
    • If the node throws an error related to authentication, verify that the TikTok OAuth2 credentials are correctly set up and valid.
    • Network or API downtime issues may cause request failures; retrying later or checking TikTok API status is recommended.

Links and References

This summary is based solely on static analysis of the provided source code and property definitions.

Discussion