L'API TikTok peut-elle rechercher des vidéos, des hashtags ou des tendances ?
Oui, l'API TikTok peut rechercher des vidéos, des publicités et des tendances, chacune dans une API distincte : la Research API recherche les vidéos publiques par mot-clé, hashtag, nom d'utilisateur, région ou date, pour les chercheurs que TikTok approuve. La Commercial Content API recherche les publicités par mot-clé ou nom d'annonceur. L'API for Business renvoie les hashtags populaires, leurs vidéos tendance et les mots-clés de recherche en tendance. La Display API lit le profil et les vidéos propres d'un utilisateur autorisé.
easyCoexistence connecte les comptes TikTok via l'API for Business de TikTok, afin que Claude, ChatGPT ou votre propre plateforme liste les publications et commentaires du compte et lise ses statistiques, et get_social_credentials donne à votre propre code le token pour les chemins business/ comme les suggestions de hashtags, chaque connexion étant surveillée en permanence.
Requêtes Research API autorisées par jour, pour jusqu'à 100 000 enregistrements, avec un quota réinitialisé à minuit UTC.
Écart maximal entre start_date et end_date dans une requête vidéo Research API, qui renvoie jusqu'à 100 vidéos par requête.
/discovery/trending_list/ classe les hashtags populaires d'un pays et d'une catégorie sur les 1, 7, 30 ou 120 derniers jours.
/discovery/trending/search/ renvoie les mots-clés de recherche en tendance, pour les comptes Advanced Access ou à compte d'entreprise vérifié.
Longueur maximale de search_term acceptée par la Commercial Content API, comparée comme expression exacte par défaut ou comme expression approximative.
Quelle API TikTok peut rechercher ?
Plusieurs, sur deux portails développeurs, chacun destiné à un type de développeur différent. developers.tiktok.com héberge la Research API, la Commercial Content API et la Display API ; business-api.tiktok.com héberge l'API for Business, dont les endpoints Discovery, Accounts et Mentions couvrent les tendances et le contenu propre d'une entreprise :
Comment la Research API recherche-t-elle des vidéos ?
Avec POST https://open.tiktokapis.com/v2/research/video/query/ et un token d'accès client portant le scope research.data.basic. L'objet query combine des conditions and, or et not, chacune une opération comme EQ ou IN sur un champ comme keyword, hashtag_name, username, region_code, create_date ou video_length. start_date et end_date, écrits YYYYMMDD, peuvent être espacés de 30 jours au maximum, et max_count renvoie jusqu'à 100 vidéos par requête :
curl -X POST 'https://open.tiktokapis.com/v2/research/video/query/?fields=id,video_description,create_time' \
-H 'Authorization: Bearer <CLIENT_ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"query": {
"and": [
{ "operation": "IN", "field_name": "region_code", "field_values": ["JP", "US"] },
{ "operation": "EQ", "field_name": "hashtag_name", "field_values": ["animal"] }
],
"not": [
{ "operation": "EQ", "field_name": "video_length", "field_values": ["SHORT"] }
]
},
"max_count": 100,
"start_date": "20261001",
"end_date": "20261030"
}'Que renvoie la Research API, et à quel point les données sont-elles récentes ?
Les champs de vidéos publiques nommés dans fields, comme id, video_description, create_time, region_code, view_count, like_count, comment_count, share_count, hashtag_names et username. La FAQ de TikTok prévient que les statistiques, comme le nombre de vues ou d'abonnés, peuvent mettre jusqu'à 10 jours à se mettre à jour, et que les nouvelles vidéos peuvent mettre jusqu'à 48 heures à apparaître dans la recherche. Le quota quotidien est de 1 000 requêtes, pour jusqu'à 100 000 enregistrements au total sur les API de recherche, réinitialisé à minuit UTC.
Qui peut utiliser la Research API ?
Les chercheurs dont TikTok approuve le projet ; un compte développeur seul n'ouvre pas l'accès. TikTok liste les établissements universitaires aux États-Unis, dans l'EEE, au Royaume-Uni, au Canada ou en Suisse, les organismes de recherche à but non lucratif ou indépendants dans l'UE, et les organisations universitaires ou à but non lucratif au Brésil qui étudient la sécurité des jeunes en ligne. Les candidats doivent travailler indépendamment des intérêts commerciaux, avec un projet de recherche défini, un financement déclaré et une évaluation éthique, et TikTok répond généralement sous 4 semaines. Interrogée sur l'éligibilité des créateurs, annonceurs et utilisateurs commerciaux, sa FAQ répond par la négative.
Comment rechercher des publicités avec la Commercial Content API ?
Avec POST https://open.tiktokapis.com/v2/research/adlib/ad/query/ et le scope research.adlib.basic. search_term accepte jusqu'à 50 caractères, comparés comme exact_phrase par défaut ou comme fuzzy_phrase, qui trouve une partie ou la totalité de ses mots, dans n'importe quel ordre ; les filtres affinent les résultats par dates de publication et pays ciblés, et chaque appel renvoie 10 publicités au maximum. La page produit de TikTok indique que les données commencent avec les publicités de l'UE et restent disponibles jusqu'à un an après la dernière diffusion d'une publicité. Le public et les chercheurs de tous pays peuvent faire une demande via un formulaire en ligne, et TikTok prévoit de répondre sous 2 jours ouvrés.
Quelles tendances renvoie l'API for Business ?
Celles de ses endpoints Discovery, qui diffèrent selon le token qu'ils prennent. /discovery/trending_list/ classe jusqu'à 200 hashtags populaires pour un pays, les États-Unis par défaut, et une catégorie d'industrie, sur 1, 7, 30 ou 120 jours, avec le rang, les vues et les publications de chaque hashtag, et /discovery/video_list/ renvoie les 20 vidéos tendance principales pour jusqu'à 10 de ces hashtags ; les deux prennent un advertiser_id et un token d'accès d'annonceur. Deux autres prennent le token d'un compte TikTok avec le scope discovery.search.words, pour les comptes Advanced Access ou à compte d'entreprise vérifié :
- /discovery/trending/search/ : 20 mots-clés de recherche en tendance sur TikTok, ou personnalisés pour le compte avec
is_personalized. - /discovery/trending/search/keyword/ : 20 mots-clés de recherche recommandés pour une requête allant jusqu'à 255 caractères, comme un produit ou une marque.
Que peut rechercher l'API propre à un compte TikTok ?
Des hashtags pour ses légendes, et des publications portant ses hashtags de marque. GET /business/hashtag/suggestion/ prend un mot-clé et une langue facultative et renvoie 10 hashtags, classés par correspondance exacte puis par nombre de publications, chacun avec son post_count. L'endpoint Mentions /business/mention/hashtag/video/list/ renvoie jusqu'à 1 000 publications publiques des 90 derniers jours utilisant l'un des hashtags de marque activés par l'entreprise, dont 50 au maximum, triées par date, j'aime, commentaires ou partages. Il nécessite le scope biz.brand.insights et un compte Advanced Access ou à compte d'entreprise vérifié.
La Display API peut-elle rechercher ?
Non. Elle lit l'utilisateur qui a autorisé l'application : /v2/user/info/ renvoie le profil de cet utilisateur, /v2/video/list/ ses vidéos publiques, les plus récentes d'abord et jusqu'à 20 par page, et /v2/video/query/ des vidéos précises par ID, sous les scopes user.info.basic et video.list. Aucun de ses endpoints ne prend un mot-clé ou un hashtag.
Que peut rechercher easyCoexistence sur TikTok ?
Ce que répond l'API propre au compte connecté. list_social_posts liste les publications récentes du compte et list_social_comments les commentaires d'une publication, tandis que votre propre code appelle les chemins de l'API for Business sous business/ avec le token de get_social_credentials, suggestions de hashtags comprises. Les chemins /discovery/ attendent le token d'un annonceur, donc le token du compte ne les atteint pas, et les Research API et Commercial Content API sont des produits distincts de developers.tiktok.com, qui ont chacun leur propre demande d'accès.
GET https://business-api.tiktok.com/open_api/v1.3/business/hashtag/suggestion/
?business_id=<BUSINESS_ID>&keyword=cold%20brew&language=en
Access-Token: <ACCESS_TOKEN>Erreurs courantes
- Demander l'accès à la Research API pour suivre une marque. La FAQ de TikTok répond par la négative pour les créateurs, annonceurs et utilisateurs commerciaux, et n'approuve que les projets de recherche non commerciaux.
- Interroger une longue période en un seul appel à la Research API. end_date peut être au maximum 30 jours après start_date, donc découpez les périodes plus longues en fenêtres.
- Lire les suggestions de hashtags comme des tendances. /business/hashtag/suggestion/ classe par correspondance exacte et nombre de publications, tandis que /discovery/trending_list/ classe la popularité sur une période choisie.
- Appeler les endpoints de recherche en tendance depuis un compte personnel. Ils répondent aux comptes Advanced Access ou à compte d'entreprise vérifié, avec discovery.search.words sur le token.
De US$ 9 à US$ 0,75 par connexion et par mois, avec un tarif qui baisse à mesure que vous ajoutez des connexions, et un essai gratuit de 3 jours.
Questions fréquemment posées
Peut-on rechercher des vidéos TikTok par mot-clé via l'API ?
Oui, avec la Research API, une fois votre projet de recherche approuvé par TikTok : sa requête vidéo accepte des conditions keyword et hashtag_name sur les vidéos publiques, jusqu'à 100 par requête.
Existe-t-il une API TikTok pour les hashtags tendance ?
Oui. /discovery/trending_list/ de l'API for Business classe jusqu'à 200 hashtags populaires pour un pays et une catégorie, chacun avec ses vues et publications, pour le token d'un annonceur.
Existe-t-il une API TikTok pour les vidéos tendance ?
Oui. /discovery/video_list/ de l'API for Business renvoie les 20 vidéos tendance principales pour jusqu'à 10 hashtags populaires, avec un advertiser_id et un token d'accès d'annonceur.
L'API TikTok peut-elle trouver les commentaires qui mentionnent mon compte ?
Oui, pour les comptes Advanced Access ou à compte d'entreprise vérifié : /business/mention/comment/list/ de l'API Mentions renvoie jusqu'à 1 000 commentaires ou réponses qui @mentionnent le compte, sous les scopes biz.brand.insights et comment.list.
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