Wie Sie ein Video per API auf TikTok veröffentlichen
Um ein Video über die TikTok-API for Business zu veröffentlichen, senden Sie POST /business/video/publish/ mit der business_id des Kontos, einer video_url unter einer verifizierten Domain oder einem URL-Präfix und einem post_info-Objekt mit Beschreibung und Einstellungen, zusammen mit dem Header Access-Token. TikTok antwortet mit einer share_id; übergeben Sie sie als publish_id an /business/publish/status/, bis der Status PUBLISH_COMPLETE lautet und post_ids erscheinen.
easyCoexistence veröffentlicht TikTok-Videos mit publish_tiktok_post aus Claude, ChatGPT oder Ihrem eigenen Agenten: Übergeben Sie einen HTTPS-Link, die Beschreibung und ob Kommentare aktiv sind, und verfolgen Sie den Beitrag dann mit get_tiktok_publish_status, während die Datei über die verifizierte Medienroute zu TikTok gelangt.
Wird vom Veröffentlichungsaufruf zurückgegeben, etwa v_pub_url~v1.2345123456789123456, und an den Statusaufruf als publish_id übergeben.
Seitdem lehnt TikTok die Veröffentlichung von Videos ab, deren Domain oder URL-Präfix nicht verifiziert ist.
Die Obergrenze von TikTok für Videobeiträge pro Konto über den Veröffentlichungs-Endpoint: höchstens 15 pro Tag.
Wie lange post_ids nach PUBLISH_COMPLETE auf sich warten lassen können; laut TikTok sollte man nach drei Minuten erneut abfragen.
Wird im Webhook post.publish.publicly_available gesendet, sobald ein Beitrag die Moderation besteht und seine Insights abgefragt werden können.
Was brauchen Sie vor dem ersten Aufruf?
Drei Dinge. Ein Access-Token des TikTok-Kontos und die open_id des Kontos aus dem Token-Austausch; eine Entwickler-App mit der Berechtigung Video Publish unter TikTok Accounts; und das Video unter einer öffentlichen HTTPS- oder HTTP-URL, die unter einer für die App verifizierten Domain oder einem URL-Präfix liegt. TikTok lädt die Datei selbst herunter, daher muss sie erreichbar bleiben; TikTok empfiehlt eine URL, die mindestens 30 Minuten gültig ist.
Wie sieht die Veröffentlichungsanfrage aus?
Ein POST an https://business-api.tiktok.com/open_api/v1.3/business/video/publish/ mit dem Access-Token des Kontos im Header Access-Token und Content-Type auf application/json. Der JSON-Body nennt das Konto in business_id, die Datei in video_url und die Einstellungen des Beitrags in post_info; dieses Beispiel veröffentlicht ein Video mit Beschreibung, wobei Kommentare, Duett und Stitch aktiviert bleiben:
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/launch.mp4",
"post_info": {
"caption": "Our new menu is live #food",
"is_brand_organic": false,
"is_branded_content": false,
"disable_comment": false,
"disable_duet": false,
"disable_stitch": false
}
}'Was bewirkt jedes Feld im Body?
Die Felder, die die Referenz von TikTok für einen Videobeitrag aufführt, von oben nach unten. Titelbild, das KI-generierte Kennzeichen, ein Standort, Entwürfe und die Option nur für Werbung stehen im selben Body:
business_id: dieopen_iddes Kontos aus dem Token-Austausch.video_url: die Datei, die TikTok herunterlädt, MP4, MOV oder WebM, unter einer verifizierten Domain oder einem URL-Präfix.post_info: bei jedem Aufruf erforderlich, auch als leeres Objekt; enthält die Einstellungen des Beitrags.post_info.caption: bis zu 2,200 Zeichen, in UTF-16 gezählt, mit #Hashtags und bis zu 30 @Erwähnungen.post_info.is_brand_organicundis_branded_content: die Kennzeichnungen Werbliche Inhalte und Bezahlte Partnerschaft, die die Tabelle von TikTok als Pflichtfelder ausweist.post_info.disable_comment,disable_duetunddisable_stitch: true schaltet Kommentare, Duett bzw. Stitch aus; alle drei stehen standardmäßig auf false.
Was gibt TikTok zurück?
Die übliche Hülle mit der ID der Veröffentlichungsaufgabe in data. Ein code mit dem Wert 0 bedeutet, dass TikTok die Aufgabe angenommen hat, nicht dass das Video live ist: TikTok muss die Datei noch herunterladen, prüfen und den Beitrag moderieren. In den Beispielen von TikTok beginnt die share_id eines Videos mit v_pub_url und die eines Fotobeitrags mit p_pub_url.
{
"code": 0,
"message": "Ok",
"request_id": "20210817034316010245031056097316BA",
"data": {
"share_id": "v_pub_url~v1.2345123456789123456"
}
}Wie verfolgen Sie den Beitrag, bis er live ist?
Mit GET /business/publish/status/, indem Sie business_id und die share_id als publish_id übergeben. status zeigt PROCESSING_DOWNLOAD, während TikTok die Datei abruft, PUBLISH_COMPLETE, sobald der Beitrag die Moderation bestanden hat, oder FAILED mit einem Grund. post_ids erscheint zusammen mit PUBLISH_COMPLETE, wenn der Beitrag öffentlich sichtbar ist, und kann bis zu drei Minuten verzögert sein. Der gesamte Ablauf in Python:
import os, time, requests
API = "https://business-api.tiktok.com/open_api/v1.3"
HEADERS = {"Access-Token": os.environ["TIKTOK_ACCESS_TOKEN"]}
BUSINESS_ID = os.environ["TIKTOK_BUSINESS_ID"] # open_id from the token exchange
def call(method, path, **kwargs):
body = requests.request(method, f"{API}/{path}", headers=HEADERS, timeout=30, **kwargs).json()
if body.get("code") != 0: # errors arrive in code, usually with HTTP 200
raise RuntimeError(f"{body.get('code')}: {body.get('message')}")
return body["data"]
share_id = call("POST", "business/video/publish/", json={
"business_id": BUSINESS_ID,
"video_url": "https://media.example.com/tiktok/launch.mp4",
"post_info": {"caption": "Our new menu is live #food",
"is_brand_organic": False, "is_branded_content": False},
})["share_id"]
for _ in range(30):
time.sleep(60) # each check is a call; TikTok's stages take minutes
s = call("GET", "business/publish/status/",
params={"business_id": BUSINESS_ID, "publish_id": share_id})
if s["status"] == "FAILED":
raise RuntimeError(s.get("reason"))
if s["status"] == "PUBLISH_COMPLETE" and s.get("post_ids"):
print("Live:", s["post_ids"])
breakKann ein Webhook die Statusabfragen ersetzen?
Ja, für eine App, die event_type VIDEO mit /business/webhook/update/ abonniert. TikTok sendet dann post.publish.failed oder post.publish.complete, sobald die Datei heruntergeladen und geprüft wurde, post.publish.publicly_available mit der neuen post_id, wenn die Moderation besteht, und post.publish.no_longer_publicly_available, falls der Beitrag später nicht mehr öffentlich sichtbar ist. Jedes Ereignis nennt die Aufgabe in publish_id, denselben Wert wie die share_id.
Wie veröffentlichen Sie ein Video über MCP?
Bitten Sie Claude, ChatGPT oder einen anderen Client, der mit https://easycoexistence.com/api/mcp verbunden ist, in einfachen Worten darum. Der Assistent ruft publish_tiktok_post auf, mit der account_id aus list_social_accounts, einer HTTPS-URL für video_url, der Beschreibung und, falls Sie Kommentare deaktivieren möchten, disable_comment. Das Ergebnis enthält die share_id von TikTok; get_tiktok_publish_status gibt mit der account_id und dieser share_id den Status, die post_ids und den Grund so zurück, wie TikTok sie aktuell meldet.
publish_tiktok_post {
"account_id": "<ACCOUNT_ID>",
"video_url": "https://media.example.com/tiktok/launch.mp4",
"caption": "Our new menu is live #food",
"disable_comment": false
}
=> { "share_id": "v_pub_url~v1.2345123456789123456",
"note": "TikTok is processing the post. Check it with get_tiktok_publish_status." }
get_tiktok_publish_status { "account_id": "<ACCOUNT_ID>", "share_id": "v_pub_url~v1.2345123456789123456" }
=> { "status": "PUBLISH_COMPLETE", "post_ids": ["<POST_ID>"] }Was sendet publish_tiktok_post an TikTok?
Einen Aufruf desselben Endpoints, ausgefüllt mit Ihrer Anfrage. Ihr Link geht an TikTok als signierter Link über die eigene verifizierte Medienroute von easyCoexistence, daher ist keine eigene Verifizierung nötig; Beschreibung und disable_comment gehen so, wie Sie sie angegeben haben; is_brand_organic und is_branded_content gehen als false. Die übrigen Einstellungen, etwa Duett, Stitch, Titelbild und das KI-generierte Kennzeichen, behalten die Standardwerte von TikTok, und das Video wird als öffentlicher Beitrag veröffentlicht, wie es der Endpoint vorsieht.
Was können Sie mit Zugangsdaten aus der Partner-API tun?
Rufen Sie TikTok direkt im Namen des Kontos auf. GET /channels/{id}?credentials=1 auf https://easycoexistence.com/api/v1 gibt mit Ihrem ec_live_-Schlüssel als Bearer-Token den Kanal mit einem Objekt credentials zurück: api_base, business_id, ein aktuelles access_token und token_expires_at. Statusabfragen, Videolisten, Kommentare und Insights laufen danach aus Ihrem eigenen Code. Das Veröffentlichen ist der Teil, den Sie planen müssen: Ein direkter Veröffentlichungsaufruf übergibt video_url unverändert an TikTok, URL-Eigenschaften werden mit der eigenen App-ID und dem Geheimschlüssel eines Entwicklers hinzugefügt, und das Präfix, das die App von easyCoexistence verifiziert hat, ist deren Medienroute, die publish_tiktok_post verwendet.
curl "https://easycoexistence.com/api/v1/channels/$CHANNEL_ID?credentials=1" \
-H "Authorization: Bearer $EC_API_KEY"
# "credentials": {
# "platform": "tiktok",
# "api_base": "https://business-api.tiktok.com/open_api/v1.3",
# "business_id": "<OPEN_ID>",
# "access_token": "<ACCESS_TOKEN>",
# "token_expires_at": "2026-11-01T09:00:00.000Z", ...
# }
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/publish/status/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>' \
--data-urlencode 'publish_id=<SHARE_ID>'So richten Sie es ein
- Get the token and the account IDExchange the owner's authorization code at /tt_user/oauth2/token/, and keep access_token for the header and open_id for business_id.
- Host the videoPut the MP4, MOV or WebM file under a domain or URL prefix verified for your app, where it stays reachable for at least 30 minutes.
- Call the publish endpointPOST business_id, video_url and post_info, with the caption, the two brand flags and the engagement switches, to /business/video/publish/.
- Keep the share_idStore data.share_id from the response, the ID of this publishing task.
- Check the statusEvery few minutes, GET /business/publish/status/ with business_id and the share_id as publish_id, until PUBLISH_COMPLETE or FAILED.
- Record the post IDTake it from post_ids, or from post_id in the post.publish.publicly_available webhook, to read the video's metrics later.
Häufige Fehler
- post_info weglassen. TikTok verlangt das Objekt bei jedem Aufruf, auch wenn sich keine Einstellung ändert.
- In der Antwort der Veröffentlichung nach einer Beitrags-ID suchen. Sie enthält nur die share_id; die post_ids kommen aus dem Statusaufruf oder dem Webhook post.publish.publicly_available.
- Einen Veröffentlichungsaufruf wiederholen, der in ein Timeout lief. Die erste Anfrage könnte TikTok erreicht haben; prüfen Sie daher die neuesten Beiträge des Kontos, bevor Sie sie erneut senden.
- code 0 mit einem live geschalteten Video verwechseln. Der Code bedeutet, dass TikTok die Aufgabe angenommen hat, und die Datei kann nach dem Download noch an den Prüfungen scheitern.
US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit einer kostenlosen Testphase von 3 Tagen.
Häufig gestellte Fragen
Welcher Endpoint veröffentlicht ein Video auf TikTok?
POST https://business-api.tiktok.com/open_api/v1.3/business/video/publish/, mit dem Access-Token des Kontos im Header Access-Token und business_id, video_url und post_info im JSON-Body.
Kann die TikTok-API eine Videodatei direkt hochladen?
Nicht über /business/video/publish/. Der Endpoint nimmt video_url und holt die Datei von dort, daher braucht das Video eine URL unter einer verifizierten Domain oder einem URL-Präfix.
Wie erhalte ich die ID eines über die API veröffentlichten Videos?
Aus post_ids in /business/publish/status/, sobald der Status PUBLISH_COMPLETE lautet und der Beitrag öffentlich ist, oder aus post_id im Webhook post.publish.publicly_available.
Kann ich ein TikTok-Video über die API für später planen?
Der Veröffentlichungs-Endpoint veröffentlicht beim Aufruf sofort und hat kein Zeitfeld. easyCoexistence hält geplante Beiträge in der eigenen Warteschlange und ruft TikTok zu der von Ihnen gesetzten Zeit auf.
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