Kako objaviti video na TikToku putem API-ja
Da biste objavili video putem TikTokovog API-ja za poslovne račune, pošaljite POST /business/video/publish/ s business_id računa, video_url na provjerenoj domeni ili prefiksu URL-a i objektom post_info koji sadrži opis i postavke, uz zaglavlje Access-Token. TikTok odgovara share_id-om; proslijedite ga kao publish_id pozivu /business/publish/status/ dok se status ne promijeni u PUBLISH_COMPLETE i ne pojave post_ids.
easyCoexistence objavljuje TikTok videozapise s publish_tiktok_post iz Claudea, ChatGPT-ja ili vašeg vlastitog agenta: proslijedite HTTPS poveznicu, opis i to jesu li komentari uključeni, zatim pratite objavu pomoću get_tiktok_publish_status, dok datoteka do TikToka stiže kroz provjerenu medijsku rutu.
Vraća ga poziv za objavu, primjerice v_pub_url~v1.2345123456789123456, a prosljeđuje se pozivu za status kao publish_id.
Od tada TikTok odbija objavljivati videozapise s URL-ova čija domena ili prefiks URL-a nije provjeren.
TikTokovo ograničenje objava videozapisa po računu kroz endpoint za objavu: najviše 15 dnevno.
Koliko je vremena potrebno da se post_ids pojavi nakon PUBLISH_COMPLETE; TikTok preporučuje ponovni pokušaj nakon tri minute.
Šalje se u webhooku post.publish.publicly_available čim objava prođe moderaciju, spremna za dohvat njezinih uvida.
Što vam treba prije prvog poziva?
Tri stvari. Pristupni token TikTok računa i open_id računa, dobiveni razmjenom tokena; developerska aplikacija s dozvolom Video Publish pod TikTok Accounts; i video na javnom HTTPS ili HTTP URL-u koji se nalazi pod domenom ili prefiksom URL-a provjerenim za aplikaciju. TikTok sam preuzima datoteku, pa mora ostati dostupna, a TikTok preporučuje URL koji traje najmanje 30 minuta.
Kako izgleda zahtjev za objavu?
POST na https://business-api.tiktok.com/open_api/v1.3/business/video/publish/ s tokenom računa u zaglavlju Access-Token i Content-Type postavljenim na application/json. JSON tijelo navodi račun u business_id, datoteku u video_url i postavke objave u post_info; ovaj primjer objavljuje video s opisom, uz uključene komentare, Duet i Stitch:
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
}
}'Što radi svako polje tijela zahtjeva?
Polja koja TikTokova referenca navodi za objavu videozapisa, od najviše razine. Naslovnica, oznaka za sadržaj generiran umjetnom inteligencijom, lokacija, nacrti i opcija samo za oglase nalaze se u istom tijelu:
business_id:open_idračuna iz razmjene tokena.video_url: datoteka koju TikTok preuzima, MP4, MOV ili WebM, na provjerenoj domeni ili prefiksu URL-a.post_info: obavezan u svakom pozivu, čak i kao prazan objekt, i sadrži postavke objave.post_info.caption: do 2.200 znakova brojeno u UTF-16, s #hashtagovima i do 30 @oznaka.post_info.is_brand_organiciis_branded_content: oznake Promotional content i Paid partnership, koje TikTokova tablica označava kao obavezne.post_info.disable_comment,disable_duetidisable_stitch: true isključuje komentare, Duet ili Stitch; sva tri su prema zadanom false.
Što TikTok vraća?
Standardni omotač odgovora, s ID-om zadatka objave u data. Kod 0 znači da je TikTok prihvatio zadatak, a ne da je video uživo: TikTok tek mora preuzeti datoteku, provjeriti je i moderirati objavu. U TikTokovim primjerima share_id videozapisa počinje s v_pub_url, a onaj za objavu fotografija s p_pub_url.
{
"code": 0,
"message": "Ok",
"request_id": "20210817034316010245031056097316BA",
"data": {
"share_id": "v_pub_url~v1.2345123456789123456"
}
}Kako pratiti objavu dok ne postane javna?
GET /business/publish/status/ uz business_id i share_id kao publish_id. status ima vrijednost PROCESSING_DOWNLOAD dok TikTok dohvaća datoteku, PUBLISH_COMPLETE kad objava prođe moderaciju, ili FAILED s razlogom. post_ids se pojavljuje uz PUBLISH_COMPLETE kad je objava javno vidljiva, a može kasniti do tri minute. Cijeli tijek u Pythonu:
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"])
breakMože li webhook zamijeniti provjere statusa?
Može, za aplikaciju koja se pretplaćuje na event_type VIDEO putem /business/webhook/update/. TikTok tada šalje post.publish.failed ili post.publish.complete nakon što preuzme i provjeri datoteku, post.publish.publicly_available s novim post_id-om kad objava prođe moderaciju, te post.publish.no_longer_publicly_available ako objava kasnije prestane biti javna. Svaki događaj navodi zadatak u polju publish_id, što je ista vrijednost kao share_id.
Kako objaviti video putem MCP-a?
Zatražite to običnim riječima od Claudea, ChatGPT-ja ili drugog klijenta spojenog na https://easycoexistence.com/api/mcp. Asistent poziva publish_tiktok_post s account_id iz list_social_accounts, HTTPS video_url, opisom i, ako želite isključiti komentare, disable_comment. Rezultat sadrži share_id od TikToka, a get_tiktok_publish_status, uz account_id i taj share_id, vraća TikTokov status, post_ids i razlog kakvi su trenutačno.
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>"] }Što publish_tiktok_post šalje TikToku?
Poziv istom endpointu, popunjen iz vašeg zahtjeva. Vaša poveznica ide TikToku kao potpisana poveznica pod provjerenom medijskom rutom koju vodi easyCoexistence, pa joj nije potrebna vlastita provjera; opis i disable_comment idu onako kako ste ih zadali; a is_brand_organic i is_branded_content idu kao false. Ostale postavke, poput Duet, Stitch, naslovnice i oznake generirane umjetnom inteligencijom, zadržavaju TikTokove zadane vrijednosti, a video se objavljuje kao javna objava, kako je endpoint i zamišljen.
Što se može raditi s vjerodajnicama iz Partner API-ja?
Pozvati TikTok izravno kao račun. GET /channels/{id}?credentials=1 na https://easycoexistence.com/api/v1, s vašim ključem ec_live_ kao bearer tokenom, vraća kanal s objektom credentials: api_base, business_id, aktualni access_token i token_expires_at. Provjere statusa, popisi videozapisa, komentari i uvidi tada se izvršavaju iz vašeg vlastitog koda. Objavu treba dobro isplanirati: izravni poziv za objavu prosljeđuje video_url TikToku nepromijenjen, svojstva URL-a dodaju se pomoću ID-a i tajne vlastite developerske aplikacije, a prefiks koji je provjerila aplikacija easyCoexistence je njezina medijska ruta, koju koristi publish_tiktok_post.
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>'Kako ga postaviti
- 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.
Uobičajene pogreške
- Izostavljanje post_info. TikTok zahtijeva objekt u svakom pozivu, čak i kada se nijedna postavka ne mijenja.
- Traženje ID-a objave u odgovoru na objavu. Vraća samo share_id; ID-jevi objava dolaze iz poziva za status ili iz događaja post.publish.publicly_available.
- Ponavljanje poziva za objavu koji je istekao. Prvi zahtjev je možda stigao do TikToka, pa provjerite najnovije objave računa prije ponovnog slanja.
- Smatranje koda 0 znakom da je video uživo. On znači da je TikTok prihvatio zadatak, a datoteka može i nakon preuzimanja ne proći provjere.
US$ 9 do US$ 0,75 po vezi mjesečno, uz pad cijene kako dodajete veze, s besplatnim probnim razdobljem od 3 dana.
Često postavljana pitanja
Koji endpoint objavljuje video na TikToku?
POST https://business-api.tiktok.com/open_api/v1.3/business/video/publish/, s tokenom računa u zaglavlju Access-Token i business_id, video_url i post_info u JSON tijelu.
Može li TikTok API izravno prenijeti videodatoteku?
Ne putem /business/video/publish/. Taj endpoint prima video_url i datoteku dohvaća s tog URL-a, pa video mora imati URL na provjerenoj domeni ili prefiksu URL-a.
Kako dobiti ID videa objavljenog putem API-ja?
Iz post_ids u /business/publish/status/ kad je status PUBLISH_COMPLETE i objava je javna, ili iz polja post_id u webhooku post.publish.publicly_available.
Mogu li videozapis na TikToku zakazati za kasnije putem API-ja?
Endpoint za objavu objavljuje u trenutku poziva i nema polje za vrijeme. easyCoexistence drži zakazane objave u vlastitom redu i poziva TikTok u vrijeme koje postavite.
Nastavite čitati
Povežite svoj prvi kanal u dvije minute.
Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo službeni API-ji
- Nadzor 24/7
Provjereno na