TikTok-posten toevoegen aan je SaaS
Een SaaS voegt TikTok-posten toe door het TikTok-account van elke klant te koppelen via een gehoste link, en daarna easyCoexistence's POST /channels/{id}/posts aan te roepen met één video of 1 tot 35 afbeeldingen en een bijschrift, nu of op een publish_at-tijd tot 90 dagen vooruit. De post gaat via de API for Business van TikTok, die 15 posts per dag per account toestaat, en je backend hoort wanneer hij live is.
Videoposts die TikTok per account publiceert via zijn API for Business, met maximaal zes per minuut.
Grootste video die het publish-endpoint van TikTok accepteert, als MP4, MOV of WebM, 3 tot 600 seconden lang.
Meeste afbeeldingen die één TikTok-fotopost kan bevatten; elk JPG, JPEG of WebP, tot 20 MB.
UTF-16-codeeenheden die de titel van een TikTok-fotopost kan bevatten.
Hoe ver vooruit het posts-endpoint van easyCoexistence een TikTok-post kan inplannen.
Hoe verbindt een klant TikTok?
Via een connect-sessie met channel ingesteld op tiktok. De gehoste pagina toont je naam en Continue with TikTok, wat het eigen toestemmingsscherm van TikTok in hetzelfde tabblad opent. De klant logt in, geeft toegang en komt terecht op je redirect_url met een channel_id. Bewaar die naast je klant, want elke postaanroep noemt het kanaal.
Hoe ziet een TikTok-postverzoek eruit?
Eén POST naar /channels/{id}/posts met het bijschrift in text en het bestand in media. Laat publish_at weg om nu te posten, of zet een ISO 8601-tijd met zijn offset om later te posten. Een post voor nu antwoordt met 201, of met 422 en de reden van TikTok als hij mislukt.
curl -X POST https://easycoexistence.com/api/v1/channels/$CHANNEL_ID/posts \
-H "Authorization: Bearer $EC_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: tt_video_5530" \
-d '{
"text": "Behind the scenes of our new store #opening",
"media": [{ "url": "https://cdn.example.com/store-tour.mp4", "type": "video" }],
"disable_comment": false,
"publish_at": "2026-11-10T18:00:00-05:00"
}'Videopost of fotopost: wat vraagt elk?
Een TikTok-post is één video of een reeks afbeeldingen, nooit beide, en bevat geen link. De tekst, hier tot 2.200 tekens, is op beide het bijschrift. TikToks eigen bestandsregels worden gecontroleerd voordat de post in de wachtrij komt:
| Video post | Photo post | |
|---|---|---|
| Media | One video, MP4, MOV or WebM | 1 to 35 images, JPEG or WebP |
| Size | Up to 1 GB, 3 to 600 seconds, at least 360 px | Up to 20 MB per image |
| Title | None; the caption only | title, up to 90 characters |
| Comments | disable_comment turns them off | disable_comment turns them off |
Waar moet de media staan?
Waar dan ook op HTTPS, of in de opslag van easyCoexistence. TikTok downloadt alleen van URL-prefixen die voor de app zijn geverifieerd, dus easyCoexistence serveert elk bestand vanaf zijn eigen geverifieerde prefix en jij verifieert niets. De media van een ingeplande post wordt gekopieerd op het moment dat je hem inplant: afbeeldingen tot 30 MB en video's tot 1 GB. Een link die sterft vóór de posttijd kan de post dus niet breken. Wil je een bestand uploaden, dan geeft POST /media een media_id terug.
Hoe weet je dat een post live is?
Uit de status van de post en uit events. Een post gaat van scheduled naar publishing, en daarna naar processing terwijl TikTok het bestand downloadt en controleert. easyCoexistence vraagt TikTok elke 20 seconden om de status, tot die de post als voltooid meldt. Je events-URL ontvangt daarna post.published met de post en zijn kanaal, of post.failed met de reden van het netwerk. GET /posts/{id} toont hetzelfde, met network_post_id en permalink zodra de post live is.
Hoe werken wijzigingen, annuleringen en nieuwe pogingen?
Dat kan op de post zolang TikTok hem nog niet heeft. PATCH /posts/{id} wijzigt publish_at, text of title van een ingeplande post. Om de media te wijzigen annuleer je met DELETE /posts/{id} en maak je een nieuwe aan. POST /posts/{id}/retry publiceert een mislukte post opnieuw. Als TikTok binnen 2 uur geen bevestiging geeft, mislukt de post met may_be_published op true, en de nieuwe poging vereist confirm op true.
Wat gebeurt er met reacties na de post?
Ze kunnen je product bereiken. PUT /channels/{id}/webhook stuurt de comment.update-events van TikTok ondertekend door naar je endpoint. Je backend antwoordt onder de reactie via business/comment/reply/create/ van TikTok, met het token uit de credentials-aanroep. Antwoorden op TikTok zijn openbaar, want een TikTok-verbinding heeft geen DM's.
Veelgemaakte fouten
- PNG-afbeeldingen sturen voor een fotopost. TikTok accepteert alleen JPEG of WebP, dus de post wordt geweigerd voordat hij in de wachtrij komt.
- Een titel zetten op een videopost. title is voor fotoposts; een video draagt zijn woorden alleen in het bijschrift.
- Opnieuw proberen met may_be_published op true zonder te kijken. TikTok kan de post al hebben gepubliceerd, dus controleer het account voordat je opnieuw probeert met confirm.
- Meer dan 15 posts per dag plannen voor één account. TikTok begrenst API-posts per account, dus verdeel de kalender van een klant over meerdere dagen.
easyCoexistence voegt TikTok-posten toe aan je SaaS: je klanten verbinden hun TikTok-accounts via een gehoste link, en je backend plaatst video's en fotoposts nu of later, hoort wanneer elk ervan live is en ontvangt de reacties. Dezelfde API dekt WhatsApp, Instagram, Facebook, YouTube, LinkedIn en meer kanalen, en elke verbinding wordt 24/7 bewaakt. Van 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
Kan mijn SaaS TikTok-video's als concepten posten?
Nee. Het posts-endpoint van easyCoexistence publiceert de video direct naar het account, nu of op publish_at. Gebruik inplannen om een post vast te houden tot de klant klaar is.
Laat TikTok me posts inplannen via zijn API?
De publish-endpoints van TikTok handelen op het moment dat ze worden aangeroepen. easyCoexistence houdt de post in zijn wachtrij en roept TikTok aan op publish_at, tot 90 dagen vooruit.
Kan mijn SaaS reacties uitzetten op een TikTok-post?
Ja. Zet disable_comment op true bij de post. Als de eigen instellingen van het account reacties al uitzetten, accepteert TikTok alleen true.
Wat kost easyCoexistence per TikTok-account?
Elk TikTok-account dat je klanten verbinden kost van US$ 9 tot US$ 0.75 per maand, afhankelijk van de schijf van je totaal aantal verbindingen, met een gratis proefperiode van 3 dagen.
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