Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

Comment publier une vidéo sur TikTok via l'API

Pour publier une vidéo via l'API for Business de TikTok, envoyez POST /business/video/publish/ avec le business_id du compte, un video_url sur un domaine ou un préfixe d'URL vérifié, et un objet post_info contenant la légende et les paramètres, avec l'en-tête Access-Token. TikTok répond par un share_id ; transmettez-le comme publish_id à /business/publish/status/ jusqu'à ce que le statut indique PUBLISH_COMPLETE et que les post_ids apparaissent.

easyCoexistence publie des vidéos TikTok avec publish_tiktok_post depuis Claude, ChatGPT ou votre propre agent : transmettez un lien HTTPS, la légende et l'activation des commentaires, puis suivez la publication avec get_tiktok_publish_status, tandis que le fichier atteint TikTok par sa route média vérifiée.

share_id

Renvoyé par l'appel de publication, par exemple v_pub_url~v1.2345123456789123456, et transmis à l'appel de statut comme publish_id.

Nov 16, 2023

Depuis, TikTok refuse de publier les vidéos dont l'URL a un domaine ou un préfixe d'URL non vérifié.

6 a minute

Le plafond de TikTok sur les publications vidéo par compte via l'endpoint de publication est de 15 par jour au maximum.

3 min

Le délai d'apparition des post_ids après PUBLISH_COMPLETE : TikTok recommande de réessayer après trois minutes.

post_id

Envoyé dans le webhook post.publish.publicly_available une fois la publication validée par la modération, prête à être interrogée pour ses statistiques.

De quoi avez-vous besoin avant le premier appel ?

Trois éléments : un token d'accès TikTok et l'open_id du compte, issus de l'échange de token ; une application développeur disposant de l'autorisation Video Publish sous TikTok Accounts ; et la vidéo à une URL HTTPS ou HTTP publique, située sous un domaine ou un préfixe d'URL vérifié pour l'application. TikTok télécharge lui-même le fichier : il doit donc rester accessible, et TikTok recommande une URL valable au moins 30 minutes.

À quoi ressemble la requête de publication ?

Un POST vers https://business-api.tiktok.com/open_api/v1.3/business/video/publish/, avec le token du compte dans l'en-tête Access-Token et Content-Type défini à application/json. Le corps JSON désigne le compte dans business_id, le fichier dans video_url et les paramètres de la publication dans post_info. Celui-ci publie une vidéo avec légende, en laissant activés les commentaires, le Duet et le 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
    }
  }'

Que fait chaque champ du corps ?

Les champs que la référence de TikTok liste pour une publication vidéo, en commençant par le niveau supérieur. La couverture, l'étiquette générée par IA, un lieu, les brouillons et l'option réservée aux publicités figurent dans le même corps :

  • business_id : l'open_id du compte, issu de l'échange de token.
  • video_url : le fichier que TikTok télécharge, au format MP4, MOV ou WebM, sur un domaine ou un préfixe d'URL vérifié.
  • post_info : obligatoire à chaque appel, même sous forme d'objet vide, et porteur des paramètres de la publication.
  • post_info.caption : jusqu'à 2 200 caractères comptés en UTF-16, avec des #hashtags et jusqu'à 30 @mentions.
  • post_info.is_brand_organic et is_branded_content : les mentions Contenu promotionnel et Partenariat rémunéré, que le tableau de TikTok marque comme obligatoires.
  • post_info.disable_comment, disable_duet et disable_stitch : true désactive les commentaires, le Duet ou le Stitch ; les trois sont à false par défaut.

Que renvoie TikTok ?

L'enveloppe habituelle, avec l'identifiant de la tâche de publication dans data. Un code 0 signifie que TikTok a accepté la tâche, pas que la vidéo est en ligne : TikTok doit encore télécharger le fichier, le vérifier et modérer la publication. Dans les exemples de TikTok, le share_id d'une vidéo commence par v_pub_url et celui d'une publication photo par p_pub_url.

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

Comment suivre la publication jusqu'à sa mise en ligne ?

Avec GET /business/publish/status/, en passant business_id et le share_id comme publish_id. Le statut vaut PROCESSING_DOWNLOAD pendant que TikTok récupère le fichier, PUBLISH_COMPLETE une fois la publication validée par la modération, ou FAILED avec une raison. Les post_ids arrivent avec PUBLISH_COMPLETE lorsque la publication est visible publiquement, et peuvent prendre jusqu'à trois minutes. Voici le flux complet en 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 peut-il remplacer les vérifications de statut ?

Oui, pour une application qui s'abonne à event_type VIDEO avec /business/webhook/update/. TikTok envoie alors post.publish.failed ou post.publish.complete une fois le fichier téléchargé et contrôlé, post.publish.publicly_available avec le nouveau post_id dès que la modération est passée, et post.publish.no_longer_publicly_available si la publication quitte ensuite la vue publique. Chaque événement désigne la tâche dans publish_id, qui a la même valeur que le share_id.

Comment publier une vidéo via MCP ?

Demandez-le en langage courant à Claude, ChatGPT ou tout autre client connecté à https://easycoexistence.com/api/mcp. L'assistant appelle publish_tiktok_post avec le account_id obtenu via list_social_accounts, une video_url en HTTPS, la légende et, si vous voulez désactiver les commentaires, disable_comment. Le résultat contient le share_id de TikTok, et get_tiktok_publish_status, avec le account_id et ce share_id, renvoie le statut, les post_ids et la raison tels qu'ils sont actuellement.

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

Qu'envoie publish_tiktok_post à TikTok ?

Un appel au même endpoint, rempli à partir de votre demande. Votre lien part vers TikTok sous forme de lien signé passant par la route média vérifiée d'easyCoexistence, si bien qu'il ne nécessite aucune vérification propre ; la légende et disable_comment sont transmis tels que vous les avez donnés ; et is_brand_organic et is_branded_content sont envoyés à false. Les autres paramètres, comme le Duet, le Stitch, la couverture et l'étiquette générée par IA, gardent les valeurs par défaut de TikTok, et la vidéo est publiée comme publication publique, comme l'endpoint est conçu pour le faire.

Que permettent les identifiants de l'API partenaire ?

D'appeler TikTok directement au nom du compte. GET /channels/{id}?credentials=1 sur https://easycoexistence.com/api/v1, avec votre clé ec_live_ en token bearer, renvoie le canal avec un objet credentials : api_base, business_id, un access_token à jour et token_expires_at. Les vérifications de statut, les listes de vidéos, les commentaires et les statistiques s'exécutent alors depuis votre propre code. La publication demande de la préparation : un appel direct de publication transmet video_url à TikTok sans modification, les propriétés d'URL se déclarent avec l'identifiant et le secret de votre propre application développeur, et le préfixe que l'application d'easyCoexistence a fait vérifier est sa route média, que publish_tiktok_post utilise.

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

Comment le configurer

  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.

Erreurs courantes

  • Oublier post_info. TikTok l'exige à chaque appel, même lorsqu'aucun paramètre ne change.
  • Chercher un identifiant de publication dans la réponse de publication. Elle ne renvoie que le share_id ; les post_ids viennent de l'appel de statut ou du webhook publicly_available.
  • Relancer un appel de publication dont la réponse n'est pas arrivée. La première requête a pu atteindre TikTok : vérifiez les dernières publications du compte avant de la renvoyer.
  • Considérer le code 0 comme une vidéo en ligne. Il signifie que TikTok a accepté la tâche, et le fichier peut encore échouer à ses contrôles après le téléchargement.
Faire cela avec EasyCoexistence

De US$ 9 à US$ 0,75 par connexion et par mois, en baisse à mesure que vous ajoutez des connexions, les 3 premiers jours étant offerts.

Questions fréquemment posées

Quel endpoint publie une vidéo sur TikTok ?

POST https://business-api.tiktok.com/open_api/v1.3/business/video/publish/, avec le token du compte dans l'en-tête Access-Token, et business_id, video_url et post_info dans le corps JSON.

L'API TikTok peut-elle téléverser directement un fichier vidéo ?

Pas via /business/video/publish/. Cet endpoint prend video_url et récupère le fichier à cette adresse ; la vidéo doit donc disposer d'une URL sur un domaine ou un préfixe d'URL vérifié.

Comment obtenir l'identifiant d'une vidéo publiée via l'API ?

Depuis les post_ids de /business/publish/status/ lorsque le statut est PUBLISH_COMPLETE et que la publication est publique, ou depuis le post_id du webhook post.publish.publicly_available.

Peut-on programmer une vidéo TikTok pour plus tard via l'API ?

L'endpoint de publication publie au moment de l'appel et n'a pas de champ horaire. easyCoexistence conserve les publications programmées dans sa propre file d'attente et appelle TikTok à l'heure que vous avez fixée.

Poursuivre la lecture

Connectez votre premier canal en deux minutes.

Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.

  • 3 jours gratuits
  • Résiliable à tout moment
  • API officielles uniquement
  • Supervisé 24/7

Vérifié le