TikTok API Error Reference

Solution:

Your access token is no longer valid. Go to account settings and reconnect your TikTok account to get a new valid token.

Solution:

You didn't grant all required permissions. When reconnecting, make sure to approve all requested scopes including video.upload and user.info.basic.

Solution:

Additional permissions are needed for this operation. Reconnect your TikTok account and ensure all permissions are granted.

Solution:

Your TikTok account has been restricted from posting. Log into TikTok directly to see if there are any warnings. You may need to appeal the restriction.

Solution:

Your caption or text was flagged as spam. Avoid repetitive content, excessive links, or promotional language. Try posting different content.

Solution:

You've exceeded TikTok's daily posting limit. Wait 24 hours before posting again. Consider spreading your posts across multiple days.

Solution:

To reduce spamming, TikTok limits the number of videos that can be uploaded via API that are not pending approval and posting by the creator. There may be at most 5 pending shares within any 24-hour period.

Solution:

TikTok's spam detection system flagged your content. Ensure your content is original and follows TikTok's community guidelines. Avoid repetitive posts.

Solution:

Your app has reached its daily active user limit. This is set by TikTok based on your app's status. Wait 24 hours or request a quota increase.

Solution:

Your video format is not supported. TikTok requires MP4 or WebM format. Convert your video and ensure it meets TikTok's specifications.

Solution:

Video duration must be between 3 seconds and 10 minutes. Trim your video to fit within these limits.

Solution:

TikTok requires a frame rate between 23-60 fps. Re-encode your video with a supported frame rate.

Solution:

Your video resolution is too low. TikTok requires minimum 720p resolution. Use a higher quality video source.

Solution:

Your video is too long. Maximum duration is 10 minutes. Edit your video to be shorter or split it into multiple parts.

Solution:

Maximum file size is typically 287MB for videos. Compress your video or reduce its quality to meet the size limit.

Solution:

TikTok couldn't download your video from the provided URL. Ensure the URL is publicly accessible, returns correct headers, and the file is valid.

Solution:

TikTok couldn't download your image. Verify the URL is publicly accessible and returns the correct content-type header (image/jpeg or image/png).

Solution:

Your file doesn't meet TikTok's requirements. Check that it's a valid video/image file in a supported format and meets all specifications.

Solution:

You've made too many requests too quickly. Wait a few minutes before trying again. The system will automatically retry for you.

Solution:

TikTok is rate limiting your requests. Reduce the frequency of API calls and implement exponential backoff in your retry logic.

Solution:

Your TikTok app is not approved for production. Submit your app for TikTok's review process to enable public posting capabilities.

Solution:

You need to verify ownership of any external URLs in your posts. Add the verification code to your domain or use the TikTok developer console to verify.

Solution:

The privacy level you specified doesn't match your app's capabilities or account settings. Review your app's permissions and the privacy settings.

Solution:

TikTok is experiencing server issues. This is temporary. Wait a few minutes and try again. The system will automatically retry.

Solution:

One or more parameters in your request are invalid. Review the TikTok API documentation and ensure all required fields are present and correctly formatted.