TikTok icon

TikTok

Upload videos to TikTok

Overview

This node integrates with TikTok's API to manage video content on a TikTok account. Specifically, the Delete Video operation allows users to delete a video by its ID from their TikTok account.

Common scenarios where this node is beneficial include:

  • Automating content management workflows by removing outdated or unwanted videos.
  • Integrating TikTok video deletion into larger automation pipelines, such as content lifecycle management or compliance processes.
  • Bulk deleting videos programmatically based on external triggers or conditions.

Example use case:

  • A social media manager wants to automatically delete promotional videos after a campaign ends. They can use this node to delete videos by specifying their IDs without manual intervention.

Properties

Name Meaning
Video ID The unique identifier of the video to be deleted on TikTok. This property is required for the delete operation.

Output

The output JSON contains the response data returned by TikTok's API after attempting to delete the specified video. It typically includes confirmation of deletion or error details if the operation failed.

The structure is an array of JSON objects corresponding to each input item processed, with fields reflecting TikTok's API response under a data property.

No binary data output is produced by this operation.

Dependencies

  • Requires an API authentication token credential configured in n8n to authorize requests to TikTok's API.
  • Uses TikTok's official open API endpoints for video management.
  • Relies on network connectivity to TikTok's API servers.
  • Handles rate limiting internally and will retry requests with exponential backoff if rate limits are hit.

Troubleshooting

  • Common issues:

    • Invalid or missing Video ID: The node requires a valid video ID; ensure the correct ID is provided.
    • Authentication errors: Verify that the API authentication token is correctly set up and has sufficient permissions.
    • Rate limit exceeded: If too many requests are made in a short time, the node will throw a rate limit error. Wait before retrying.
    • Network errors: Temporary connectivity issues may cause failures; retrying later often resolves these.
  • Error messages:

    • "TikTok API Error: ..." indicates an error response from TikTok's API, including error code and message.
    • "Rate limit exceeded. Please try again later." means the request quota was surpassed; wait for the reset period.
    • "Request failed after maximum retries" occurs if repeated attempts to handle rate limits fail.
    • "No binary data property ... exists on item!" is unrelated to delete but may appear if upload operations are misconfigured.

To resolve errors:

  • Double-check input parameters.
  • Ensure credentials are valid.
  • Respect rate limits by spacing requests.
  • Review TikTok API documentation for specific error codes.

Links and References

Discussion