Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

Médias TikTok : domaines vérifiés et préfixes d'URL

L'API for Business de TikTok télécharge les médias des publications à partir d'URL : video_url, custom_thumbnail_url et photo_images. Chaque URL doit se trouver sur un domaine ou un préfixe d'URL dont l'application développeur a vérifié la propriété. Un domaine se vérifie avec un enregistrement DNS TXT, un préfixe avec un fichier de signature placé sous ce préfixe, via /business/property/add/ et /business/property/verify/ avec l'app_id et le secret de l'application.

easyCoexistence diffuse vos médias à TikTok depuis son propre préfixe d'URL vérifié : publish_tiktok_post prend un lien HTTPS depuis Claude, ChatGPT ou votre propre code, et diffuse le fichier depuis ce lien lorsque TikTok le télécharge ; votre domaine n'a donc besoin d'aucune vérification.

Nov 16, 2023

Depuis cette date, TikTok refuse les URL de vidéos qui ne se trouvent pas sur un domaine ou un préfixe d'URL vérifié.

Oct 15, 2025

Depuis cette date, les endpoints de propriété d'URL exigent aussi le secret de l'application développeur.

1 / 2

Valeurs de property_type : 1 pour un domaine, 2 pour un préfixe d'URL.

0, 1, 2

Valeurs de property_status : pending, verified, et not verified, lorsque la tentative a échoué et doit être recommencée.

Apr 7, 2023

Les développeurs qui ont publié des vidéos avant cette date ont vu les domaines de ces URL de vidéos passés automatiquement en vérifiés.

5 MB

Taille maximale d'image acceptée par /business/comment/image/upload/, en données de formulaire multipart, pour un commentaire ou une réponse.

Quelles URL TikTok télécharge-t-il ?

Chaque champ média des deux endpoints de publication est une URL que TikTok récupère lui-même après avoir accepté l'appel ; le fichier doit donc rester accessible jusqu'à la fin du téléchargement :

  • video_url : la vidéo, que TikTok recommande de garder valide au moins 30 minutes.
  • custom_thumbnail_url : une image à utiliser comme couverture de la vidéo.
  • photo_images : jusqu'à 35 images pour une publication photo.
  • Délai : TikTok accorde une heure au téléchargement, puis fait échouer la publication avec video_pull_failed ou photo_pull_failed.

Quelle est la différence entre un domaine et un préfixe d'URL ?

Ce que vous prouvez posséder, et donc quelles URL comptent comme vérifiées. Un domaine convient aux médias sur un hôte que vous possédez ou contrôlez ; un préfixe convient à un dossier sur un hôte où vous ne pouvez que téléverser des fichiers. Voici les règles de TikTok pour chaque type de propriété :

DomainURL prefix
What it isA site you own, such as example.com or a subdomainhttps:// plus a host, a path and a final /, such as https://www.example.com/videos/
ProofA DNS TXT record holding the signatureA file named file_name, holding the signature, uploaded under the prefix
CoversURLs on the domain and its subdomainsURLs that begin with the prefix
Leaves outThe parent: verifying video.example.com leaves example.com unverifiedSibling paths: /folder/user/ leaves /folder/public/ unverified
RedirectsNot applicableNot followed; a prefix answering 3xx is invalid

Comment vérifier une propriété ?

Au moyen de deux appels authentifiés avec l'app_id et le secret de l'application développeur, et non un token de compte, la preuve étant placée entre les deux :

  • Ajout : POST /business/property/add/ avec url_property_meta, contenant property_type et url ; la réponse donne signature, ainsi que file_name pour un préfixe, avec property_status 0.
  • Preuve : placez la signature dans un enregistrement DNS TXT pour un domaine, ou dans un fichier public nommé file_name, avec une seule extension .txt, sous un préfixe.
  • Vérification : POST /business/property/verify/ avec le même url_property_meta ; property_status 1 signifie vérifiée, et 2 signifie que la tentative a échoué.
Add a URL prefix
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/property/add/' \
  -H 'Content-Type: application/json' \
  -d '{
    "app_id": "<APP_ID>",
    "secret": "<APP_SECRET>",
    "url_property_meta": { "property_type": 2, "url": "https://media.example.com/tiktok/" }
  }'

# data.url_property_info: url, property_type, property_status (0), signature, file_name

Comment lister ou supprimer des propriétés ?

GET /business/property/list/ avec app_id et secret renvoie url_property_info_list, chaque entrée contenant property_type, url, property_status, signature et file_name. Les sous-domaines d'un domaine vérifié comptent comme vérifiés sans appel propre, mais n'apparaissent dans la liste que s'ils ont été ajoutés. POST /business/property/delete/ avec app_id, secret et url_property_meta supprime une propriété que l'application ne possède plus ou ne contrôle plus.

Peut-on téléverser un fichier au lieu d'une URL ?

Pas pour les publications. L'API Accounts ne publie qu'à partir d'URL, brouillons compris, et son unique endpoint de téléversement, /business/comment/image/upload/, accepte une image de commentaire en données de formulaire multipart, au format JPG, JPEG, WebP ou PNG, jusqu'à 5 Mo, et renvoie un image_uri pour un commentaire ou une réponse. Le téléversement par morceaux relève de la Content Posting API sur developers.tiktok.com, une API distincte avec ses propres applications, où le mode de transfert s'appelle FILE_UPLOAD.

Que se passe-t-il avec une URL non vérifiée ?

TikTok refuse d'y publier. La référence de l'API for Business énonce la règle pour les vidéos et les photos, mais ne prévoit aucun code de retour propre à ce cas ; lisez donc le code et le message de la réponse. La Content Posting API sur developers.tiktok.com désigne le même cas par url_ownership_unverified, avec le code HTTP 403. Pour tester l'endpoint vidéo avant qu'une propriété soit vérifiée, TikTok publie une URL de vidéo de test qui ne nécessite aucune vérification :

TikTok's test video URL for /business/video/publish/
https://sf16-va.tiktokcdn.com/obj/eden-va2/uvpapzpbxjH-aulauvJ-WV[[/ljhwZthlaukjlkulzlp/3min.mp4

Comment easyCoexistence transmet-il vos médias à TikTok ?

Par un préfixe d'URL vérifié qui lui appartient, https://easycoexistence.com/api/social/media/. publish_tiktok_post prend votre lien HTTPS, refuse http:// avant tout envoi, et donne à TikTok un lien sous ce préfixe contenant un token signé qui désigne votre fichier, expire au bout de 6 heures et conserve l'extension de votre fichier. Lorsque TikTok le récupère, easyCoexistence vérifie le token, confirme que votre lien utilise HTTPS sur une adresse publique, et diffuse le fichier directement depuis votre lien, requêtes par plage (range) et redirections comprises, sans le stocker. Si votre lien échoue, TikTok ne peut pas télécharger le fichier et la publication échoue.

What TikTok receives in place of your link
Your link:       https://cdn.example.com/videos/launch.mp4
Sent to TikTok:  https://easycoexistence.com/api/social/media/<SIGNED_TOKEN>.mp4

Erreurs courantes

  • Vérifier un sous-domaine tout en hébergeant les fichiers sur son domaine parent. Une video.example.com vérifiée couvre ses propres sous-domaines, pas example.com lui-même.
  • Servir le fichier de signature du préfixe via une redirection. TikTok ne suit pas les redirections pour un préfixe d'URL et traite une réponse 3xx comme invalide.
  • Enregistrer le fichier de signature sous le nom name.txt.txt. TikTok attend que le nom de fichier corresponde à file_name, avec une seule extension .txt.
  • Supprimer le fichier juste après l'appel de publication. TikTok le télécharge ensuite, pendant une heure au plus, et fait échouer la publication si le lien cesse de fonctionner.
Faire cela avec EasyCoexistence

De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.

Questions fréquemment posées

Pourquoi TikTok exige-t-il des URL de médias vérifiées ?

TikTok indique que la vérification de la propriété des URL de vidéos l'aide à respecter ses règles sur les contenus protégés par le droit d'auteur et sur la sécurité des utilisateurs.

Un domaine TikTok vérifié couvre-t-il ses sous-domaines ?

Oui. Les sous-domaines d'un domaine vérifié comptent comme vérifiés, bien que /business/property/list/ ne les affiche que s'ils ont été ajoutés.

L'API for Business de TikTok peut-elle publier depuis un lien S3 ou CDN ?

Oui, lorsque le lien se trouve sous un domaine ou un préfixe d'URL vérifié par l'application, par exemple un préfixe sur un bucket ou un chemin CDN que vous contrôlez.

Les publications photo exigent-elles aussi des URL vérifiées ?

Oui. L'endpoint photo de TikTok précise que les publications photo ne peuvent pas être publiées à partir d'URL de photos non vérifiées.

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