TikTok-fotoposts en carrousels via de API: tot 35 afbeeldingen
De API for Business van TikTok publiceert een fotopost van 1 tot 35 afbeeldingen, elk een JPG-, JPEG- of WebP-bestand van maximaal 20 MB en niet groter dan 1080 bij 1920 pixels, in beide oriëntaties. TikTok downloadt deze van een geverifieerde URL. De post krijgt een titel van maximaal 90 tekens, een bijschrift, een privacyniveau en een omslagafbeelding.
easyCoexistence publiceert TikTok-fotoposts met publish_tiktok_post vanuit Claude, ChatGPT of je eigen code: geef 1 tot 35 afbeeldingslinks, een titel en een bijschrift mee, en volg de post daarna met get_tiktok_publish_status.
Het grootste aantal afbeeldingen dat een fotopost kan bevatten via het photo publish-endpoint van TikTok.
Grootste bestandsgrootte per afbeelding in een fotopost, die JPG, JPEG of WebP moet zijn.
Hoogste afbeeldingsresolutie in pixels voor een fotopost, of 1920 x 1080 voor een liggende afbeelding.
UTF-16-codeeenheden die de titel van een fotopost kan bevatten; het bijschrift telt tot 4.000.
Wat gaat er in een fotopost?
Eén aanroep naar POST /business/photo/publish/ bevat de afbeeldingen en de gegevens van de post:
photo_images: tot 35 afbeeldings-URL's op een geverifieerd domein of URL-prefix.photo_cover_index: de afbeelding die als omslag dient, geteld vanaf 0, wat de standaard is.post_info.title: tot 90 UTF-16-codeeenheden.post_info.caption: tot 4.000 UTF-16-codeeenheden, met #hashtags en maximaal 30 @vermeldingen.post_info.privacy_level: wie de post kan zien, binnen de opties die de instellingen van het account toestaan.post_info.disable_comment: schakelt reacties uit op de post.
Welke afbeeldingsbestanden werken?
JPG, JPEG of WebP, elk tot 20 MB en niet groter dan 1080 bij 1920 pixels, of 1920 bij 1080 voor een liggende afbeelding. TikTok controleert het formaat pas na het downloaden van het bestand, dus een niet-ondersteund bestand faalt later met file_format_check_failed. publish_tiktok_post weigert links die eindigen op .png, .gif, .bmp, .heic, .avif of .svg voordat er iets wordt verstuurd.
Wat is het verschil tussen de titel en het bijschrift?
Het zijn aparte velden met aparte limieten. De titel bevat tot 90 UTF-16-codeeenheden. Het bijschrift is de beschrijving van de post, tot 4.000, en kan #hashtags en @vermeldingen bevatten van de wederzijdse volgers van het account, maximaal 30. Beide worden geteld in UTF-16-codeeenheden, zodat een emoji er twee of meer kan tellen. publish_tiktok_post neemt ze over als title en caption.
Wie ziet de post, en kunnen mensen reageren?
privacy_level bepaalt wie de post ziet: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR of SELF_ONLY, binnen de opties die GET /business/video/settings/ voor het account teruggeeft. TikTok biedt PUBLIC_TO_EVERYONE alleen aan voor openbare accounts, en dat is het niveau dat publish_tiktok_post instelt. Reacties staan aan tenzij disable_comment true is, en een account dat van niemand reacties aanneemt, accepteert alleen true.
Wat gebeurt er na de aanroep?
TikTok geeft een share_id terug en downloadt de afbeeldingen op de achtergrond. get_tiktok_publish_status gebruikt die share_id en meldt PROCESSING_DOWNLOAD terwijl TikTok de afbeeldingen ophaalt, PUBLISH_COMPLETE zodra de post de moderatie heeft doorstaan, of FAILED met een reden zoals photo_pull_failed. TikTok beperkt fotoposts via dit endpoint tot zes per minuut en 15 per dag per account.
Veelgemaakte fouten
- PNG-afbeeldingen versturen. TikTok-fotoposts accepteren alleen JPG, JPEG of WebP, dus converteer de bestanden voordat je publiceert.
- De titel tellen in tekens zoals je ze ziet. TikTok telt UTF-16-codeeenheden, dus een titel met emoji bereikt de 90 sneller.
- Afbeeldingen groter dan 1080 bij 1920 pixels gebruiken. Dat is de grootste resolutie die TikTok voor fotoposts toestaat, dus verklein grotere afbeeldingen eerst.
- De omslag ergens anders dan vooraan plaatsen. publish_tiktok_post gebruikt de eerste afbeelding als omslag.
Fotoposts kunnen ook op een datum en tijd die je instelt worden verstuurd, vanuit de eigen wachtrij. 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
Hoeveel foto's kan een TikTok-post via de API hebben?
Tot 35, elk een JPG-, JPEG- of WebP-bestand van maximaal 20 MB.
Kan een TikTok-fotopost PNG-afbeeldingen gebruiken?
Nee. Het fotoendpoint accepteert JPG, JPEG en WebP, en TikTok laat een PNG na het downloaden mislukken, met file_format_check_failed.
Hoe lang mag de titel van een fotopost zijn?
Tot 90 UTF-16-codeeenheden. Het bijschrift is een apart veld en telt tot 4.000.
Welke afbeelding wordt de omslag?
De afbeelding waarnaar photo_cover_index verwijst, geteld vanaf 0. publish_tiktok_post laat die op 0 staan, dus de eerste afbeelding is de omslag.
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