Prijavite seZapočnite besplatno probno razdoblje
easyCoexistence Službeni API-ji

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.

share_id

Vraća ga poziv za objavu, primjerice v_pub_url~v1.2345123456789123456, a prosljeđuje se pozivu za status kao publish_id.

Nov 16, 2023

Od tada TikTok odbija objavljivati videozapise s URL-ova čija domena ili prefiks URL-a nije provjeren.

6 a minute

TikTokovo ograničenje objava videozapisa po računu kroz endpoint za objavu: najviše 15 dnevno.

3 min

Koliko je vremena potrebno da se post_ids pojavi nakon PUBLISH_COMPLETE; TikTok preporučuje ponovni pokušaj nakon tri minute.

post_id

Š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:

Publish a video with curl
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_id rač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_organic i is_branded_content: oznake Promotional content i Paid partnership, koje TikTokova tablica označava kao obavezne.
  • post_info.disable_comment, disable_duet i disable_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.

The publish response
{
  "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:

Publish and follow a video 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"])
        break

Mož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.

The MCP tool calls and their results
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.

Credentials from the Partner API, then a direct status check
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

  1. 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.
  2. 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.
  3. 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/.
  4. Keep the share_idStore data.share_id from the response, the ID of this publishing task.
  5. Check the statusEvery few minutes, GET /business/publish/status/ with business_id and the share_id as publish_id, until PUBLISH_COMPLETE or FAILED.
  6. 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.
Radite ovo uz EasyCoexistence

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