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 insights, et pour ton propre profil il n'y a aucune app review à passer. 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 l'aperçu de l'API Threads, l'API couvre quatre missions : 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 liste aussi les profils, les mentions, les insights, les webhooks, la recherche par mot-clé et le marquage de lieu.

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

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 pour Instagram. Crée un conteneur média, puis publie-le, comme décrit dans le guide 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 prend 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 chargé en emojis arrive donc à saturation plus vite que le nombre de caractères ne le laisse penser.

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, c'est 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 peuvent être mélangées. Un carrousel compte pour un seul post dans ta limite de débit.

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

La modération, c'est là où l'API Threads est vraiment en avance sur celle d'Instagram. D'après la doc de gestion des réponses :

• reply_control se définit à la création du post et prend everyone, accounts_you_follow, mentioned_only, parent_post_author_only ou followers_only.
• enable_reply_approvals=true sur le conteneur met les réponses en attente de 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 rejette 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 voisins, vérifié le même jour : Instagram autorise 100 posts publiés via API par 24 heures, et Facebook Pages utilise 4800 appels multipliés par le nombre d'utilisateurs engagés. Threads est le plus généreux des trois en volume de publication. Le tableau multiplateforme complet est dans notre référence des limites de débit des API réseaux sociaux, et le tableau d'ensemble est dans le guide des API réseaux sociaux 2026.

Insights : ce que tu peux réellement mesurer

Deux endpoints, qui ont tous les deux besoin de threads_manage_insights, d'après la doc 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 sous forme de totaux. À noter : la métrique replies compte ne compte que les réponses de premier niveau : le chiffre sera donc plus bas 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, donc un job de backfill doit borner sa date de départ.

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 au-delà de cette première version : la modération des réponses avec approbations en attente, la recherche par mot-clé, les webhooks, et le tag de lieu 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. Poller GET /<threads-media-id>/pending_replies à intervalles réguliers grignote ton budget d'appels selon 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 : 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 ce qu'une couche change quand l'appelant est un agent, et non un cron, voir le guide d'installation de Hermes Agent et le hub /social-media-api/. PlugKit, c'est 29 $ par mois pour 5 comptes connectés, résiliable à tout moment.

FAQ

Est-ce que Threads a une API officielle ?

Oui. Meta a lancé 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 insights, les webhooks, la recherche par mot-clé et le marquage de lieu. Elle fonctionne avec graph.threads.com ou graph.threads.net avec des tokens d'accès 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 exige les scopes threads_basic et threads_content_publish, que tu peux autoriser toi-même. La revue d'app entre en jeu quand ton app agit pour les profils d'autres personnes, c'est la même règle 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 quand tu appelles threads_publish, donc c'est ton propre scheduler qui garde la file et déclenche à la bonne minute, ou tu passes par 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.