AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

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.

video.upload

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.

5 pending

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.

SEND_TO_USER_INBOX

Der Status /business/publish/status/ meldet, sobald ein Entwurf hochgeladen ist und TikTok den Posteingang des Creators benachrichtigt hat.

6 a minute

Anfragen, die jedes User-Access-Token an den Upload-Endpoint der Content Posting API senden darf.

Ignored

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 postsThe creator, in the TikTok appThe app, through the API
Token scopevideo.upload, on both APIsvideo.publish on the Content Posting API
Content Posting API/v2/post/publish/inbox/video/init//v2/post/publish/video/init/
API for Businessupload_to_draft or is_draft set to trueThe same endpoints without them
Status once handed overSEND_TO_USER_INBOXPUBLISH_COMPLETE once live
Caption and settingsMostly finished by the creator in TikTokSent 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:

Upload a video to the creator's inbox from a URL
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_share mit HTTP 403.
  • Anfragen: 6 pro Minute und User-Access-Token, danach rate_limit_exceeded mit HTTP 429.
  • Scope: ein Token ohne video.upload erhält scope_not_authorized mit HTTP 401.
  • Medien: PULL_FROM_URL von einer Domain oder einem Präfix, die die App nicht verifiziert hat, liefert url_ownership_unverified mit 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:

Send a video to the creator's drafts on the API for Business
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.
Mit EasyCoexistence

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