TikTok: posztolási szabályok és beállítások
Mit fogad el a TikTok csatorna a Postyban: média, korlátok, kötelező mezők, és a settings objektum mezői az API-hoz.
Eckdaten
tiktokBeitragstypen
Derselbe Kanal akzeptiert mehrere Beitragstypen. Jeder verlangt etwas anderes. Die Tabelle zeigt, was du wofür brauchst.
| Typ | Medien | Hinweis |
|---|---|---|
| Video, Veröffentlichung | 1 Video | content_posting_method: DIRECT_POST. Das ist die Variante, die wirklich veröffentlicht. |
| Fotobeitrag | 1 oder mehr Bilder | Duet, Stitch und die KI-Kennzeichnung gelten bei Fotos nicht. |
| In den Posteingang schicken | 1 Video | content_posting_method: UPLOAD. Du musst es innerhalb von 24 Stunden manuell fertigstellen. |
Regeln
- Der Veröffentlichungsmodus entscheidet, was passiert. DIRECT_POST veröffentlicht den Beitrag wirklich. UPLOAD legt ihn nur in den Posteingang der TikTok-App des Nutzers. Dort muss er ihn innerhalb von 24 Stunden von Hand fertigstellen, sonst ist er weg.
- Im UPLOAD-Modus verwirft TikTok jede Einstellung außer dem Titel.
- Die Sichtbarkeit hat absichtlich keinen Standardwert: laut TikTok-Richtlinie muss der Veröffentlicher wählen.
- Duett, Stitch und die KI-Kennzeichnung gelten nur bei Video. Bei einem TikTok-Fotobeitrag werden sie nicht berücksichtigt.
Einstellungsfelder
Diese Felder kommen in das settings-Objekt des Beitrags, neben das Feld __type. In der Oberfläche füllst du dieselben im Einstellungsbereich des Kanals aus.
| Feld | Typ | Pflicht | Was es tut |
|---|---|---|---|
| content_posting_method | "DIRECT_POST" | "UPLOAD" | ja | Veröffentlichen, oder nur in den Posteingang des Nutzers schicken. |
| privacy_level | "PUBLIC_TO_EVERYONE" | "MUTUAL_FOLLOW_FRIENDS" | "FOLLOWER_OF_CREATOR" | "SELF_ONLY" | ja | Die Sichtbarkeit des Beitrags. Bei DIRECT_POST Pflicht, ohne Standardwert. |
| title | string, höchstens 90 Zeichen | nein | Der Titel des Beitrags. Im UPLOAD-Modus ist das die einzige Einstellung, die TikTok behält. |
| duet | boolean | ja | Erlaubt Duette. Nur bei Video. |
| stitch | boolean | ja | Erlaubt Stitch. Nur bei Video. |
| comment | boolean | ja | Erlaubt Kommentare. |
| autoAddMusic | "yes" | "no" | ja | Musik automatisch hinzufügen. Nur bei Fotobeiträgen. |
| brand_content_toggle | boolean | ja | Kennzeichnung als Markeninhalt. |
| brand_organic_toggle | boolean | ja | Kennzeichnung als eigener Markeninhalt. |
| video_made_with_ai | boolean | nein | Markiert es als mit KI erstelltes Video. Nur bei Video. |
Zulässige Werte
Die aufgeführten Felder akzeptieren nur diese Werte. Bei jedem anderen Wert bekommst du einen 400er-Fehler. Die Antwort nennt das Feld.
content_posting_method
| Wert | Bedeutung |
|---|---|
| DIRECT_POST | TikTok veröffentlicht den Beitrag. |
| UPLOAD | Es landet nur im Posteingang. TikTok verwirft alle Einstellungen außer dem Titel. |
privacy_level
| Wert | Bedeutung |
|---|---|
| PUBLIC_TO_EVERYONE | Öffentlich. |
| MUTUAL_FOLLOW_FRIENDS | Nur für gegenseitige Follower. |
| FOLLOWER_OF_CREATOR | Nur für Follower. |
| SELF_ONLY | Nur für dich. |
autoAddMusic
| Wert | Bedeutung |
|---|---|
| yes | TikTok legt Musik unter den Fotobeitrag. |
| no | Ohne Musik. |
Beispiele
Jedes Beispiel ist ein Element im posts-Array der Anfrage POST /public/v1/posts. Der Rahmen darum ist immer dieser:
{
"type": "schedule",
"date": "2026-09-15T09:00:00.000Z",
"shortLink": false,
"posts": [ /* az alábbi elem */ ]
}Video, öffentlich
Die Sichtbarkeit hat keinen Standardwert. Die TikTok-Richtlinie verlangt, dass du eine wählst.
{
"integration": { "id": "<tiktok-csatorna>" },
"value": [{
"content": "<p>A videó leírása.</p>",
"image": [{ "id": "<media>", "path": "https://uploads.posty.hu/video.mp4" }]
}],
"settings": {
"__type": "tiktok",
"content_posting_method": "DIRECT_POST",
"privacy_level": "PUBLIC_TO_EVERYONE",
"title": "A videó címe",
"duet": true,
"stitch": true,
"comment": true,
"autoAddMusic": "no",
"brand_content_toggle": false,
"brand_organic_toggle": false
}
}Fotobeitrag
duet, stitch und video_made_with_ai werden bei Fotos ignoriert.
{
"integration": { "id": "<tiktok-csatorna>" },
"value": [{
"content": "<p>Három kép a hétvégéről.</p>",
"image": [
{ "id": "<media-1>", "path": "https://uploads.posty.hu/1.jpg" },
{ "id": "<media-2>", "path": "https://uploads.posty.hu/2.jpg" }
]
}],
"settings": {
"__type": "tiktok",
"content_posting_method": "DIRECT_POST",
"privacy_level": "PUBLIC_TO_EVERYONE",
"title": "Hétvége",
"duet": false,
"stitch": false,
"comment": true,
"autoAddMusic": "yes",
"brand_content_toggle": false,
"brand_organic_toggle": false
}
}Die Kanalliste liefert die Kanal-ID, der Medien-Upload den path-Wert für Bilder und Videos. Das genaue Schema für das verbundene Konto gibt der Endpunkt für das Einstellungsschema zurück. Von der Kommandozeile aus geht dasselbe mit dem Flag --settings, siehe die CLI-Beispiele.