InloggenGratis proefperiode starten
easyCoexistence Officiële API's

Zo controleer je de publicatiestatus van een TikTok-post via de API

TikTok publiceert API-posts asynchroon: de publicatie-aanroep geeft een share_id terug, en GET /business/publish/status/ met die ID als publish_id laat zien waar de post staat. De status is PROCESSING_DOWNLOAD zolang TikTok het bestand ophaalt, PUBLISH_COMPLETE zodra de post de moderatie heeft doorstaan en gepubliceerd is, of FAILED met een reden zoals frame_rate_check_failed.

easyCoexistence publiceert naar TikTok met publish_tiktok_post en volgt elke post met get_tiktok_publish_status, vanuit Claude, ChatGPT of je eigen code, zodat je AI de status van TikTok en elke foutreden ziet zoals die er op dat moment uitziet.

3 min

Hoe lang post-ID's na PUBLISH_COMPLETE kunnen duren; TikTok adviseert na drie minuten opnieuw te proberen als ze ontbreken.

30 min

De algemene inschatting van TikTok voor het downloaden van een postbestand van 1 GB; de echte tijd hangt af van grootte en netwerk.

2 min

De gebruikelijke maximale wachttijd, na het voltooien van de upload, voordat een post openbaar wordt; handmatige moderatie kan langer duren.

1 hour

Downloadtimeout waarna TikTok een post afwijst met video_pull_failed of photo_pull_failed.

Waarom moet je een TikTok-post volgen?

Omdat TikTok de post op de achtergrond publiceert. De publicatie-aanroep start een taak en geeft meteen een share_id terug; TikTok haalt daarna het bestand van de URL op, controleert het formaat, voert moderatie uit en maakt de post openbaar. Een post kan nog mislukken nadat de aanroep zelf is geslaagd.

Welke statussen zijn er?

GET /business/publish/status/ neemt de business_id van het account en de share_id als publish_id, en geeft een van vier statussen terug:

  • PROCESSING_DOWNLOAD: TikTok downloadt de inhoud van de URL.
  • PUBLISH_COMPLETE: de post is door de moderatie heen en gepubliceerd; post_ids bevat de ID's zodra de post openbaar zichtbaar is.
  • FAILED: de publicatie is gestopt, en reason geeft aan waarom.
  • SEND_TO_USER_INBOX: een concept is geüpload en de inbox van de maker is door TikTok op de hoogte gebracht; dit geldt alleen voor concepten.

Hoe lang duurt publiceren?

TikTok geeft geen vaste tijd. Het downloaden hangt af van de bestandsgrootte en het netwerk; de algemene inschatting van TikTok is dat 30 minuten genoeg is voor een bestand van 1 GB, met een uur als limiet. Daarna wordt een post meestal binnen 2 minuten openbaar, of later als handmatige moderatie nodig is, en de post-ID kan nog tot drie minuten extra duren voordat hij in de status verschijnt.

Wat betekenen de foutredenen?

reason geeft aan wat de post heeft gestopt. Sommige betekenen dat het bestand moet veranderen, andere dat opnieuw proberen kan werken:

  • file_format_check_failed, duration_check_failed, frame_rate_check_failed, picture_size_check_failed: het bestand breekt een formaatregel, en TikTok markeert deze als niet-herhaalbaar.
  • video_pull_failed, photo_pull_failed: TikTok kon het bestand niet downloaden, of niet binnen het uur; probeer opnieuw zodra de URL publiek bereikbaar is.
  • internal: een deel van de dienst van TikTok was niet beschikbaar, en opnieuw proberen is prima.
  • spam_risk_too_many_posts, spam_risk, spam_risk_text: TikTok heeft de post gestopt vanwege het volume, het gedrag of de inhoud van het bijschrift.
  • auth_removed: het account heeft de toegang van de app ingetrokken tijdens de verwerking, en TikTok adviseert niet opnieuw te proberen.
  • spam_risk_user_banned_from_posting: het account is geblokkeerd voor het maken van nieuwe posts.

Waarvoor dient de post-ID?

Om de post later terug te vinden. De referentie van TikTok geeft post-ID's door aan /business/video/list/ in filters.video_ids om de statistieken van de posts uit te lezen. Reactie-aanroepen nemen op hun beurt de item_id van een post uit de videolijst van het account als video_id, wat ook is wat de reactietools van easyCoexistence als post_id gebruiken.

Hoe volgt easyCoexistence een post?

publish_tiktok_post geeft de share_id van TikTok terug met de melding dat TikTok de post verwerkt, en get_tiktok_publish_status neemt die share_id en geeft de huidige status van TikTok terug, met de reden wanneer die er is. Vraag je AI na een paar minuten opnieuw te controleren in plaats van meteen.

Veelgemaakte fouten

  • Opnieuw publiceren omdat er nog niets verscheen. De eerste aanroep startte alleen de taak, dus controleer de status voordat je de post nogmaals verstuurt.
  • PUBLISH_COMPLETE zonder post_ids als fout zien. De ID's kunnen tot drie minuten langer duren, dus controleer dan opnieuw.
  • Een formatfout opnieuw proberen met hetzelfde bestand. file_format_check_failed en de andere controlefouten vragen om een gecorrigeerd bestand.
  • De URL offline halen tijdens het downloaden. TikTok wijst de post af met video_pull_failed of photo_pull_failed wanneer het bestand niet kan worden opgehaald.
Dit doen met EasyCoexistence

US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met een gratis proefperiode van 3 dagen.

Veelgestelde vragen

Wat is een share_id bij TikTok?

De ID van een publicatietaak, teruggegeven door de endpoints voor het publiceren van video's en foto's. Die gaat als publish_id de statusaanroep in.

Is er een webhook voor de publicatiestatus van TikTok?

Ja. Een app die via /business/webhook/update/ is geabonneerd met event_type VIDEO ontvangt de publicatie-events van TikTok, zoals post.publish.failed met de reden en publish_id, in plaats van herhaalde statuscontroles.

Waarom heeft een gepubliceerde post nog geen post-ID?

TikTok kan tot drie minuten na PUBLISH_COMPLETE nodig hebben om post_ids terug te geven, en geeft ze alleen voor openbaar zichtbare posts.

Kan een mislukte TikTok-post opnieuw worden geprobeerd?

Dat hangt af van de reden. Download- en interne fouten kunnen opnieuw worden geprobeerd; fouten bij formaat, duur, framesnelheid en beeldgrootte vragen om een gecorrigeerd bestand.

Lees verder

Koppel je eerste kanaal in twee minuten.

Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.

  • 3 dagen gratis
  • Op elk moment opzegbaar
  • Alleen officiële API's
  • 24/7 bewaakt

Geverifieerd op