Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

Suggestions de hashtags TikTok et hashtags tendance via l'API

L'API for Business de TikTok suggère des hashtags via GET /business/hashtag/suggestion/, qui prend un mot-clé dans l'une des 35 langues et renvoie 10 hashtags, chacun avec le nombre de publications qui l'utilisent, pour le token propre à un compte TikTok. Les hashtags populaires viennent de GET /discovery/trending_list/, qui classe les 200 premiers par pays, secteur et période pour le token d'un annonceur.

easyCoexistence connecte les comptes TikTok via l'API for Business de TikTok, afin que votre propre code récupère des suggestions de hashtags avec le token de get_social_credentials, et que Claude, ChatGPT ou ce code les insère dans la légende et publie ou planifie la publication avec publish_tiktok_post, chaque connexion étant surveillée 24/7.

35

Langues acceptées par le paramètre language de l'endpoint de suggestion, en par défaut ; les suggestions sont renvoyées dans la langue du mot-clé.

40 a minute

Requêtes qu'un compte autorisé peut envoyer à un seul endpoint de l'API Accounts, suggestions de hashtags incluses.

NEW

Valeur de rank_change pour un hashtag populaire absent du top 200 de la période précédente.

30 days

Durée maximale de trending_history, le rang et les vues quotidiens que TikTok renvoie pour chaque hashtag populaire.

10

Nombre maximal de hashtag_ids que /discovery/video_list/ accepte en un seul appel, avec les 20 vidéos tendance en tête pour chacun.

Quels endpoints TikTok renvoient des hashtags ?

Cinq endpoints de l'API for Business de TikTok renvoient des hashtags pour les publications organiques, et ils se distinguent par le token qu'ils attendent : celui d'un compte TikTok ou celui d'un annonceur issu d'un compte publicitaire autorisé. Un sixième, parmi les outils de la Marketing API, recommande plutôt des hashtags pour le ciblage publicitaire :

/business/hashtag/suggestion/10 hashtags for a keyword, for captions; account token
/discovery/trending_list/Top 200 popular hashtags by country, category and period; advertiser token
/discovery/detail/One popular hashtag's numbers, ad status and viewer ages; advertiser token
/discovery/video_list/Top 20 trending videos for up to 10 popular hashtags; advertiser token
/business/mention/top_hashtag/list/The 20 hashtags used most in posts that @mention the business; account token
/tool/hashtag/recommend/Hashtags to target ads at, under an advertiser_id; not for captions

Comment appeler l'endpoint de suggestion ?

Avec un GET qui porte le business_id du compte, un mot-clé et, facultativement, language, dont les 35 valeurs vont de en, par défaut, jusqu'à zh-Hant-TW en passant par es, pt-BR et ja-JP ; TikTok fait correspondre les suggestions à la langue du mot-clé. L'en-tête Access-Token contient le token du compte TikTok, et la référence API de TikTok rattache l'endpoint à la permission Video Publish de TikTok Accounts, la même que celle utilisée pour publier des vidéos :

Hashtag suggestions for a keyword, after TikTok's own example
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/hashtag/suggestion/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  --data-urlencode 'business_id=<OPEN_ID>' \
  --data-urlencode 'keyword=summer' \
  --data-urlencode 'language=en'

{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": {
    "suggestions": [
      { "name": "summer", "post_count": 65296335 },
      { "name": "summertime", "post_count": 4787632 },
      { "name": "summeroutfit", "post_count": 2245117 }
    ]
  }
}

Que contient chaque suggestion ?

Un nom, le hashtag à utiliser et post_count, le nombre total de publications qui l'ont utilisé. TikTok renvoie 10 suggestions, les correspondances exactes au mot-clé en premier, puis le reste par nombre de publications. La liste ne contient aucune donnée de tendance : un post_count élevé indique un hashtag que beaucoup de publications utilisent déjà, ce qui est un signal distinct des rangs en hausse que signale /discovery/trending_list/.

Quels tokens et permissions chaque endpoint exige-t-il ?

Ils diffèrent davantage que ne le laissent penser les chemins, alors vérifiez-les avant de construire :

  • /business/hashtag/suggestion/ : le token d'accès d'un compte TikTok et son business_id, l'application disposant de Video Publish sous TikTok Accounts.
  • /discovery/trending_list/, /discovery/detail/ et /discovery/video_list/ : un token d'accès annonceur et un advertiser_id issus de l'autorisation d'un compte publicitaire, l'application disposant de Discovery sous Creative Management.
  • /business/mention/top_hashtag/list/ : le scope biz.brand.insights, sur un compte avec Advanced Access ou un Verified Business Account.
  • /tool/hashtag/recommend/ : le token d'un annonceur et son advertiser_id ; la référence de TikTok ne prévoit aucune permission pour cet endpoint.

Que renvoient les hashtags tendance ?

GET /discovery/trending_list/ prend discovery_type réglé sur HASHTAG, sa seule valeur, avec les paramètres facultatifs country_code, category_name et date_range ; category_name accepte un secteur de niveau 1 ou 2 comme FOOD_AND_BEVERAGE ou COOKING. Pour chaque hashtag, il renvoie :

  • rank_position dans la catégorie, et rank_change par rapport à la période précédente : positif quand il a monté, négatif quand il a baissé, NEW quand il ne figurait pas dans le top 200.
  • views et posts dans le pays et la période choisis, à côté de views_global_lifetime et posts_global_lifetime.
  • top_country_list : les cinq pays où le hashtag est le plus populaire.
  • trending_history : jusqu'à 30 jours de rank_position_daily et de views_daily, avec la valeur null lorsque le hashtag n'a pas été tendance ou a obtenu moins de 1 000 vues ce jour-là.

Comment creuser un hashtag populaire ?

Avec deux appels de plus, sur le même token annonceur. /discovery/detail/ prend un hashtag_id issu de la liste, avec le même country_code et le même date_range que l'appel de liste, et ajoute hashtag_status, ONLINE lorsque le hashtag est disponible pour la création de publicités, ainsi que l'âge des spectateurs en trois tranches, 18-24, 25-34 et 35+, laissé vide quand le statut est OFFLINE ou que l'audience estimée est inférieure à 1 000. /discovery/video_list/ prend jusqu'à 10 hashtag_ids et renvoie pour chacun les 20 vidéos tendance en tête, classées selon un score combinant vues, commentaires, j'aime et partages.

Comment un assistant IA rédige-t-il la légende d'une publication avec des suggestions ?

Avec une première étape dans votre propre code. Les outils d'easyCoexistence ne récupèrent pas de suggestions : votre code les demande donc à TikTok avec le token de get_social_credentials ; l'assistant garde ensuite celles qui conviennent à la publication, les insère dans la légende avec le signe # et publie via publish_tiktok_post, immédiatement ou à une heure fixée. Les notes de publication de TikTok précisent que les hashtags d'une légende envoyée par l'API s'affichent comme du texte brut dans l'application :

1Pick keywordsFrom the post's topic, in the caption's language
2Ask TikTokbusiness/hashtag/suggestion/, from your own code
3ChooseThe names that fit, weighed by post_count
4Write#name in the caption, within 2,200 UTF-16 units on a video
5Publishpublish_tiktok_post, now or with scheduled_at

Quelle est la portée d'easyCoexistence, et ce qui lui échappe ?

get_social_credentials donne à votre propre code le token et le business_id du compte pour les chemins TikTok sous business/ ; les suggestions de hashtags fonctionnent donc, de même que /business/mention/top_hashtag/list/, que TikTok ouvre au compte via l'API Mentions. Les endpoints Discovery sont hors de portée : ils attendent le token d'un annonceur et un advertiser_id plutôt que ceux du compte. Ses outils dédiés ne renvoient aucun hashtag.

Suggestions, then a scheduled post with them in the caption
GET https://business-api.tiktok.com/open_api/v1.3/business/hashtag/suggestion/
  ?business_id=<BUSINESS_ID>&keyword=recetas&language=es
Access-Token: <ACCESS_TOKEN>

publish_tiktok_post {
  "account_id": "<ACCOUNT_ID>",
  "video_url": "https://media.example.com/tiktok/tortilla.mp4",
  "caption": "Tortilla en 10 minutos #recetas #recetasfaciles #cocina",
  "scheduled_at": "2026-11-12T19:30:00+01:00"
}

Erreurs courantes

  • Coller les valeurs name telles quelles dans une légende. L'exemple de TikTok renvoie des noms sans le signe #, il faut donc l'ajouter devant chacun.
  • Classer les suggestions par view_count. TikTok a programmé l'abandon de ce champ d'ici le 9 octobre 2026. Classez donc par post_count.
  • Prendre une suggestion avec un post_count de 0 pour un hashtag déjà utilisé. TikTok renvoie ainsi le mot-clé lui-même lorsqu'il n'a rien à suggérer.
  • Demander /discovery/detail/ avec un country_code ou un date_range différent de ceux de l'appel de liste. TikTok répond par une erreur, et un hashtag hors de la liste reçoit une réponse vide.
Faire cela avec EasyCoexistence

De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec les 3 premiers jours gratuits.

Questions fréquemment posées

Combien de hashtags une légende TikTok peut-elle contenir via l'API ?

Les notes de publication de TikTok ne fixent aucune limite distincte pour les hashtags : ils comptent dans la légende, jusqu'à 2 200 caractères UTF-16 sur une publication vidéo et 4 000 sur une publication photo, où les @mentions plafonnent à 30.

Peut-on obtenir des suggestions de hashtags dans d'autres langues ?

Oui. Transmettez language avec le mot-clé, par exemple pt-BR, es ou ja-JP ; les suggestions suivent la langue du mot-clé, et l'anglais est la valeur par défaut.

Un compte TikTok peut-il obtenir des hashtags tendance sans compte publicitaire ?

Pas via /discovery/trending_list/, qui attend un token d'annonceur. Un compte avec Advanced Access ou un Verified Business Account peut en revanche lire les 20 hashtags les plus utilisés dans les publications qui le mentionnent.

Combien coûte easyCoexistence pour un compte TikTok ?

De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec les 3 premiers jours gratuits ; chaque compte TikTok représente une connexion.

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