TikTok icon

TikTok

Upload videos to TikTok

Actions11

Overview

The node interacts with TikTok's API to manage video content, specifically providing the ability to retrieve the upload status of a video. This operation is useful for workflows that need to verify whether a video has been successfully uploaded or is still processing on TikTok's platform.

Typical use cases include:

  • Automating video publishing pipelines where you want to confirm upload completion before proceeding.
  • Monitoring video upload progress in bulk operations.
  • Integrating TikTok video status checks into broader social media management workflows.

For example, after uploading a video via this node or another system, you can use the "Get Status" operation to programmatically check if the video is ready for viewing or further actions.

Properties

Name Meaning
Video ID The unique identifier of the video whose upload status you want to retrieve. This is a required string input.

Output

The node outputs JSON data representing the upload status information of the specified video. The structure corresponds to TikTok's API response under the data field and typically includes details such as upload progress, current state, and any relevant metadata about the video upload.

The output is returned as an array of JSON objects, each corresponding to an input item processed. There is no binary data output for this operation.

Example output structure (simplified):

[
  {
    "upload_status": "completed",
    "video_id": "1234567890",
    "processing_state": "ready",
    "additional_info": { ... }
  }
]

Dependencies

  • Requires an active TikTok API authentication token configured in n8n credentials.
  • Uses TikTok's official open API endpoint for video upload status checking.
  • Relies on network connectivity to TikTok's API servers.
  • No additional external dependencies beyond standard HTTP requests and n8n helper methods.

Troubleshooting

  • Common issues:

    • Invalid or missing Video ID will cause the request to fail.
    • Network errors or TikTok API downtime may prevent status retrieval.
    • Rate limiting by TikTok API can occur if too many requests are made in a short time.

  • Error messages:

    • "Rate limit exceeded. Please try again later." — Wait for the cooldown period before retrying.
    • "Invalid response received from TikTok API" — Check if the Video ID is correct and the API is reachable.
    • "TikTok API Error: <message>" — Indicates an error returned by TikTok; review the message for specifics.
    • "No binary data property "<property>" exists on item!" — Not applicable for this operation but common in upload operations.

  • Resolution tips:

    • Ensure the Video ID is correctly provided and corresponds to an existing video.
    • Verify your TikTok API credentials are valid and have necessary permissions.
    • Implement retry logic or use the node's "Continue On Fail" option to handle intermittent failures gracefully.

Links and References

Discussion