API Threads : publier et lire avec l'API officielle

Oui, Threads a une API officielle, et c'est la plus accueillante que Meta propose. Tu publies en deux appels, tu peux lire tes posts, tes réponses et tes statistiques, et pour ton propre profil il n'y a pas d'app review. Le plafond est de 250 posts publiés et 1 000 réponses par 24 heures. Tout ce qui suit vient de la documentation Threads de Meta, lue le 10 septembre 2026.

Ce que l'API Threads sait faire aujourd'hui

D'après la présentation de l'API Threads, l'API couvre quatre tâches : créer et publier du contenu au nom d'un utilisateur, afficher les posts de cet utilisateur dans ton app, gérer les réponses et supprimer des posts. L'index de la documentation mentionne aussi les profils, les mentions, les statistiques, les webhooks, la recherche par mot-clé et le tag de localisation.

Les appels partent vers graph.threads.com ou graph.threads.net, avec un access token. Les scopes sont granulaires, donc ne demande que ce dont tu te sers :

Compare avec Instagram, où publier exige un compte professionnel lié à une Page Facebook plus une App Review, et tu comprends pourquoi Threads est l'endroit où je conseille de tester son code de publication en premier.

API de publication Threads : le flux de publication en deux étapes

Même forme que sur Instagram. Tu crées un conteneur média, puis tu le publies, comme décrit dans le guide des posts.

# 1. create the container
curl -X POST "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads" \
  -d "media_type=TEXT" \
  -d "text=Shipping notes for the week" \
  -d "access_token=<TOKEN>"
# -> { "id": "17890000000000000" }

# 2. publish it
curl -X POST "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads_publish" \
  -d "creation_id=17890000000000000" \
  -d "access_token=<TOKEN>"

media_type accepte TEXT, IMAGE ou VIDEO, avec image_url ou video_url pour les médias. Les posts texte sont limités à 500 caractères, et les emojis comptent pour leur nombre d'octets UTF-8 : un post plein d'emojis arrive donc à court de place plus vite que le compteur de caractères ne le laisse croire.

L'étape que tout le monde saute, c'est l'attente. Le conseil de Meta lui-même : « attends en moyenne 30 secondes avant de publier un conteneur média Threads pour laisser à nos serveurs le temps de traiter complètement l'upload ». Publie trop tôt sur une vidéo et tu récupères une erreur, pas un post. Intègre le délai, ou interroge le statut du conteneur avant l'étape 2.

Carrousels, réponses et qui a le droit de répondre

Un carrousel suit le même flux avec une couche en plus : crée chaque conteneur enfant avec is_carousel_item=true, crée un conteneur parent de type CAROUSEL qui liste les enfants, puis publie le parent. Deux enfants minimum, 20 maximum, images et vidéos mélangeables. Un carrousel compte pour un seul post dans ta limite de débit.

Les réponses passent par les mêmes endpoints de publication avec un reply_to_id, et elles ont leur propre budget, distinct de celui des posts.

C'est sur la modération que l'API Threads a une vraie longueur d'avance sur celle d'Instagram. D'après la documentation de gestion des réponses :

• reply_control se définit à la création du post et accepte everyone, accounts_you_follow, mentioned_only, parent_post_author_only ou followers_only.
• enable_reply_approvals=true sur le conteneur retient les réponses pour validation au lieu de les publier.
• POST /<THREADS_REPLY_ID>/manage_reply masque ou réaffiche une réponse de premier niveau et tout ce qui est imbriqué dessous.
• POST /<THREADS_REPLY_ID>/manage_pending_reply approuve ou refuse une réponse en attente dans la file, et GET /<threads-media-id>/pending_replies les liste.

Si tu construis n'importe quelle forme de réponse automatique, relis cette liste deux fois. Pouvoir mettre les réponses en attente d'approbation, c'est ce qui rend un compte automatisé viable.

Rate limits : les chiffres qui façonnent ta file

Les trois sont des fenêtres glissantes de 24 heures, par profil Threads, d'après l'aperçu de l'API :

Il y a aussi une formule de volume d'appels par-dessus : 4800 fois le nombre d'impressions, avec un minimum de 10 impressions. Un profil tout neuf sans portée obtient donc un petit budget d'appels, ce qui surprend les gens qui testent avec un compte vide.

Mis à côté de ses voisines, vérifiées le même jour : Instagram autorise 100 posts publiés par API sur 24 heures, et Facebook Pages applique 4800 appels multipliés par le nombre d'utilisateurs engagés. Threads est la plus généreuse des trois en volume de publication. Le tableau multi-plateformes complet est dans notre référence des rate limits des API social media, et la vue d'ensemble dans le guide 2026 des API social media.

Insights : ce que tu peux réellement mesurer

Deux endpoints, tous les deux demandant threads_manage_insights, d'après la documentation des insights.

Par post, GET /<threads-media-id>/insights renvoie views, likes, replies, reposts, quotes et shares.

Par compte, GET /<threads-user-id>/threads_insights renvoie views sous forme de série temporelle, puis likes, replies, reposts, quotes, clicks, followers_count et follower_demographics en totaux. Attention : la métrique replies au niveau du compte ne compte que les réponses de premier niveau, elle sera donc plus basse que la somme des réponses de chacun de tes posts.

Une limite dure : le timestamp le plus ancien accepté par l'API est 1712991600, le 13 avril 2024. Toute plage qui commence avant est rejetée, un job de backfill doit donc borner sa date de début.

Actualité de l'API Threads : ce qu'il y a dans la doc en septembre 2026

L'API Threads est sortie en 2024 avec la publication plus des lectures basiques. En lisant la documentation aujourd'hui, quatre choses vont plus loin que cette première version : la modération des réponses avec validation en attente, la recherche par mot-clé, les webhooks et le tag de localisation, avec son propre scope threads_location_tagging et un plafond de 500 recherches par jour.

Pour la plupart des projets, ce sont les webhooks qui comptent le plus. Interroger GET /<threads-media-id>/pending_replies à intervalles réguliers grignote ton budget d'appels face à cette formule d'impressions ; s'abonner, non.

Tu as besoin d'une intégration Threads, ou d'une couche par-dessus

Honnêtement : si Threads est le seul réseau qui t'intéresse, construis en direct. C'est l'intégration la moins chère de toute cette catégorie. Pas de review, deux endpoints pour publier, des scopes granulaires, une doc correcte. Tu publieras en un après-midi.

L'argument pour une couche est le même que partout ailleurs : tu veux aussi Instagram, LinkedIn, X, TikTok et YouTube, et tu n'as pas envie de six stockages de tokens, six pipelines média et trois app reviews. PlugKit publie sur Threads, avec les mêmes contraintes que celles fixées par Meta : du texte seul jusqu'à 500 caractères, une image ou une vidéo, ou un carrousel de 2 à 20. Le guide de publication donne le détail plateforme par plateforme.

Pour savoir ce que change une couche quand c'est un agent qui appelle, et non un cron, vois le guide de configuration de Hermes Agent et le hub /social-media-api/. PlugKit, c'est 49 $ par mois pour 5 comptes connectés, résiliable à tout moment.

FAQ

Est-ce que Threads a une API officielle ?

Oui. Meta a sorti l'API Threads en 2024 et elle couvre aujourd'hui la publication, la lecture de tes propres posts et de ton profil, les réponses et la modération, les statistiques, les webhooks, la recherche par mot-clé et le tag de localisation. Elle tourne sur graph.threads.com ou graph.threads.net avec des access tokens OAuth et des scopes granulaires.

Combien de posts est-ce que je peux publier par jour via l'API Threads ?

250 posts publiés sur une fenêtre glissante de 24 heures, par profil Threads. Les réponses ont un budget distinct de 1 000 par 24 heures et les suppressions sont plafonnées à 100. Un carrousel compte pour un post, pas pour un post par image.

Est-ce que l'API Threads est gratuite ?

Meta ne facture pas les appels à l'API Threads. Le coût est dans les limites : les plafonds de posts, de réponses et de suppressions ci-dessus, plus un budget d'appels de 4800 fois ton nombre d'impressions avec un minimum de 10 impressions, donc un profil sans audience obtient une petite enveloppe.

Est-ce qu'il faut une app review pour publier sur Threads via l'API ?

Pas pour ton propre profil. Publier demande les scopes threads_basic et threads_content_publish, que tu peux t'autoriser toi-même. L'app review entre en jeu quand ton app agit pour les profils d'autres personnes, la règle est la même que sur le reste de la plateforme Meta.

Est-ce que je peux programmer des posts Threads avec l'API ?

Pas côté Meta. L'API publie au moment où tu appelles threads_publish : c'est donc ton propre planificateur qui garde la file et déclenche à la bonne minute, ou un service qui la garde pour toi. N'oublie pas les 30 secondes d'attente recommandées entre la création du conteneur et sa publication.

AB

Antoine BlancoFondateur de PlugKit. Gère ses propres comptes Instagram, YouTube et X via l'API et le serveur MCP décrits ici.