Een video op TikTok plaatsen via de API
Om via de API for Business van TikTok een video te plaatsen, stuur je POST /business/video/publish/ met de business_id van het account, een video_url op een geverifieerd domein of URL-prefix en een post_info-object met het bijschrift en de instellingen, plus de Access-Token-header. TikTok antwoordt met een share_id. Geef die als publish_id mee aan /business/publish/status/ tot de status PUBLISH_COMPLETE aangeeft en post_ids verschijnen.
easyCoexistence publiceert TikTok-video's met publish_tiktok_post vanuit Claude, ChatGPT of je eigen agent.
Teruggegeven door de publish-aanroep, bijvoorbeeld v_pub_url~v1.2345123456789123456, en via de statusaanroep als publish_id doorgegeven.
Sindsdien weigert TikTok video's te publiceren van URL's waarvan het domein of de URL-prefix niet geverifieerd is.
TikTok's limiet op videoposts per account via het publish-endpoint, met maximaal 15 per dag.
Hoe lang post_ids kunnen duren om te verschijnen na PUBLISH_COMPLETE. TikTok adviseert na drie minuten opnieuw te proberen.
Verstuurd in de webhook post.publish.publicly_available zodra een post de moderatie doorstaat, klaar om de inzichten op te vragen.
Wat heb je nodig voor de eerste aanroep?
Drie dingen. Een TikTok-toegangstoken en de open_id van het account, uit de tokenuitwisseling. Een developer-app met de Video Publish-rechten onder TikTok Accounts. En de video op een openbare HTTPS- of HTTP-URL die onder een domein of URL-prefix staat dat voor de app is geverifieerd. TikTok downloadt het bestand zelf, dus het moet bereikbaar blijven, en TikTok adviseert een URL die minstens 30 minuten beschikbaar blijft.
Hoe ziet het publish-verzoek eruit?
Een POST naar https://business-api.tiktok.com/open_api/v1.3/business/video/publish/ met de token van het account in de Access-Token-header en Content-Type ingesteld op application/json. De JSON-body noemt het account in business_id, het bestand in video_url en de instellingen van de post in post_info. Dit voorbeeld publiceert een video met bijschrift, met reacties, Duet en Stitch ingeschakeld:
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
}
}'Wat doet elk veld in de body?
De velden die TikTok's referentie voor een videopost noemt, van het bovenste niveau naar beneden. De cover, het label AI-gegenereerd, een locatie, concepten en de optie alleen voor advertenties staan in dezelfde body:
business_id: deopen_idvan het account, uit de tokenuitwisseling.video_url: het bestand dat TikTok downloadt, MP4, MOV of WebM, op een geverifieerd domein of URL-prefix.post_info: verplicht bij elke aanroep, ook als leeg object, en de plek voor de instellingen van de post.post_info.caption: tot 2.200 tekens, geteld in UTF-16, met #hashtags en tot 30 @vermeldingen.post_info.is_brand_organicenis_branded_content: de labels Promotional content en Paid partnership, die TikToks tabel als verplicht aangeeft.post_info.disable_comment,disable_duetendisable_stitch: true schakelt reacties, Duet of Stitch uit. Alle drie staan standaard op false.
Wat geeft TikTok terug?
De gebruikelijke envelop, met de ID van de publicatietaak in data. Een code 0 betekent dat TikTok de taak heeft geaccepteerd, niet dat de video live staat. TikTok moet het bestand nog downloaden, controleren en de post modereren. In de voorbeelden van TikTok begint de share_id van een video met v_pub_url en die van een fotopost met p_pub_url.
{
"code": 0,
"message": "Ok",
"request_id": "20210817034316010245031056097316BA",
"data": {
"share_id": "v_pub_url~v1.2345123456789123456"
}
}Hoe volg je de post tot hij live is?
Met GET /business/publish/status/, waarbij je business_id en de share_id als publish_id meegeeft. De status is PROCESSING_DOWNLOAD terwijl TikTok het bestand ophaalt, PUBLISH_COMPLETE zodra de post de moderatie heeft doorstaan, of FAILED met een reden. post_ids komt mee met PUBLISH_COMPLETE wanneer de post openbaar zichtbaar is, en kan tot drie minuten achterlopen. De hele stroom 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"])
breakKan een webhook de statuscontroles vervangen?
Ja, voor een app die zich abonneert op event_type VIDEO met /business/webhook/update/. TikTok stuurt dan post.publish.failed of post.publish.complete zodra het bestand is gedownload en gecontroleerd. Het stuurt post.publish.publicly_available met de nieuwe post_id zodra de moderatie is doorstaan, en post.publish.no_longer_publicly_available als de post later niet meer openbaar te zien is. Elk event noemt de taak in publish_id, dezelfde waarde als de share_id.
Hoe plaats je een video via MCP?
Vraag het in gewone woorden aan Claude, ChatGPT of een andere client die is verbonden met https://easycoexistence.com/api/mcp. De assistent roept publish_tiktok_post aan met de account_id uit list_social_accounts, een HTTPS video_url, het bijschrift en, als je reacties wilt uitschakelen, disable_comment. Het resultaat bevat de share_id van TikTok. get_tiktok_publish_status geeft, met de account_id en die share_id, de status, post_ids en reason van TikTok zoals ze nu staan.
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>"] }Wat stuurt publish_tiktok_post naar TikTok?
Een aanroep van hetzelfde endpoint, ingevuld op basis van je verzoek. Je link gaat naar TikTok als ondertekende link via de eigen geverifieerde mediaroute van easyCoexistence, dus die heeft geen eigen verificatie nodig. Het bijschrift en disable_comment gaan mee zoals jij ze opgaf, en is_brand_organic en is_branded_content gaan mee als false. De overige instellingen, zoals Duet, Stitch, de cover en het label AI-gegenereerd, houden de standaardwaarden van TikTok. De video wordt gepubliceerd als openbare post, zoals het endpoint dat doet.
Wat kun je doen met credentials uit de Partner API?
TikTok rechtstreeks aanroepen als het account. GET /channels/{id}?credentials=1 op https://easycoexistence.com/api/v1, met je ec_live_-sleutel als bearer-token, geeft het kanaal terug met een credentials-object: api_base, business_id, een actuele access_token en token_expires_at. Statuscontroles, videolijsten, reacties en inzichten draaien daarna vanuit je eigen code. Publiceren is het onderdeel om te plannen. Een directe publish-aanroep geeft video_url ongewijzigd door aan TikTok. URL-eigenschappen worden toegevoegd met de eigen ID en secret van een developer-app, en het prefix dat de app van easyCoexistence heeft geverifieerd is de mediaroute die publish_tiktok_post gebruikt.
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>'Zo stel je het in
- 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.
Veelgemaakte fouten
- post_info overslaan. TikTok vereist het object bij elke aanroep, ook als er geen instelling verandert.
- Zoeken naar een post-ID in het publish-antwoord. Het geeft alleen share_id terug. Post-ID's komen uit de statusaanroep of uit de webhook publicly_available.
- Een publish-aanroep opnieuw sturen na een time-out. Het eerste verzoek kan TikTok al hebben bereikt, dus controleer eerst de laatste posts van het account.
- Code 0 als live video behandelen. Het betekent dat TikTok de taak heeft geaccepteerd, en het bestand kan na de download nog falen bij de controles.
Geef een HTTPS-link, het bijschrift en of reacties aan staan, en volg daarna de post met get_tiktok_publish_status. Het bestand komt via de geverifieerde mediaroute bij TikTok. US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met een gratis proefperiode van 3 dagen.
Veelgestelde vragen
Welk endpoint plaatst een video op TikTok?
POST https://business-api.tiktok.com/open_api/v1.3/business/video/publish/, met het account-token in de Access-Token-header en business_id, video_url en post_info in de JSON-body.
Kan de TikTok API een videobestand rechtstreeks uploaden?
Niet via /business/video/publish/. Dat endpoint neemt video_url en haalt het bestand vanaf die URL op, dus de video heeft een URL nodig op een geverifieerd domein of URL-prefix.
Hoe krijg ik de ID van een via de API gepubliceerde video?
Uit post_ids in /business/publish/status/ zodra de status PUBLISH_COMPLETE is en de post openbaar is, of uit post_id in de webhook post.publish.publicly_available.
Kan ik een TikTok-video via de API voor later plannen?
Het publish-endpoint plaatst de post op het moment van de aanroep en heeft geen tijdveld. easyCoexistence houdt geplande posts in de eigen wachtrij en roept TikTok aan op het tijdstip dat je instelt.
Lees verder
Koppel je eerste kanaal in twee minuten.
Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.
- 3 dagen gratis
- Op elk moment opzegbaar
- Alleen officiële API's
- 24/7 bewaakt
Geverifieerd op