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, users, and analytics. Specifically, for the Video - Get Status operation, it retrieves the current status of a published TikTok video using its publish ID. This is useful for workflows that need to confirm whether a video has been successfully published or to check its processing state after upload.

Practical examples include:

  • Automatically verifying if a video upload was successful before proceeding with further automation.
  • Monitoring the publishing status of scheduled posts.
  • Triggering notifications or follow-up actions based on the video's publication state.

Properties

Name Meaning
Publish ID The unique identifier returned from the video upload operation, used to fetch its status.

Output

The output JSON contains the response from TikTok's API about the video's publish status. It typically includes details such as whether the video is published, processing status, errors if any, and other metadata related to the video's current state on TikTok.

No binary data output is produced by this operation.

Example output structure (simplified):

{
  "publish_id": "string",
  "status": "string",          // e.g., "PUBLISHED", "PROCESSING", "FAILED"
  "error_message": "string"    // present if there was an error
}

Dependencies

  • Requires an OAuth2 API credential configured in n8n to authenticate requests against the TikTok API.
  • The node makes HTTP POST requests to TikTok's official open API endpoint: https://open.tiktokapis.com.
  • No additional external dependencies beyond the configured TikTok API credentials.

Troubleshooting

  • Common issues:

    • Invalid or expired publish ID: Ensure the publish ID is correctly obtained from a prior upload or publish operation.
    • Authentication errors: Verify that the OAuth2 credentials are valid and have the necessary permissions.
    • Network or API downtime: Check internet connectivity and TikTok API status.

  • Error messages:

    • "Invalid publish ID": Confirm the publish ID matches one returned by the upload/publish step.
    • "Unauthorized" or "Authentication failed": Reauthenticate or update the OAuth2 credentials.
    • "Rate limit exceeded": Wait and retry later; consider implementing rate limiting in your workflow.

Links and References

Discussion