AccediInizia la prova gratuita
easyCoexistence API ufficiali

Come pubblicare un video su TikTok tramite l'API

Per pubblicare un video tramite l'API for Business di TikTok, invia POST /business/video/publish/ con il business_id dell'account, un video_url su un dominio o un prefisso URL verificato e un oggetto post_info con didascalia e impostazioni, insieme all'header Access-Token. TikTok risponde con uno share_id; passalo come publish_id a /business/publish/status/ finché lo stato non diventa PUBLISH_COMPLETE e non compaiono i post_ids.

easyCoexistence pubblica video su TikTok con publish_tiktok_post da Claude, ChatGPT o dal tuo agente: passa un link HTTPS, la didascalia e se i commenti sono attivi, poi segui il post con get_tiktok_publish_status, mentre il file arriva a TikTok tramite la sua route media verificata.

share_id

Restituito dalla chiamata di pubblicazione, ad esempio v_pub_url~v1.2345123456789123456, e passato alla chiamata di stato come publish_id.

Nov 16, 2023

Da allora, TikTok rifiuta di pubblicare video da URL il cui dominio o prefisso URL non è verificato.

6 a minute

Il limite di TikTok sui post video per account tramite l'endpoint di pubblicazione: al massimo 15 al giorno.

3 min

Il tempo che possono impiegare i post_ids a comparire dopo PUBLISH_COMPLETE; TikTok consiglia di riprovare dopo tre minuti.

post_id

Inviato nel webhook post.publish.publicly_available quando un post supera la moderazione, pronto per interrogarne le statistiche.

Di cosa hai bisogno prima della prima chiamata?

Tre cose. Un access token dell'account TikTok e l'open_id dell'account, ottenuti dallo scambio del token; un'app sviluppatore con il permesso Video Publish sotto TikTok Accounts; e il video su un URL pubblico HTTPS o HTTP che si trova sotto un dominio o un prefisso URL verificato per l'app. TikTok scarica il file da solo, quindi deve restare raggiungibile, e consiglia un URL valido per almeno 30 minuti.

Com'è fatta la richiesta di pubblicazione?

Un POST a https://business-api.tiktok.com/open_api/v1.3/business/video/publish/ con il token dell'account nell'header Access-Token e Content-Type impostato su application/json. Il body JSON indica l'account in business_id, il file in video_url e le impostazioni del post in post_info; questo pubblica un video con didascalia lasciando attivi commenti, Duet e 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
    }
  }'

Cosa fa ciascun campo del body?

I campi che il riferimento di TikTok elenca per un post video, dal livello superiore in giù. Nello stesso body si trovano anche la copertina, l'etichetta di contenuto generato dall'IA, una posizione, le bozze e l'opzione riservata alla pubblicità:

  • business_id: l'open_id dell'account ottenuto dallo scambio del token.
  • video_url: il file che TikTok scarica, MP4, MOV o WebM, su un dominio o un prefisso URL verificato.
  • post_info: obbligatorio in ogni chiamata, anche come oggetto vuoto, e contiene le impostazioni del post.
  • post_info.caption: fino a 2,200 caratteri contati in UTF-16, con #hashtag e fino a 30 @menzioni.
  • post_info.is_brand_organic e is_branded_content: le etichette Contenuto promozionale e Partnership a pagamento, che la tabella di TikTok indica come obbligatorie.
  • post_info.disable_comment, disable_duet e disable_stitch: con true disattivano commenti, Duet o Stitch; tutti e tre hanno come default false.

Cosa restituisce TikTok?

La solita busta, con l'ID del task di pubblicazione in data. Un codice 0 significa che TikTok ha accettato il task, non che il video è online: TikTok deve ancora scaricare il file, verificarlo e moderare il post. Negli esempi di TikTok, lo share_id di un video inizia con v_pub_url, quello di un post fotografico con p_pub_url.

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

Come segui il post fino alla pubblicazione?

Con GET /business/publish/status/, passando business_id e lo share_id come publish_id. Lo stato è PROCESSING_DOWNLOAD mentre TikTok scarica il file, PUBLISH_COMPLETE quando il post ha superato la moderazione, oppure FAILED con un motivo. I post_ids arrivano con PUBLISH_COMPLETE quando il post è visibile pubblicamente e possono ritardare fino a tre minuti. Il flusso completo in 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

Un webhook può sostituire i controlli di stato?

Sì, per un'app che si iscrive all'event_type VIDEO con /business/webhook/update/. TikTok invia poi post.publish.failed oppure post.publish.complete una volta scaricato e controllato il file, post.publish.publicly_available con il nuovo post_id quando la moderazione è superata, e post.publish.no_longer_publicly_available se il post in seguito esce dalla visualizzazione pubblica. Ogni evento indica il task in publish_id, lo stesso valore dello share_id.

Come pubblichi un video tramite MCP?

Chiedilo in parole semplici a Claude, ChatGPT o un altro client collegato a https://easycoexistence.com/api/mcp. L'assistente chiama publish_tiktok_post con l'account_id ottenuto da list_social_accounts, un video_url HTTPS, la didascalia e, se vuoi disattivare i commenti, disable_comment. Il risultato contiene lo share_id di TikTok, e get_tiktok_publish_status, dato l'account_id e quello share_id, restituisce lo stato, i post_ids e il motivo così come TikTok li riporta in quel momento.

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

Cosa invia publish_tiktok_post a TikTok?

Una chiamata allo stesso endpoint, compilata con la tua richiesta. Il tuo link arriva a TikTok come link firmato sulla route media verificata di easyCoexistence, quindi non richiede una verifica propria; la didascalia e disable_comment vanno come li hai indicati; is_brand_organic e is_branded_content vanno come false. Le altre impostazioni, come Duet, Stitch, la copertina e l'etichetta generata dall'IA, mantengono i default di TikTok, e il video viene pubblicato come post pubblico, come è previsto dall'endpoint.

Cosa puoi fare con le credenziali della Partner API?

Chiamare TikTok direttamente come account. GET /channels/{id}?credentials=1 su https://easycoexistence.com/api/v1, con la tua chiave ec_live_ come bearer token, restituisce il canale con un oggetto credentials: api_base, business_id, un access_token aggiornato e token_expires_at. Controlli di stato, liste di video, commenti e statistiche vengono quindi eseguiti dal tuo codice. La pubblicazione è la parte da pianificare: una chiamata di pubblicazione diretta passa il video_url a TikTok senza modifiche, le proprietà dell'URL si aggiungono con l'ID e il secret di un'app sviluppatore propria, e il prefisso verificato dall'app di easyCoexistence è la sua route media, che usa 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>'

Come configurarlo

  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.

Errori comuni

  • Dimenticare post_info. TikTok lo richiede in ogni chiamata, anche quando nessuna impostazione cambia.
  • Cercare un ID del post nella risposta di pubblicazione. Restituisce solo lo share_id; gli ID dei post arrivano dalla chiamata di stato o dal webhook publicly_available.
  • Ripetere una chiamata di pubblicazione andata in timeout. La prima richiesta potrebbe essere arrivata a TikTok, quindi controlla gli ultimi post dell'account prima di rinviarla.
  • Considerare il codice 0 un video online. Significa che TikTok ha accettato il task, e il file può ancora fallire i controlli dopo il download.
Farlo con EasyCoexistence

Da US$ 9 a US$ 0.75 per connessione al mese, con calo man mano che aggiungi connessioni, e i primi 3 giorni gratuiti.

Domande frequenti

Quale endpoint pubblica un video su TikTok?

POST https://business-api.tiktok.com/open_api/v1.3/business/video/publish/, con il token dell'account nell'header Access-Token e business_id, video_url e post_info nel body JSON.

L'API di TikTok può caricare direttamente un file video?

Non tramite /business/video/publish/. Richiede video_url e scarica il file da lì, quindi il video deve avere un URL su un dominio o un prefisso URL verificato.

Come ottengo l'ID di un video pubblicato tramite API?

Dai post_ids in /business/publish/status/ quando lo stato è PUBLISH_COMPLETE e il post è pubblico, oppure dal post_id nel webhook post.publish.publicly_available.

Posso programmare un video TikTok per dopo tramite API?

L'endpoint di pubblicazione pubblica nel momento in cui viene chiamato e non ha un campo orario. easyCoexistence tiene i post programmati nella sua coda e chiama TikTok all'ora che imposti.

Continua a leggere

Collega il tuo primo canale in due minuti.

Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.

  • 3 giorni gratis
  • Disdici quando vuoi
  • Solo API ufficiali
  • Monitorato 24/7

Verificato il