TikTok-postinstellingen via de API: privacy, reacties, Duet en Stitch
De API for Business van TikTok neemt de instellingen van een post mee in de publicatie-aanroep, meestal binnen post_info. Video's krijgen disable_comment, disable_duet en disable_stitch, een omslagbeeld via thumbnail_offset of custom_thumbnail_url, en de labels is_brand_organic, is_branded_content en is_ai_generated. Fotoposts krijgen privacy_level, disable_comment, dezelfde merklabels en auto_add_music. GET /business/video/settings/ geeft de waarden die elk account toestaat terug.
easyCoexistence publiceert TikTok-video's en fotoposts met publish_tiktok_post vanuit Claude, ChatGPT of je eigen code, met het bijschrift, de titel van een fotopost en reacties aan of uit.
Privacyopties voor fotoposts van een openbaar account: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS en SELF_ONLY.
Privacyniveau dat een privéaccount krijgt in plaats van PUBLIC_TO_EVERYONE: zichtbaar alleen voor de volgers.
Standaard van disable_comment, disable_duet en disable_stitch, dus reacties, Duets en Stitches blijven aan tenzij je dat instelt.
Grootste aangepaste omslagafbeelding voor een video: minimaal 360 x 360 pixels en maximaal 20 MB.
Label is_branded_content wint wanneer is_brand_organic ook waar is.
Verplicht veld van de post_info van een fotopost, beperkt tot de opties die GET /business/video/settings/ voor het account teruggeeft.
Welke instellingen neemt elk publicatie-endpoint?
/business/video/publish/ en /business/photo/publish/ delen sommige instellingen en verschillen op andere. De meeste staan in post_info, terwijl custom_thumbnail_url en photo_cover_index op het hoogste niveau van de body staan. Naast elkaar, zoals de referenties van TikTok ze vermelden, met Geen veld waar een endpoint voor die instelling niets documenteert:
| Video post | Photo post | |
|---|---|---|
| Who sees it | No privacy field: the endpoint publishes public video posts | privacy_level, required |
| Comments | disable_comment | disable_comment |
| Duet and Stitch | disable_duet, disable_stitch | No field |
| Cover | custom_thumbnail_url or thumbnail_offset | photo_cover_index |
| Brand labels | is_brand_organic, is_branded_content | is_brand_organic, is_branded_content |
| AI label | is_ai_generated | No field |
| Music | music_sound_info, video_original_sound_volume | auto_add_music, music_sound_info |
| Location | location_id with location_name | location_id with location_name |
| Draft | upload_to_draft | is_draft |
Wat staat het account toe?
GET /business/video/settings/ met business_id geeft de limieten van het account voor zijn posts terug. Lees dit vóór het publiceren, want TikTok accepteert alleen de waarden die het vermeldt:
privacy_level_options:PUBLIC_TO_EVERYONE,MUTUAL_FOLLOW_FRIENDSenSELF_ONLYvoor een openbaar account;FOLLOWER_OF_CREATOR,MUTUAL_FOLLOW_FRIENDSenSELF_ONLYvoor een privéaccount.comment_disabled: true wanneer het account van niemand reacties aanneemt;disable_commentaccepteert dan alleen true.duet_disabledenstitch_disabled: true wanneer het account Duet of Stitch alleen toestaat van Only you, of privé is; de bijbehorende schakelaar accepteert dan alleen true.max_video_post_duration_sec: de langste video die het account kan publiceren; een langere mislukt.
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/video/settings/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>'
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"comment_disabled": false,
"duet_disabled": false,
"max_video_post_duration_sec": 600,
"privacy_level_options": ["PUBLIC_TO_EVERYONE", "MUTUAL_FOLLOW_FRIENDS", "SELF_ONLY"],
"stitch_disabled": false
}
}Wie kan de post zien?
Bij een fotopost de privacy_level die je stuurt: PUBLIC_TO_EVERYONE voor mensen op of buiten TikTok, MUTUAL_FOLLOW_FRIENDS voor volgers die het account terugvolgt, FOLLOWER_OF_CREATOR voor de volgers van een privéaccount, of SELF_ONLY. Het videoendpoint heeft geen privacyveld, omdat het openbare videoposts publiceert. Een post die op Friends of Only you staat, kan ook niet via zijn embed_url worden bekeken.
Hoe werken reacties, Duet en Stitch?
Elk is een schakelaar die een functie uitzet wanneer die op true staat. disable_comment bestaat op beide endpoints; disable_duet en disable_stitch alleen op video's. Alle staan standaard op false, wat de functie aanlaat binnen wat de eigen privacyinstellingen van het account toestaan: een account dat van niemand reacties aanneemt, of dat Duet of Stitch beperkt tot Only you, kan alleen publiceren met die schakelaar op true.
Hoe wordt het omslagbeeld gekozen?
Bij een video op twee manieren. post_info.thumbnail_offset kiest een frame op zijn tijd in milliseconden, standaard 0, afgerond naar het dichtstbijzijnde frame; een tijd na het einde van de video stuurt een failure-webhook en de video wordt niet gepubliceerd. custom_thumbnail_url, op het hoogste niveau van de body, geeft in plaats daarvan een afbeelding en zorgt dat TikTok de offset negeert. Bij een fotopost kiest photo_cover_index een van de afbeeldingen, te tellen vanaf 0.
- Aangepaste omslagafbeelding: JPG, JPEG, WebP of PNG, tot 20 MB.
- Formaat: van 360 x 360 pixels tot 1080 x 1920, of 1920 x 1080.
- Locatie: een domein of URL-prefix dat voor de app is geverifieerd, net als de video zelf.
Wat betekenen de merklabels?
Vermeldingen die TikTok op de post toont. is_brand_organic op true labelt hem als Promotional content, voor posts die het eigen bedrijf van het account promoten. is_branded_content op true labelt hem als Paid partnership, voor posts die in een betaald partnerschap met een merk zijn gemaakt, en dit label heeft voorrang wanneer beide waar zijn. Bij een video met is_branded_content kan tto_invite_link de post koppelen aan een TikTok One Creator Marketplace-campagne waar het account aan deelneemt.
Welke andere opties staan in post_info?
Nog een paar, elk gedocumenteerd op het endpoint dat het gebruikt:
is_ai_generated, video's: labelt de post als Creator labeled as AI-generated, wat na publicatie niet meer te wijzigen is.location_idmetlocation_name: een locatietag die is gevonden via GET /business/publish/location/.music_sound_info: een commercieel geluid op ID; bij video's ook het volume, 0 tot 100, en het begin en einde in milliseconden.auto_add_music, fotoposts: voegt aanbevolen muziek toe, die later in de TikTok-app kan worden gewijzigd.upload_to_draftofis_draft: stuurt de post met de video als concept naar de inbox van de maker, met de video.upload-scope.is_ads_only, video's: publiceert een Only show in ads-post die niet op het profiel blijft staan.
Welke instellingen zet publish_tiktok_post?
Drie komen uit je verzoek: het bijschrift, de titel van een fotopost en disable_comment. easyCoexistence stuurt is_brand_organic en is_branded_content als false, publiceert fotoposts als PUBLIC_TO_EVERYONE met de eerste afbeelding als omslag, en laat de rest van de instellingen van een video weg, zodat de standaarden van TikTok gelden: disable_duet en disable_stitch false, thumbnail_offset 0 en is_ai_generated false.
Hoe stuur je de andere instellingen?
Vanuit je eigen code, met het token en het business_id van het account uit get_social_credentials, op Business API-paden onder business/. Een GET naar business/video/settings/ leest de limieten van het account. Een POST naar business/video/publish/ of business/photo/publish/ kan de volledige gedocumenteerde body bevatten, en die gaat ongewijzigd naar TikTok, inclusief de media-URL's. Die moeten dus op een domein of URL-prefix staan dat voor de app is geverifieerd. publish_tiktok_post is de aanroep die je link door de geverifieerde mediaroute van easyCoexistence stuurt.
GET https://business-api.tiktok.com/open_api/v1.3/business/video/settings/?business_id=<BUSINESS_ID>
Access-Token: <ACCESS_TOKEN>Veelgemaakte fouten
- privacy_level verwachten op een video. Het videoendpoint publiceert openbare posts en de referentie vermeldt geen privacyveld; fotoposts nemen privacy_level wel.
- Reacties aanzetten voor een account dat er geen toestaat. Wanneer comment_disabled true is, accepteert TikTok disable_comment alleen als true.
- thumbnail_offset zetten voorbij het einde van de video. TikTok stuurt een failure-webhook en de video wordt niet gepubliceerd.
- PUBLIC_TO_EVERYONE sturen voor een privéaccount. Zijn privacy_level_options bevatten in plaats daarvan FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS en SELF_ONLY.
get_social_credentials geeft je eigen code het token om de toegestane instellingen van het account te lezen. Van US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met de eerste 3 dagen als gratis proefperiode.
Veelgestelde vragen
Kan ik een privé TikTok-video via de API publiceren?
Niet met het videoendpoint, dat openbare posts publiceert. Fotoposts nemen privacy_level, ook SELF_ONLY, en een video kan met upload_to_draft als concept naar de inbox van de maker gaan.
Hoe zet ik Duets en Stitches via de API uit?
Zet post_info.disable_duet en post_info.disable_stitch op true op /business/video/publish/. Als het account ze al beperkt, accepteert TikTok alleen true.
Kan ik via de TikTok API een locatietag toevoegen?
Ja. post_info neemt location_id met location_name, voor een locatietag die via GET /business/publish/location/ is gevonden.
Wat is het verschil tussen is_brand_organic en is_branded_content?
is_brand_organic voegt een Promotional content-label toe voor het eigen bedrijf van het account; is_branded_content voegt een Paid partnership-label toe en wint wanneer beide waar zijn.
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