So prüfen Sie den Veröffentlichungsstatus eines TikTok-Beitrags über die API
TikTok veröffentlicht API-Beiträge asynchron: Der Veröffentlichungsaufruf liefert eine share_id, und GET /business/publish/status/ mit dieser ID als publish_id zeigt, wo der Beitrag steht. Der Status lautet PROCESSING_DOWNLOAD, solange TikTok die Datei abruft, PUBLISH_COMPLETE, sobald der Beitrag die Moderation durchlaufen hat und veröffentlicht wurde, oder FAILED mit einem Grund wie frame_rate_check_failed.
easyCoexistence veröffentlicht mit publish_tiktok_post auf TikTok und verfolgt jeden Beitrag mit get_tiktok_publish_status, aus Claude, ChatGPT oder Ihrem eigenen Code.
Wie lange Post-IDs nach PUBLISH_COMPLETE auf sich warten lassen können; TikTok empfiehlt, nach drei Minuten erneut abzufragen, wenn sie fehlen.
Die allgemeine Schätzung von TikTok für den Download einer Beitragsdatei mit 1 GB; die tatsächliche Dauer hängt von Größe und Netzwerk ab.
Übliche längste Wartezeit, nachdem der Upload abgeschlossen ist, bis ein Beitrag öffentlich wird; die manuelle Moderation kann länger dauern.
Download-Timeout, nach dem TikTok einen Beitrag mit video_pull_failed oder photo_pull_failed fehlschlagen lässt.
Warum muss ein TikTok-Beitrag verfolgt werden?
Weil TikTok ihn im Hintergrund veröffentlicht. Der Veröffentlichungsaufruf startet eine Aufgabe und liefert sofort eine share_id zurück. TikTok lädt die Datei dann von ihrer URL herunter, prüft das Format, führt die Moderation durch und macht den Beitrag öffentlich. Ein Beitrag kann auch dann noch fehlschlagen, wenn der Aufruf selbst erfolgreich war.
Welche Status gibt es?
GET /business/publish/status/ nimmt die business_id des Kontos und die share_id als publish_id entgegen und gibt einen von vier Status zurück:
PROCESSING_DOWNLOAD: TikTok lädt den Inhalt von seiner URL herunter.PUBLISH_COMPLETE: Der Beitrag hat die Moderation durchlaufen und wurde veröffentlicht;post_idslistet ihn, sobald er öffentlich sichtbar ist.- FAILED: Die Veröffentlichung wurde abgebrochen, reason nennt den Grund.
SEND_TO_USER_INBOX: Ein Entwurf wurde hochgeladen und TikTok hat den Posteingang des Erstellers benachrichtigt; dies gilt nur für Entwürfe.
Wie lange dauert die Veröffentlichung?
TikTok nennt keine feste Zeit. Der Download hängt von der Dateigröße und dem Netzwerk ab. Laut der allgemeinen Schätzung von TikTok reichen 30 Minuten für eine Datei mit 1 GB, eine Stunde ist die Grenze. Danach wird ein Beitrag in der Regel innerhalb von 2 Minuten öffentlich, bei manueller Moderation auch später. Seine Post-ID kann bis zu drei weitere Minuten brauchen, bis sie im Status erscheint.
Was bedeuten die Fehlergründe?
reason nennt, was den Beitrag gestoppt hat. Manche bedeuten, dass sich die Datei ändern muss, andere, dass ein erneuter Versuch funktionieren kann:
file_format_check_failed,duration_check_failed,frame_rate_check_failed,picture_size_check_failed: Die Datei verletzt eine Formatregel; TikTok kennzeichnet diese als nicht wiederholbar.video_pull_failed,photo_pull_failed: TikTok konnte die Datei nicht herunterladen oder nicht innerhalb der Stunde; wiederholen Sie den Versuch, sobald die URL öffentlich erreichbar ist.- internal: Ein Teil des Dienstes von TikTok war nicht verfügbar; ein erneuter Versuch ist möglich.
spam_risk_too_many_posts,spam_risk,spam_risk_text: TikTok hat den Beitrag wegen des Volumens, des Verhaltens oder des Inhalts der Bildunterschrift gestoppt.auth_removed: Das Konto hat die Zugriffsrechte der App während der Verarbeitung entzogen; TikTok rät davon ab, es erneut zu versuchen.spam_risk_user_banned_from_posting: Das Konto ist vom Erstellen neuer Beiträge gesperrt.
Wofür dient die Post-ID?
Um den Beitrag später wiederzufinden. Die Referenz von TikTok übergibt Post-IDs in filters.video_ids an /business/video/list/, um die Kennzahlen der Beiträge abzurufen. Kommentar-Aufrufe nehmen dagegen die item_id eines Beitrags aus der Videoliste des Kontos als video_id entgegen; das ist auch der Wert, den die Kommentar-Werkzeuge von easyCoexistence als post_id entgegennehmen.
Wie verfolgt easyCoexistence einen Beitrag?
publish_tiktok_post gibt die share_id von TikTok zurück, zusammen mit dem Hinweis, dass TikTok den Beitrag verarbeitet. get_tiktok_publish_status nimmt diese share_id und gibt den aktuellen Status von TikTok zurück, mit dem Grund, falls vorhanden. Bitten Sie Ihre KI, nach einigen Minuten erneut zu prüfen, statt sofort.
Häufige Fehler
- Erneut veröffentlichen, weil noch nichts angezeigt wird. Der erste Aufruf hat nur die Aufgabe gestartet. Prüfen Sie daher ihren Status, bevor Sie den Beitrag ein zweites Mal senden.
- PUBLISH_COMPLETE ohne post_ids als Fehler werten. Die IDs können bis zu drei Minuten länger brauchen. Prüfen Sie dann erneut.
- Einen Formatfehler mit derselben Datei wiederholen. file_format_check_failed und die übrigen Prüfungsfehler erfordern eine korrigierte Datei.
- Die URL während des Downloads deaktivieren. TikTok lässt den Beitrag mit video_pull_failed oder photo_pull_failed fehlschlagen, wenn die Datei nicht abgerufen werden kann.
So sieht Ihre KI den Status von TikTok und jeden Fehlergrund so, wie er gerade ist. Von US$ 9 bis US$ 0.75 pro Verbindung und Monat, mit sinkendem Preis je weiterer Verbindung, die ersten 3 Tage kostenlos.
Häufig gestellte Fragen
Was ist eine share_id bei TikTok?
Die ID einer Veröffentlichungsaufgabe, die von den Video- und Foto-Endpoints zurückgegeben wird. Sie wird im Statusaufruf als publish_id übergeben.
Gibt es einen Webhook für den Veröffentlichungsstatus bei TikTok?
Ja. Eine App, die über /business/webhook/update/ mit event_type VIDEO abonniert ist, erhält die Ereignisse zur Veröffentlichung von Beiträgen, etwa post.publish.failed mit seinem Grund und publish_id, anstatt wiederholt den Status abzufragen.
Warum hat ein veröffentlichter Beitrag noch keine Post-ID?
TikTok kann nach PUBLISH_COMPLETE bis zu drei Minuten brauchen, um post_ids zurückzugeben, und liefert sie nur für öffentlich sichtbare Beiträge.
Kann ein fehlgeschlagener TikTok-Beitrag erneut veröffentlicht werden?
Je nach Grund. Download- und interne Fehler lassen sich wiederholen; Fehler bei Format, Dauer, Bildrate und Bildgröße erfordern eine korrigierte Datei.
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