Conectați-văÎncepeți perioada de probă gratuită
easyCoexistence API-uri oficiale

Cum să publici un videoclip pe TikTok prin API

Pentru a publica un videoclip prin API-ul TikTok for Business, trimiteți POST /business/video/publish/ cu câmpul business_id al contului, un video_url pe un domeniu sau prefix URL verificat și un obiect post_info cu legenda și setările, împreună cu antetul Access-Token. TikTok răspunde cu un share_id; transmiteți-l ca publish_id către /business/publish/status/ până când statusul devine PUBLISH_COMPLETE și apar post_ids.

easyCoexistence publică videoclipuri TikTok cu publish_tiktok_post din Claude, ChatGPT sau propriul agent: transmiteți un link HTTPS, legenda și dacă comentariile sunt active, apoi urmăriți postarea cu get_tiktok_publish_status, în timp ce fișierul ajunge la TikTok prin ruta media verificată.

share_id

Returnat de apelul de publicare, de exemplu v_pub_url~v1.2345123456789123456, și transmis apelului de status ca publish_id.

Nov 16, 2023

De atunci, TikTok refuză să publice videoclipuri de la URL-uri al căror domeniu sau prefix URL nu este verificat.

6 a minute

Limita TikTok pentru postările video per cont prin endpoint-ul de publicare este de cel mult 15 pe zi.

3 min

Cât poate dura până apar post_ids după PUBLISH_COMPLETE; TikTok recomandă reîncercarea după 3 minute.

post_id

Trimis în webhook-ul post.publish.publicly_available după ce postarea trece de moderare, fiind gata pentru interogarea statisticilor.

Ce aveți nevoie înainte de primul apel?

Trei lucruri. Un token de acces TikTok și open_id-ul contului, obținute din schimbul de token; o aplicație de dezvoltator cu permisiunea Video Publish din TikTok Accounts; și videoclipul la un URL public HTTPS sau HTTP, aflat sub un domeniu sau prefix URL verificat pentru aplicație. TikTok descarcă singur fișierul, deci trebuie să rămână accesibil, iar TikTok recomandă un URL valabil cel puțin 30 de minute.

Cum arată cererea de publicare?

Un POST către https://business-api.tiktok.com/open_api/v1.3/business/video/publish/ cu token-ul contului în antetul Access-Token și Content-Type setat la application/json. Corpul JSON indică contul în business_id, fișierul în video_url și setările postării în post_info; acesta publică un videoclip cu legendă, cu comentariile, Duet și Stitch lăsate active:

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

Ce face fiecare câmp din corp?

Câmpurile pe care le listează referința TikTok pentru o postare video, de la nivelul de sus în jos. Coperta, eticheta generată de AI, o locație, ciornele și opțiunea doar pentru reclame se află în același corp:

  • business_id: open_id-ul contului din schimbul de token.
  • video_url: fișierul pe care îl descarcă TikTok, MP4, MOV sau WebM, pe un domeniu sau prefix URL verificat.
  • post_info: obligatoriu la fiecare apel, chiar și ca obiect gol, și locul setărilor postării.
  • post_info.caption: până la 2.200 de caractere numărate în UTF-16, cu #hashtag-uri și până la 30 de @mențiuni.
  • post_info.is_brand_organic și is_branded_content: etichetele Promotional content și Paid partnership, pe care tabelul TikTok le marchează ca obligatorii.
  • post_info.disable_comment, disable_duet și disable_stitch: true dezactivează comentariile, Duet sau Stitch; toate trei au valoarea implicită false.

Ce returnează TikTok?

Răspunsul obișnuit, cu ID-ul sarcinii de publicare în câmpul data. Codul 0 înseamnă că TikTok a acceptat sarcina, nu că videoclipul este live: TikTok trebuie încă să descarce fișierul, să-l verifice și să moderze postarea. În exemplele TikTok, share_id-ul unui videoclip începe cu v_pub_url, iar al unei postări cu fotografii cu p_pub_url.

The publish response
{
  "code": 0,
  "message": "Ok",
  "request_id": "20210817034316010245031056097316BA",
  "data": {
    "share_id": "v_pub_url~v1.2345123456789123456"
  }
}

Cum urmăriți postarea până devine live?

Cu GET /business/publish/status/, transmițând business_id și share_id ca publish_id. Statusul are valoarea PROCESSING_DOWNLOAD cât timp TikTok preia fișierul, PUBLISH_COMPLETE odată ce postarea a trecut moderarea sau FAILED, cu un motiv. post_ids apare odată cu PUBLISH_COMPLETE, când postarea poate fi vizualizată public, și poate întârzia cu până la 3 minute. Fluxul complet în Python:

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

Poate un webhook înlocui verificările de status?

Da, pentru o aplicație care se abonează la event_type VIDEO cu /business/webhook/update/. TikTok trimite apoi post.publish.failed sau post.publish.complete după ce a descărcat și verificat fișierul, post.publish.publicly_available cu noul post_id după ce moderarea este trecută și post.publish.no_longer_publicly_available dacă postarea iese ulterior din vizualizarea publică. Fiecare eveniment indică sarcina în publish_id, aceeași valoare ca share_id.

Cum publicați un videoclip prin MCP?

Cereți în cuvinte simple din Claude, ChatGPT sau alt client conectat la https://easycoexistence.com/api/mcp. Asistentul apelează publish_tiktok_post cu account_id din list_social_accounts, un video_url HTTPS, legenda și, dacă doriți comentariile dezactivate, disable_comment. Rezultatul conține share_id-ul TikTok, iar get_tiktok_publish_status, primind account_id și acel share_id, returnează statusul, post_ids și motivul, exact cum sunt în TikTok.

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

Ce trimite publish_tiktok_post către TikTok?

Un apel către același endpoint, completat din cererea dumneavoastră. Linkul dumneavoastră ajunge la TikTok ca link semnat prin ruta media verificată proprie easyCoexistence, deci nu are nevoie de o verificare separată; legenda și disable_comment merg așa cum le-ați transmis; iar is_brand_organic și is_branded_content merg ca false. Celelalte setări, precum Duet, Stitch, coperta și eticheta generată de AI, păstrează valorile implicite ale TikTok, iar videoclipul se publică ca postare publică, așa cum este conceput endpoint-ul.

Ce puteți face cu acreditivele din Partner API?

Apelați direct TikTok în numele contului. GET /channels/{id}?credentials=1 pe https://easycoexistence.com/api/v1, cu cheia dumneavoastră ec_live_ ca bearer token, returnează canalul cu un obiect credentials: api_base, business_id, un access_token curent și token_expires_at. Verificările de status, listele de videoclipuri, comentariile și statisticile rulează apoi din propriul cod. Publicarea este partea de planificat: un apel direct de publicare trimite video_url către TikTok neschimbat, proprietățile URL-ului se adaugă cu ID-ul și secretul propriei aplicații de dezvoltator, iar prefixul verificat de aplicația easyCoexistence este ruta sa media, pe care o folosește 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>'

Cum să îl configurați

  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.

Greșeli frecvente

  • Lăsarea din post_info. TikTok cere obiectul la fiecare apel, chiar și când nicio setare nu se schimbă.
  • Căutarea unui ID de postare în răspunsul de publicare. Acesta returnează doar share_id; ID-urile postărilor vin din apelul de status sau din webhook-ul post.publish.publicly_available.
  • Repetarea unui apel de publicare care a expirat. Prima cerere ar fi putut ajunge la TikTok, deci verificați ultimele postări ale contului înainte de a o trimite din nou.
  • Tratarea codului 0 ca videoclip live. Înseamnă că TikTok a acceptat sarcina, iar fișierul poate eșua verificările și după descărcare.
Faceți acest lucru cu EasyCoexistence

US$ 9 până la US$ 0,75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu perioadă de probă gratuită de 3 zile.

Întrebări frecvente

Ce endpoint publică un videoclip pe TikTok?

POST https://business-api.tiktok.com/open_api/v1.3/business/video/publish/, cu token-ul contului în antetul Access-Token și business_id, video_url și post_info în corpul JSON.

Poate API-ul TikTok să încarce direct un fișier video?

Nu prin /business/video/publish/. Acesta primește video_url și preia fișierul de acolo, deci videoclipul are nevoie de un URL pe un domeniu sau prefix URL verificat.

Cum obțin ID-ul unui videoclip publicat prin API?

Din post_ids din /business/publish/status/ odată ce statusul este PUBLISH_COMPLETE și postarea este publică, sau din post_id din webhook-ul post.publish.publicly_available.

Pot programa un videoclip TikTok pentru mai târziu prin API?

Endpoint-ul de publicare postează în momentul apelării și nu are câmp de oră. easyCoexistence păstrează postările programate în propria coadă și apelează TikTok la ora pe care o stabiliți.

Continuați să citiți

Conectați primul canal în două minute.

Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.

  • 3 zile gratuit
  • Anulați oricând
  • Doar API-uri oficiale
  • Monitorizat 24/7

Verificat la