Ein Video über die API an die Entwürfe eines TikTok-Creators senden
Die APIs von TikTok senden ein Video mit dem Upload-Ablauf in die Entwürfe eines Creators: Die Content Posting API unter /v2/post/publish/inbox/video/init/ lädt es im Scope video.upload hoch, und TikTok schickt dem Creator eine Benachrichtigung im Posteingang, damit er es in der App bearbeitet und veröffentlicht. Die API for Business macht dasselbe mit upload_to_draft auf /business/video/publish/ oder mit is_draft bei Fotobeiträgen.
easyCoexistence veröffentlicht TikTok-Videos und Fotobeiträge mit publish_tiktok_post aus Claude, ChatGPT oder Ihrer eigenen Plattform, sofort oder zu einem Datum und einer Uhrzeit bis zu 90 Tage im Voraus.
Scope, mit dem TikTok das Teilen von Inhalten im Konto des Creators als Entwurf erlaubt, damit er ihn in TikTok weiter bearbeiten und veröffentlichen kann.
Maximale Anzahl ausstehender Freigaben, die die Content Posting API in einem beliebigen Zeitraum von 24 Stunden erlaubt, eine Grenze, die TikTok zur Eindämmung von Spam setzt.
Der Status /business/publish/status/ meldet, sobald ein Entwurf hochgeladen ist und TikTok den Posteingang des Creators benachrichtigt hat.
Anfragen, die jedes User-Access-Token an den Upload-Endpoint der Content Posting API senden darf.
Was mit den übrigen post_info-Feldern geschieht, wenn upload_to_draft auf /business/video/publish/ auf true gesetzt ist.
Worin unterscheidet sich ein Entwurf von einem direkten Beitrag?
Darin, wer auf Veröffentlichen drückt. Ein direkter Beitrag geht live, sobald TikTok ihn verarbeitet hat. Ein Entwurf landet im TikTok-Posteingang des Creators und wird erst veröffentlicht, wenn der Creator ihn öffnet, nach Belieben bearbeitet und postet. Dieser Unterschied zieht sich durch beide Posting-APIs von TikTok:
| Draft (upload) | Direct post | |
|---|---|---|
| Who posts | The creator, in the TikTok app | The app, through the API |
| Token scope | video.upload, on both APIs | video.publish on the Content Posting API |
| Content Posting API | /v2/post/publish/inbox/video/init/ | /v2/post/publish/video/init/ |
| API for Business | upload_to_draft or is_draft set to true | The same endpoints without them |
| Status once handed over | SEND_TO_USER_INBOX | PUBLISH_COMPLETE once live |
| Caption and settings | Mostly finished by the creator in TikTok | Sent in the call |
Wie lädt die Content Posting API einen Entwurf hoch?
Mit einer POST-Anfrage an https://open.tiktokapis.com/v2/post/publish/inbox/video/init/, einem User-Access-Token mit video.upload und einem source_info-Objekt. PULL_FROM_URL lässt TikTok das Video von einer Domain oder einem URL-Präfix abrufen, die die App verifiziert hat; FILE_UPLOAD liefert eine upload_url, an die die Datei in Teilen mit PUT-Anfragen gesendet wird. Die zurückgegebene publish_id geht an /v2/post/publish/status/fetch/. Fotos nutzen /v2/post/publish/content/init/ mit post_mode auf MEDIA_UPLOAD, und TikTok bittet Apps, Nutzer darauf hinzuweisen, die Benachrichtigung im Posteingang zu öffnen, um in TikTok weiter zu bearbeiten:
curl -X POST 'https://open.tiktokapis.com/v2/post/publish/inbox/video/init/' \
-H 'Authorization: Bearer <USER_ACCESS_TOKEN>' \
-H 'Content-Type: application/json; charset=UTF-8' \
-d '{
"source_info": {
"source": "PULL_FROM_URL",
"video_url": "https://media.example.com/tiktok/draft.mp4"
}
}'
# data.publish_id: pass it to /v2/post/publish/status/fetch/Welche Limits gelten für Entwürfe der Content Posting API?
TikTok dokumentiert diese in seiner Upload-Referenz. Jedes wird vom Init-Aufruf zurückgegeben, sobald es zutrifft:
- Ausstehende Entwürfe: höchstens 5 ausstehende Freigaben in einem beliebigen Zeitraum von 24 Stunden; darüber hinaus
spam_risk_too_many_pending_sharemit HTTP 403. - Anfragen: 6 pro Minute und User-Access-Token, danach
rate_limit_exceededmit HTTP 429. - Scope: ein Token ohne video.upload erhält
scope_not_authorizedmit HTTP 401. - Medien:
PULL_FROM_URLvon einer Domain oder einem Präfix, die die App nicht verifiziert hat, lieferturl_ownership_unverifiedmit HTTP 403.
Wie lädt die API for Business einen Entwurf hoch?
Mit ihren Veröffentlichungs-Endpunkten und einem weiteren Feld in post_info. Auf /business/video/publish/ sendet upload_to_draft mit dem Wert true das Video als Entwurf, und TikTok ignoriert die übrigen post_info-Felder. Auf /business/photo/publish/ behält is_draft nur Titel und Beschreibung. Beides braucht video.upload im Token des Kontos, das /tt_user/token_info/get/ auflistet. Fehlt der Scope, erteilt der Inhaber das Hochladen von Entwürfen, indem er die App erneut autorisiert. Die Medien liegen weiterhin auf einer verifizierten URL, der Status lautet SEND_TO_USER_INBOX, und der Creator findet den Entwurf über die Benachrichtigung im Posteingang:
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/video/publish/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"business_id": "<OPEN_ID>",
"video_url": "https://media.example.com/tiktok/draft.mp4",
"post_info": {
"upload_to_draft": true,
"is_brand_organic": false,
"is_branded_content": false
}
}'Was macht der Creator mit dem Entwurf?
Er schließt ihn in TikTok ab. Die Benachrichtigung im Posteingang öffnet das hochgeladene Video oder die Fotos im Editor von TikTok, wo der Creator sie prüft, bearbeitet und veröffentlicht. Bei der Content Posting API wechselt der Status von SEND_TO_USER_INBOX zu PUBLISH_COMPLETE, sobald der Creator aus dem Entwurf postet. TikTok weist darauf hin, dass ein Entwurf mehr als einen Beitrag erzeugen kann.
Versendet easyCoexistence Entwürfe?
Nein: publish_tiktok_post veröffentlicht. Es ruft /business/video/publish/ oder /business/photo/publish/ ohne upload_to_draft bzw. is_draft auf, sodass ein Beitrag live geht, sobald TikTok ihn verarbeitet hat. Um einen Beitrag zur Prüfung zurückzuhalten, planen Sie ihn mit scheduled_at, von 1 Minute bis 90 Tage im Voraus: Er wartet unter Demnächst auf dem Bildschirm Beiträge, update_scheduled_post ändert seine Zeit, Beschreibung oder den Titel eines Fotobeitrags, und cancel_scheduled_post stoppt ihn, bevor er rausgeht.
Häufige Fehler
- video.publish für Entwürfe anzufordern. Entwürfe brauchen video.upload, den Scope, den TikTok als Teilen von Inhalten als Entwurf beschreibt.
- Über die API for Business eine Beschreibung bei einem Video-Entwurf zu setzen. Mit upload_to_draft auf true ignoriert TikTok den Rest von post_info.
- Entwürfe schneller hochzuladen, als Creator sie veröffentlichen. Die Content Posting API stoppt bei 5 ausstehenden Freigaben in 24 Stunden mit spam_risk_too_many_pending_share.
- Nutzer ohne Hinweis auf den Posteingang zu lassen. TikTok bittet Apps, sie auf die Benachrichtigung im Posteingang hinzuweisen, damit sie den Beitrag abschließen.
Jeder geplante Beitrag bleibt unter Demnächst auf dem Bildschirm Beiträge, bis er rausgeht. US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit den ersten 3 Tagen als kostenlose Testphase.
Häufig gestellte Fragen
Kann die TikTok-API ein Video als Entwurf speichern?
Ja. Der Upload-Ablauf legt es in den TikTok-Posteingang des Creators, wo der Creator es bearbeitet und veröffentlicht; das Token braucht den Scope video.upload.
Wo erscheint ein über die API gesendeter Entwurf?
In der TikTok-App, hinter einer Benachrichtigung im Posteingang, die das Video im Editor von TikTok öffnet, damit der Creator es abschließen kann.
Behält ein TikTok-Entwurf die Beschreibung?
Bei der API for Business behält ein Foto-Entwurf Titel und Beschreibung, während ein Video-Entwurf die übrigen post_info-Felder verwirft.
Kann aus einem TikTok-Entwurf mehr als ein Beitrag werden?
Ja. TikTok weist darauf hin, dass ein Entwurf mehr als einen Beitrag erzeugen kann; bei der Content Posting API wechselt der Status zu PUBLISH_COMPLETE, sobald der Creator daraus postet.
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