TikTok-Beitragseinstellungen über die API: Sichtbarkeit, Kommentare, Duet und Stitch
Die TikTok API for Business nimmt die Einstellungen eines Beitrags im Publish-Aufruf entgegen, meist innerhalb von post_info. Bei Videos gibt es disable_comment, disable_duet und disable_stitch, ein Cover über thumbnail_offset oder custom_thumbnail_url, die Labels is_brand_organic und is_branded_content sowie is_ai_generated. Fotobeiträge nehmen privacy_level, disable_comment, dieselben Marken-Labels und auto_add_music entgegen. GET /business/video/settings/ liefert die Werte, die jedes Konto erlaubt.
easyCoexistence veröffentlicht TikTok-Videos und Fotobeiträge mit publish_tiktok_post aus Claude, ChatGPT oder Ihrem eigenen Code, mit Bildunterschrift, Titel eines Fotobeitrags und ein- oder ausgeschalteten Kommentaren, und get_social_credentials gibt Ihrem eigenen Code das Token, um die erlaubten Einstellungen des Kontos zu lesen.
Sichtbarkeitsoptionen für Fotobeiträge eines öffentlichen Kontos: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS und SELF_ONLY.
Sichtbarkeitsstufe, die ein privates Konto anstelle von PUBLIC_TO_EVERYONE erhält: nur für seine Follower sichtbar.
Standard von disable_comment, disable_duet und disable_stitch: Kommentare, Duets und Stitches bleiben aktiv, solange nichts anderes gesetzt ist.
Größtes benutzerdefiniertes Cover-Bild für ein Video: mindestens 360 x 360 Pixel, bis zu 20 MB.
Das Label, das is_branded_content anfügt, setzt sich durch, wenn auch is_brand_organic true ist.
Pflichtfeld in post_info eines Fotobeitrags, beschränkt auf die Optionen, die GET /business/video/settings/ für das Konto liefert.
Welche Einstellungen nimmt jeder Publish-Endpunkt an?
/business/video/publish/ und /business/photo/publish/ teilen sich einige Einstellungen und unterscheiden sich bei anderen. Die meisten stehen in post_info, während custom_thumbnail_url und photo_cover_index auf oberster Ebene des Body liegen. Nebeneinander, so wie TikTok sie in den Referenzen auflistet, wobei „No field“ bedeutet, dass der Endpunkt für diese Einstellung nichts dokumentiert:
| 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 |
Was erlaubt das Konto?
GET /business/video/settings/ mit business_id liefert die Grenzen, die das Konto für seine Beiträge hat. Lesen Sie sie vor dem Veröffentlichen, da TikTok nur die aufgelisteten Werte akzeptiert:
privacy_level_options:PUBLIC_TO_EVERYONE,MUTUAL_FOLLOW_FRIENDSundSELF_ONLYfür ein öffentliches Konto;FOLLOWER_OF_CREATOR,MUTUAL_FOLLOW_FRIENDSundSELF_ONLYfür ein privates.comment_disabled: true, wenn das Konto von niemandem Kommentare annimmt. Dann akzeptiertdisable_commentnur true.duet_disabledundstitch_disabled: true, wenn das Konto Duet oder Stitch nur mit „Only you“ erlaubt oder das Konto privat ist. Der passende Schalter akzeptiert dann nur true.max_video_post_duration_sec: das längste Video, das das Konto veröffentlichen kann; ein längeres schlägt fehl.
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
}
}Wer kann den Beitrag sehen?
Bei einem Fotobeitrag bestimmt das gesendete privacy_level die Sichtbarkeit: PUBLIC_TO_EVERYONE für Personen auf oder außerhalb von TikTok, MUTUAL_FOLLOW_FRIENDS für Follower, denen das Konto zurückfolgt, FOLLOWER_OF_CREATOR für die Follower eines privaten Kontos oder SELF_ONLY. Der Video-Endpunkt hat kein Feld für die Sichtbarkeit, da er öffentliche Videobeiträge veröffentlicht. Ein Beitrag, der auf Friends oder Only you gestellt ist, lässt sich auch über seine embed_url nicht ansehen.
Wie funktionieren Kommentare, Duet und Stitch?
Jede Option ist ein Schalter, der die Funktion abschaltet, wenn er auf true steht. disable_comment gibt es an beiden Endpunkten; disable_duet und disable_stitch nur bei Videos. Alle stehen standardmäßig auf false, sodass die Funktion aktiv bleibt, soweit es die Datenschutzeinstellungen des Kontos erlauben. Ein Konto, das von niemandem Kommentare annimmt oder Duet bzw. Stitch nur mit „Only you“ zulässt, kann nur mit dem jeweiligen Schalter auf true veröffentlichen.
Wie wird das Cover gewählt?
Bei einem Video auf zwei Arten. post_info.thumbnail_offset wählt ein Bild anhand seiner Zeit in Millisekunden, standardmäßig 0, und rundet auf das nächste Bild auf. Eine Zeit hinter dem Ende des Videos löst einen Fehler-Webhook aus, und das Video wird nicht veröffentlicht. custom_thumbnail_url auf oberster Ebene des Body gibt stattdessen ein Bild vor und sorgt dafür, dass TikTok den Offset ignoriert. Bei einem Fotobeitrag wählt photo_cover_index eines der Bilder, gezählt ab 0.
- Eigenes Cover-Bild: JPG, JPEG, WebP oder PNG, bis zu 20 MB.
- Größe: ab 360 x 360 Pixel bis 1080 x 1920 oder 1920 x 1080.
- Speicherort: eine für die App verifizierte Domain oder ein URL-Präfix, wie beim Video selbst.
Was bedeuten die Marken-Labels?
Hinweise, die TikTok am Beitrag anzeigt. is_brand_organic mit true kennzeichnet ihn als „Promotional content“, bei Beiträgen, die das eigene Geschäft des Kontos bewerben. is_branded_content mit true kennzeichnet ihn als „Paid partnership“, bei Beiträgen aus einer bezahlten Partnerschaft mit einer Marke, und hat Vorrang, wenn beide true sind. Bei einem Video mit is_branded_content kann tto_invite_link den Beitrag mit einer Kampagne im TikTok One Creator Marketplace verknüpfen, der das Konto beigetreten ist.
Welche weiteren Optionen gibt es in post_info?
Einige weitere, jeweils dokumentiert am Endpunkt, der sie annimmt:
is_ai_generated, bei Videos: kennzeichnet den Beitrag als „Creator labeled as AI-generated“, was sich nach der Veröffentlichung nicht mehr ändern lässt.location_idmitlocation_name: ein Ortsmarker, der über GET /business/publish/location/ gefunden wird.music_sound_info: ein kommerzieller Sound über seine ID; bei Videos außerdem seine Lautstärke (0 bis 100) sowie Start und Ende in Millisekunden.auto_add_music, bei Fotobeiträgen: fügt empfohlene Musik hinzu, die sich später in der TikTok-App ändern lässt.upload_to_draftoderis_draft: sendet den Beitrag mit dem Video als Entwurf in den Posteingang des Creators, mit dem Scope video.upload.is_ads_only, bei Videos: veröffentlicht einen Beitrag „Only show in ads“, der nicht auf dem Profil erscheint.
Welche Einstellungen setzt publish_tiktok_post?
Drei kommen aus Ihrer Anfrage: die Bildunterschrift, der Titel eines Fotobeitrags und disable_comment. easyCoexistence sendet is_brand_organic und is_branded_content als false, veröffentlicht Fotobeiträge als PUBLIC_TO_EVERYONE mit dem ersten Bild als Cover und lässt den Rest der Videoeinstellungen weg, sodass die Standardwerte von TikTok gelten: disable_duet und disable_stitch false, thumbnail_offset 0 und is_ai_generated false.
Wie senden Sie die anderen Einstellungen?
Aus Ihrem eigenen Code, mit dem Token und der business_id des Kontos aus get_social_credentials, auf Pfaden der Business API unter business/. Ein GET auf business/video/settings/ liest die Grenzen des Kontos. Ein POST auf business/video/publish/ oder business/photo/publish/ kann den vollständigen dokumentierten Body enthalten und geht unverändert an TikTok, einschließlich der Medien-URLs. Diese müssen daher auf einer für die App verifizierten Domain oder einem URL-Präfix liegen. publish_tiktok_post ist der Aufruf, der Ihren Link über die verifizierte Medienroute von easyCoexistence leitet.
GET https://business-api.tiktok.com/open_api/v1.3/business/video/settings/?business_id=<BUSINESS_ID>
Access-Token: <ACCESS_TOKEN>Häufige Fehler
- privacy_level bei einem Video erwarten. Der Video-Endpunkt veröffentlicht öffentliche Beiträge, und seine Referenz listet kein Feld für die Sichtbarkeit; Fotobeiträge nehmen privacy_level an.
- Kommentare für ein Konto aktivieren, das keine annimmt. Ist comment_disabled true, akzeptiert TikTok disable_comment nur als true.
- thumbnail_offset hinter das Ende des Videos setzen. TikTok sendet einen Fehler-Webhook, und das Video wird nicht veröffentlicht.
- PUBLIC_TO_EVERYONE für ein privates Konto senden. Dessen privacy_level_options listen stattdessen FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS und SELF_ONLY.
Ab US$ 9 bis hinab zu US$ 0.75 pro Verbindung und Monat, mit jeder weiteren Verbindung günstiger, und 3 Tage kostenlose Testphase.
Häufig gestellte Fragen
Kann ich ein privates TikTok-Video über die API veröffentlichen?
Nicht mit dem Video-Endpunkt, der öffentliche Beiträge veröffentlicht. Fotobeiträge nehmen privacy_level an, einschließlich SELF_ONLY, und ein Video kann mit upload_to_draft als Entwurf in den Posteingang des Creators gehen.
Wie schalte ich Duets und Stitches über die API ab?
Setzen Sie post_info.disable_duet und post_info.disable_stitch auf /business/video/publish/ auf true. Begrenzt das Konto sie bereits, akzeptiert TikTok nur true.
Kann ich über die TikTok API einen Ortsmarker setzen?
Ja. post_info nimmt location_id mit location_name an, für einen Ortsmarker, der über GET /business/publish/location/ gefunden wird.
Was ist der Unterschied zwischen is_brand_organic und is_branded_content?
is_brand_organic fügt das Label „Promotional content“ für das eigene Geschäft des Kontos hinzu; is_branded_content fügt das Label „Paid partnership“ hinzu und setzt sich durch, wenn beide true sind.
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