AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

TikTok-Veröffentlichungsfehler: spam_risk_too_many_posts, picture_size_check_failed und weitere Fehlergründe

TikTok nennt die Ursache eines fehlgeschlagenen Beitrags in reason auf dem Status-Endpoint der API for Business oder in fail_reason bei der Content Posting API. Prüfungsfehler wie picture_size_check_failed bedeuten, dass die Datei eine Formatregel verletzt und geändert werden muss. video_pull_failed heißt, dass TikTok sie nicht innerhalb einer Stunde herunterladen konnte. spam_risk_too_many_posts bedeutet zu viele API-Beiträge in 24 Stunden. Ein als internal markierter Fehler lässt sich einfach erneut versuchen.

easyCoexistence verfolgt jeden TikTok-Beitrag, den es veröffentlicht, bis TikTok ihn abschließt oder ablehnt, für Claude, ChatGPT oder Ihre eigene Plattform.

reason

Das Feld /business/publish/status/ wird nur bei dem Status FAILED zurückgegeben, mit Werten wie frame_rate_check_failed.

fail_reason

Der Name desselben Feldes in der Content Posting API, in den Antworten von /v2/post/publish/status/fetch/.

1 hour

Download-Timeout, nach dem TikTok einen Beitrag mit video_pull_failed oder photo_pull_failed als fehlgeschlagen markiert.

24 hours

Zeitfenster hinter spam_risk_too_many_posts. TikTok empfiehlt, diesen Beitrag stattdessen über die mobile App zu veröffentlichen.

3 hours

Meist benachrichtigt easyCoexistence einen Inhaber per E-Mail über fehlgeschlagene Beiträge auf einem Kanal. Der Beitrag wartet unter Aufmerksamkeit erforderlich.

Wo meldet TikTok, warum ein Beitrag fehlgeschlagen ist?

Nach dem Veröffentlichungsaufruf, der nur die Aufgabe startet: Code 0 bedeutet, dass TikTok ihn angenommen hat, nicht dass der Beitrag live geht. GET /business/publish/status/ liefert dann FAILED mit reason. Eine App, die für Veröffentlichungs-Webhooks abonniert ist, erhält post.publish.failed mit demselben Grund und der publish_id. Die Content Posting API liefert das Feld unter /v2/post/publish/status/fetch/ als fail_reason:

A failed post in /business/publish/status/, from TikTok's example
{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": {
    "reason": "frame_rate_check_failed",
    "status": "FAILED"
  }
}

Was bedeutet jeder Fehlergrund, und was behebt ihn?

Die Gründe von TikTok laut dessen Referenz zu Veröffentlichungsereignissen, jeweils neben der Lösung, auf die sie verweist. Die ersten vier sind Prüfungen, die TikTok nach dem Herunterladen an der Datei ausführt; alle sind als nicht wiederholbar markiert. Die Fehlertabelle von TikTok nennt weiterhin 60 Sekunden als längstes Video für duration_check_failed, während der Video-Endpoint 600 dokumentiert oder den kontoeigenen Wert max_video_post_duration_sec:

What TikTok foundThe fix
file_format_check_failedThe file's format breaks TikTok's specificationsMP4, MOV or WebM video; JPG, JPEG or WebP photos
duration_check_failedThe video's length is outside the limitsAt least 3 seconds, within the account's maximum
frame_rate_check_failedBelow 23 or above 60 frames per secondExport at 23 to 60 FPS
picture_size_check_failedHeight or width under 360 pixelsAt least 360 pixels on each side
video_pull_failed, photo_pull_failedThe download failed or ran past one hourA public URL that is not bandwidth-limited, then a retry
internalPart of TikTok's service was unavailableA retry
auth_removedThe owner removed the app's access mid-processingNo retry; the owner authorizes the app again
spam_risk_too_many_postsToo many API posts in the last 24 hoursPosting from the TikTok mobile app, or waiting
spam_risk_user_banned_from_postingThe account is banned from making new postsNo retry while the account cannot post
spam_risk_textThe caption reads as risky or spammyNew text before posting again
spam_riskHigh spam risk, such as attempts made too oftenNo retry, as TikTok advises
publish_cancelledThe upload or download was cancelledPublishing again if the post is still wanted

Welche Fehler lassen sich erneut versuchen?

Solche, die durch den Download oder durch TikTok selbst verursacht wurden. Die übrigen brauchen eine andere Datei oder Beschreibung, eine Pause oder gar nichts:

  • Unverändert erneut versuchen: internal sowie video_pull_failed oder photo_pull_failed, sobald die URL öffentlich und schnell genug ist.
  • Mit neuer Datei erneut versuchen: file_format_check_failed, duration_check_failed, frame_rate_check_failed und picture_size_check_failed.
  • Mit neuer Beschreibung erneut versuchen: spam_risk_text.
  • Warten oder über die TikTok-App veröffentlichen: spam_risk_too_many_posts.
  • Nicht erneut versuchen: auth_removed und spam_risk, wie TikTok rät, oder spam_risk_user_banned_from_posting.

Worin unterscheiden sich die Fehler der Content Posting API?

Gleiche Gründe, ein anderes Feld und einen anderen Endpoint sowie Ablehnungen, die vor Beginn der Verarbeitung greifen. /v2/post/publish/status/fetch/ liefert fail_reason, erlaubt 30 Anfragen pro Minute und Nutzer-Token und ergänzt Hinweise, nicht erneut zu versuchen, bei spam_risk_user_banned_from_posting und spam_risk_text. Einige Ablehnungen kommen stattdessen beim Init-Aufruf mit HTTP 403:

  • spam_risk_too_many_posts: Der Creator hat das tägliche Beitragslimit der API erreicht.
  • unaudited_client_can_only_post_to_private_accounts: Eine nicht geprüfte App hat versucht, für ein öffentliches Konto zu veröffentlichen.
  • url_ownership_unverified: PULL_FROM_URL von einer Domain oder einem Präfix, das die App nicht verifiziert hat.
  • privacy_level_option_mismatch: Ein privacy_level fehlt oder liegt außerhalb der Optionen des Creators.
  • reached_active_user_cap: Die App hat ihr tägliches Kontingent aktiver Veröffentlichungsnutzer erreicht.

Was scheitert, bevor TikTok den Beitrag sieht?

Was easyCoexistence zuerst abfangen kann, mit einer eigenen Meldung statt eines TikTok-Grundes. Die Medien eines geplanten Beitrags werden beim Planen kopiert. Ein Link, der eine Webseite, einen 404-Fehler, den falschen Typ oder eine Datei über 30 MB für ein Bild bzw. 1 GB für ein Video liefert, wird dann abgelehnt. Foto-Links mit den Endungen .png, .gif, .bmp, .heic, .avif oder .svg werden vor dem Senden abgelehnt. Ein Kanal, der beim Veröffentlichen neu verbunden werden muss, schlägt mit reconnect fehl, und das Entfernen eines Kanals storniert seine geplanten Beiträge.

Wie meldet easyCoexistence einen fehlgeschlagenen TikTok-Beitrag?

Über seine Veröffentlichungswarteschlange, die jeden TikTok-Beitrag nach dem Veröffentlichungsaufruf verfolgt und etwa alle 20 Sekunden /business/publish/status/ prüft, bis PUBLISH_COMPLETE erreicht ist. Ein FAILED-Status lässt den Beitrag scheitern. Die Fehlermeldung nennt den Grund von TikTok in Klammern, etwa frame_rate_check_failed, und jeder Fehler trägt eine failure_kind:

  • refused: TikTok hat mit Nein geantwortet, etwa bei einem FAILED-Status und seinem Grund.
  • uncertain: Der Veröffentlichungsaufruf erhielt keine eindeutige Antwort, oder TikTok bestätigte nicht innerhalb von 2 Stunden, sodass der Beitrag live sein kann (may_be_published).
  • reconnect: TikTok hat das Token des Kontos abgelehnt, und das Konto braucht eine erneute Anmeldung.
  • internal: easyCoexistence ist fehlgeschlagen, bevor der Beitrag übergeben wurde, sodass nichts hinausging.

Wie finden und wiederholen Sie einen fehlgeschlagenen Beitrag?

Der Inhaber erhält eine E-Mail für einen im Hintergrund gefundenen Fehler, höchstens eine pro Kanal alle 3 Stunden, und die Events-URL einer Plattform erhält post.failed. Der Beitrag erscheint unter Aufmerksamkeit erforderlich auf der Seite Beiträge, mit den Schaltflächen Erneut versuchen, Neu verbinden und Verwerfen. list_scheduled_posts gibt ihn an Claude oder ChatGPT zurück. retry_scheduled_post veröffentlicht ihn sofort erneut, aus Dateien, die 7 Tage nach einem Fehler aufbewahrt werden. Ist may_be_published auf true, prüfen Sie zuerst list_social_posts und übergeben confirm nur, wenn der Beitrag fehlt. Ein Beitrag, der eine neue Datei oder Beschreibung braucht, wird stattdessen neu geplant.

Failed posts through MCP
list_scheduled_posts { "account_id": "<ACCOUNT_ID>", "status": ["failed"] }

retry_scheduled_post { "post_id": "<POST_ID>" }

// may_be_published is true and the post is not on the account
retry_scheduled_post { "post_id": "<POST_ID>", "confirm": true }

Häufige Fehler

  • Einen Prüfungsfehler mit derselben Datei erneut versuchen. TikTok markiert die Fehler bei Format, Dauer, Bildrate und Bildgröße als nicht wiederholbar.
  • spam_risk_too_many_posts sofort erneut versuchen. TikTok zählt API-Beiträge über 24 Stunden und empfiehlt, über die mobile App zu veröffentlichen.
  • Einen Beitrag mit may_be_published erneut versuchen, ohne nachzusehen. TikTok könnte ihn bereits veröffentlicht haben. Prüfen Sie die neuesten Beiträge des Kontos, sonst geht er doppelt hinaus.
  • Nach fail_reason auf der API for Business suchen. Deren Status-Endpoint nennt das Feld reason; fail_reason gehört zur Content Posting API.
Mit EasyCoexistence

Ein Fehler kommt mit dem Grund von TikTok per E-Mail, auf der Seite Beiträge und als post.failed-Ereignis, bereit zum erneuten Versuch. Von US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit kostenloser Testphase von 3 Tagen.

Häufig gestellte Fragen

Was bedeutet picture_size_check_failed bei TikTok?

TikTok hat den Beitrag heruntergeladen und festgestellt, dass sein Bild unter dem Minimum von 360 Pixeln in Höhe und Breite liegt. Das Bild braucht eine größere Datei, da TikTok den Fehler als nicht wiederholbar markiert.

Was ist video_pull_failed?

TikTok konnte das Video nicht von seiner URL herunterladen oder nicht innerhalb des Timeouts von einer Stunde. Prüfen Sie, ob die URL öffentlich und nicht bandbreitenbegrenzt ist, und versuchen Sie es dann erneut.

Wie lange dauert spam_risk_too_many_posts an?

TikTok zählt die über die API gemachten Beiträge der letzten 24 Stunden, etwa 15 pro Tag und Konto. Bis dahin empfiehlt TikTok, über die mobile TikTok-App zu veröffentlichen.

Versucht easyCoexistence einen fehlgeschlagenen TikTok-Beitrag selbstständig erneut?

Nicht, nachdem TikTok FAILED gemeldet hat. Der Beitrag wartet unter Aufmerksamkeit erforderlich, der Inhaber erhält eine E-Mail, und Erneut versuchen oder retry_scheduled_post sendet ihn erneut.

Weiterlesen

Verbinden Sie Ihren ersten Kanal in zwei Minuten.

Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.

  • 3 Tage kostenlos
  • Jederzeit kündbar
  • Nur offizielle APIs
  • Überwacht rund um die Uhr (24/7)

Verifiziert am