Prijavite seZapočnite besplatni probni period
easyCoexistence Zvanični API-ji

Kako objaviti video na TikToku preko API-ja

Da biste objavili video preko TikTok API-ja for Business, pošaljite POST /business/video/publish/ sa business_id naloga, video_url na proverenom domenu ili prefiksu URL-a i objektom post_info koji sadrži tekst objave i podešavanja, uz zaglavlje Access-Token. TikTok odgovara sa share_id; prosledite ga kao publish_id ka /business/publish/status/ dok status ne pređe u PUBLISH_COMPLETE i dok se ne pojave post_ids.

easyCoexistence objavljuje TikTok video-snimke pomoću publish_tiktok_post iz Claude-a, ChatGPT-ja ili vašeg sopstvenog agenta: prosledite HTTPS link, tekst objave i da li su komentari uključeni, pa pratite objavu pomoću get_tiktok_publish_status, dok fajl do TikToka stiže preko njegove proverene medijske rute.

share_id

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

Nov 16, 2023

Od tada TikTok odbija da objavi video-snimke sa URL-ova čiji domen ili prefiks nije proveren.

6 a minute

TikTokovo ograničenje broja video-objava po nalogu preko endpointa za objavu: najviše 15 dnevno.

3 min

Koliko vremena može da prođe dok se post_ids ne pojavi posle PUBLISH_COMPLETE; TikTok kaže da treba pokušati ponovo posle tri minuta.

post_id

Šalje se u webhooku post.publish.publicly_available kada objava prođe moderaciju, spremna za upit o uvidima.

Šta je potrebno pre prvog poziva?

Tri stvari. Pristupni token TikTok naloga i open_id naloga, iz razmene tokena; developer aplikacija sa dozvolom Video Publish pod TikTok Accounts; i video na javnom HTTPS ili HTTP URL-u koji se nalazi pod domenom ili prefiksom URL-a proverenim za aplikaciju. TikTok sam preuzima fajl, zato mora ostati dostupan, a TikTok preporučuje URL koji važi najmanje 30 minuta.

Kako izgleda zahtev za objavu?

POST na https://business-api.tiktok.com/open_api/v1.3/business/video/publish/ sa tokenom naloga u zaglavlju Access-Token i Content-Type postavljenim na application/json. JSON telo navodi nalog u business_id, fajl u video_url, a podešavanja objave u post_info; ovaj primer objavljuje video sa opisom, uz komentare, Duet i Stitch ostavljene uključenim:

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
    }
  }'

Šta radi svako polje tela?

Polja koja TikTok navodi u referenci za video objave, od najvišeg nivoa nadole. Naslovne slike, oznaka AI-generisanog sadržaja, lokacija, nacrti i opcija samo za oglase nalaze se u istom telu:

  • business_id: open_id naloga iz razmene tokena.
  • video_url: fajl koji TikTok preuzima, MP4, MOV ili WebM, na proverenom domenu ili prefiksu URL-a.
  • post_info: obavezan u svakom pozivu, makar kao prazan objekat, i sadrži podešavanja objave.
  • post_info.caption: do 2.200 karaktera brojanih u UTF-16, sa #hashtagovima i do 30 @mentiona.
  • post_info.is_brand_organic i is_branded_content: oznake Promotional content i Paid partnership, koje TikTokova tabela označava kao obavezne.
  • post_info.disable_comment, disable_duet i disable_stitch: vrednost true isključuje komentare, Duet ili Stitch; sve tri su podrazumevano false.

Šta TikTok vraća?

Uobičajeni omotač, sa ID-jem zadatka objave u polju data. Kod 0 znači da je TikTok prihvatio zadatak, a ne da je video uživo: TikTok i dalje mora da preuzme fajl, proveri ga i moderira objavu. U TikTokovim primerima share_id videa počinje sa v_pub_url, a onaj za foto objavu sa 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?

Pozivom GET /business/publish/status/, prosleđujući business_id i share_id kao publish_id. status ima vrednost PROCESSING_DOWNLOAD dok TikTok preuzima fajl, PUBLISH_COMPLETE kada objava prođe moderaciju, ili FAILED sa razlogom. post_ids se pojavljuje uz PUBLISH_COMPLETE kada je objava javno vidljiva, a može kasniti do tri minuta. Ceo tok 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 da zameni provere statusa?

Da, za aplikaciju koja se pretplaćuje na event_type VIDEO pomoću /business/webhook/update/. TikTok tada šalje post.publish.failed ili post.publish.complete kada preuzme i proveri fajl, post.publish.publicly_available sa novim post_id kada objava prođe moderaciju, i post.publish.no_longer_publicly_available ako objava kasnije prestane da bude javna. Svaki događaj navodi zadatak u publish_id, istu vrednost kao share_id.

Kako objaviti video preko MCP-a?

Zatražite to običnim rečima od Claude-a, ChatGPT-ja ili drugog klijenta povezanog na https://easycoexistence.com/api/mcp. Asistent poziva publish_tiktok_post sa account_id iz list_social_accounts, HTTPS video_url, tekstom objave i, ako želite da komentari budu isključeni, disable_comment. Rezultat sadrži TikTokov share_id, a get_tiktok_publish_status, uz account_id i taj share_id, vraća TikTokov status, post_ids i reason onako kako stoje.

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>"] }

Šta publish_tiktok_post šalje TikToku?

Poziv istom endpointu, popunjen iz vašeg zahteva. Vaš link ide TikToku kao potpisani link preko sopstvene proverene medijske rute easyCoexistence, pa mu ne treba sopstvena verifikacija; tekst objave i disable_comment idu onako kako ste ih naveli; is_brand_organic i is_branded_content idu kao false. Ostala podešavanja, poput Duet, Stitch, naslovne slike i oznake AI-generisanog sadržaja, zadržavaju TikTokove podrazumevane vrednosti, a video se objavljuje kao javna objava, kako endpoint i jeste napravljen.

Šta se može raditi sa kredencijalima iz Partner API-ja?

Pozivajte TikTok direktno kao nalog. GET /channels/{id}?credentials=1 na https://easycoexistence.com/api/v1, sa ključem ec_live_ kao bearer tokenom, vraća kanal sa objektom credentials: api_base, business_id, važeći access_token i token_expires_at. Provere statusa, liste video-snimaka, komentari i uvidi izvode se tada iz vašeg koda. Objava je deo koji treba dobro isplanirati: direktan poziv za objavu prosleđuje video_url TikToku nedirnut, svojstva URL-a dodaju se sa ID-jem i tajnom sopstvene developer aplikacije, a prefiks koji je verifikovala aplikacija easyCoexistence jeste njena 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 da podesite

  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.

Česte greške

  • Izostavljanje post_info. TikTok zahteva objekat u svakom pozivu, čak i kada se nijedno podešavanje ne menja.
  • Traženje ID-ja objave u odgovoru na objavu. Vraća se samo share_id; ID-jevi objava dolaze iz poziva za status ili iz webhooka post.publish.publicly_available.
  • Ponavljanje poziva za objavu koji je prekinut zbog isteka vremena. Prvi zahtev je možda stigao do TikToka, pa proverite najnovije objave naloga pre ponovnog slanja.
  • Tumačenje koda 0 kao objavljenog videa. To znači da je TikTok prihvatio zadatak, a fajl i dalje može da ne prođe provere posle preuzimanja.
Ovo radite uz EasyCoexistence

US$ 9 do US$ 0,75 po vezi mesečno, uz pad kako dodajete veze, uz prvih 3 dana besplatno.

Često postavljana pitanja

Koji endpoint objavljuje video na TikToku?

POST https://business-api.tiktok.com/open_api/v1.3/business/video/publish/, sa tokenom naloga u zaglavlju Access-Token i business_id, video_url i post_info u JSON telu.

Može li TikTok API direktno da otpremi video fajl?

Ne preko /business/video/publish/. Endpoint prima video_url i sam preuzima fajl sa tog URL-a, pa video mora imati URL na proverenom domenu ili prefiksu URL-a.

Kako da dobijem ID videa objavljenog preko API-ja?

Iz post_ids u /business/publish/status/ kada status bude PUBLISH_COMPLETE i objava bude javna, ili iz post_id u webhooku post.publish.publicly_available.

Mogu li da zakažem TikTok video za kasnije preko API-ja?

Endpoint za objavu objavljuje odmah kada se pozove i nema polje za vreme. easyCoexistence čuva zakazane objave u sopstvenom redu i poziva TikTok u vreme koje podesite.

Nastavite sa čitanjem

Povežite prvi kanal za dva minuta.

Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo zvanični API-ji
  • Nadzor 24/7

Provereno na