Threads API: posten und lesen über die offizielle API

Ja, Threads hat eine offizielle API, und es ist die freundlichste, die Meta ausliefert. Du veröffentlichst mit zwei Calls, du kannst deine Posts, Antworten und Insights auslesen, und für dein eigenes Profil gibt es kein App Review. Die Grenze liegt bei 250 veröffentlichten Posts und 1.000 Antworten pro 24 Stunden. Alles Folgende stammt aus Metas Threads-Docs, gelesen am 10. September 2026.

Was die Threads API heute kann

Laut der Threads API Overview deckt die API vier Aufgaben ab: Inhalte im Namen eines Nutzers erstellen und veröffentlichen, dessen Posts in deiner App anzeigen, Antworten verwalten und Posts löschen. Der Dokumentationsindex führt außerdem Profile, Erwähnungen, Insights, Webhooks, Keyword-Suche und Standort-Tagging auf.

Die Calls gehen an graph.threads.com oder graph.threads.net, mit einem Access Token. Die Scopes sind granular, frag also nur das ab, was du auch nutzt:

Vergleich das mit Instagram, wo das Veröffentlichen ein professionelles Konto braucht, das mit einer Facebook Page verknüpft ist, plus App Review, und du verstehst, warum ich allen sage, ihren Publishing-Code zuerst auf Threads zu testen.

Threads Posting-API: der zweistufige Publish-Flow

Gleicher Ablauf wie bei Instagram. Erstelle einen Media-Container und veröffentliche ihn dann, so wie im Posts-Guide beschrieben.

# 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 akzeptiert TEXT, IMAGE oder VIDEO, mit image_url oder video_url für Medien. Textposts sind auf 500 Zeichen begrenzt, und Emojis zählen mit ihrer Anzahl an UTF-8-Bytes, ein Post voller Emojis stößt also früher an die Grenze, als die Zeichenzahl vermuten lässt.

Der Schritt, den alle überspringen, ist das Warten. Metas eigener Rat: "wait on average 30 seconds before publishing a Threads media container to give our server enough time to fully process the upload". Veröffentlichst du bei einem Video zu früh, bekommst du einen Fehler und keinen Post. Bau die Verzögerung ein, oder frag den Container-Status ab, bevor Schritt 2 kommt.

Karussells, Antworten und wer antworten darf

Ein Karussell läuft genauso ab, nur mit einer Ebene mehr: Erstelle jeden Child-Container mit is_carousel_item=true, dann einen Parent-Container vom Typ CAROUSEL, der die Children auflistet, und veröffentliche den Parent. Mindestens zwei Children, höchstens 20, Bilder und Videos lassen sich mischen. Ein Karussell zählt als ein einzelner Post auf dein Rate Limit.

Antworten laufen über dieselben Publish-Endpoints, mit einer reply_to_id, und sie haben ihr eigenes Budget getrennt von Posts.

Bei der Moderation ist die Threads API Instagram wirklich voraus. Aus den Docs zum Reply Management:

• reply_control legst du beim Erstellen des Posts fest, es akzeptiert everyone, accounts_you_follow, mentioned_only, parent_post_author_only oder followers_only.
• enable_reply_approvals=true am Container hält Antworten zur Freigabe zurück, statt sie zu veröffentlichen.
• POST /<THREADS_REPLY_ID>/manage_reply blendet eine Antwort der obersten Ebene samt allem, was darunter hängt, aus oder wieder ein.
• POST /<THREADS_REPLY_ID>/manage_pending_reply bestätigt oder lehnt eine Antwort in der Warteschlange ab, und GET /<threads-media-id>/pending_replies listet sie auf.

Wenn du irgendeine Form von Auto-Reply baust, lies diese Liste zweimal. Antworten zur Freigabe zurückhalten zu können, ist das, was einen automatisierten Account überlebensfähig macht.

Rate Limits: die Zahlen, die deine Queue prägen

Alle drei sind gleitende 24-Stunden-Fenster, pro Threads-Profil, aus dem API-Überblick:

Obendrauf kommt noch eine Formel für das Call-Volumen: 4800 mal die Anzahl der Impressions, bei mindestens 10 Impressions. Ein brandneues Profil ohne Reichweite bekommt damit nur ein kleines Call-Budget, was Leute überrascht, die mit einem leeren Account testen.

Neben die Geschwister gestellt, am selben Tag geprüft: Instagram erlaubt 100 per API veröffentlichte Posts pro 24 Stunden, und Facebook Pages rechnet mit 4800 Calls mal der Anzahl der aktiven Nutzer. Beim Publishing-Volumen ist Threads das großzügigste der drei. Die vollständige plattformübergreifende Tabelle steht in unserer Referenz zu Rate Limits der Social-Media-APIs, das größere Bild im Social-Media-API-Guide 2026.

Insights: was du tatsächlich messen kannst

Zwei Endpoints, beide brauchen threads_manage_insights, laut den Insights-Docs.

Pro Post liefert GET /<threads-media-id>/insights die Werte views, likes, replies, reposts, quotes und shares.

Pro Account liefert GET /<threads-user-id>/threads_insights die views als Zeitreihe, dazu likes, replies, reposts, quotes, clicks, followers_count und follower_demographics als Summen. Beachte, dass die Account-Metrik replies nur Antworten der obersten Ebene zählt, sie fällt also niedriger aus als die Summe deiner Antwortzahlen pro Post.

Eine harte Kante: Der früheste Timestamp, den die API akzeptiert, ist 1712991600, der 13. April 2024. Jeder Zeitraum, der davor beginnt, wird abgelehnt, ein Backfill-Job muss sein Startdatum also abfangen.

Neues zur Threads API: was im September 2026 in den Docs steht

Die Threads API kam 2024 als Publishing plus einfache Reads. Liest man die Dokumentation heute, gehen vier Dinge über diese erste Version hinaus: Antwortmoderation mit Freigaben, Keyword-Suche, Webhooks und Standort-Tagging mit eigenem Scope threads_location_tagging und einer Grenze von 500 Suchen pro Tag.

Für die meisten Projekte sind die Webhooks am wichtigsten. GET /<threads-media-id>/pending_replies im Takt zu pollen verbrennt dein Call-Budget gegen genau diese Impressions-Formel; ein Abo nicht.

Brauchst du eine Threads-Integration, oder eine Schicht darüber

Ehrlich: Wenn Threads das einzige Netzwerk ist, das dich interessiert, bau direkt. Es ist die günstigste Integration in dieser ganzen Kategorie. Kein Review, zwei Endpoints fürs Veröffentlichen, granulare Scopes, ordentliche Docs. Du postest noch am selben Nachmittag.

Für eine Zwischenschicht spricht dasselbe wie überall sonst: Du willst auch Instagram, LinkedIn, X, TikTok und YouTube, und du willst keine sechs Token-Stores, sechs Media-Pipelines und drei App Reviews. PlugKit veröffentlicht auf Threads, mit genau den Grenzen, die Meta setzt: nur Text bis 500 Zeichen, ein Bild oder Video, oder ein Karussell aus 2 bis 20 Elementen. Der Publishing-Guide hat die Details Plattform für Plattform.

Was sich ändert, wenn ein Agent der Aufrufer ist und nicht ein Cronjob, steht im Setup-Guide zum Hermes Agent und im Hub /social-media-api/. PlugKit kostet $49 im Monat für 5 verbundene Accounts, jederzeit kündbar.

FAQ

Hat Threads eine offizielle API?

Ja. Meta hat die Threads API 2024 ausgeliefert, und sie deckt inzwischen Publishing, das Auslesen eigener Posts und des eigenen Profils, Antworten und Moderation, Insights, Webhooks, Keyword-Suche und Standort-Tagging ab. Sie läuft auf graph.threads.com oder graph.threads.net mit OAuth Access Tokens und granularen Scopes.

Wie viele Posts kann ich pro Tag über die Threads API veröffentlichen?

250 veröffentlichte Posts innerhalb eines gleitenden 24-Stunden-Zeitraums, pro Threads-Profil. Antworten bekommen ein eigenes Budget von 1.000 pro 24 Stunden, Löschungen sind bei 100 gedeckelt. Ein Karussell zählt als ein Post, nicht als ein Post pro Bild.

Ist die Threads API kostenlos?

Meta berechnet nichts für Threads-API-Calls. Die Kosten stecken in den Limits: die Obergrenzen für Posts, Antworten und Löschungen von oben, plus ein Call-Budget von 4800 mal deiner Anzahl an Impressions bei mindestens 10 Impressions, ein Profil ohne Publikum bekommt also nur ein kleines Kontingent.

Brauche ich ein App Review, um mit der API auf Threads zu posten?

Für dein eigenes Profil nicht. Zum Veröffentlichen brauchst du die Scopes threads_basic und threads_content_publish, die du dir selbst freigeben kannst. Ein App Review kommt erst ins Spiel, wenn die App für fremde Profile handelt, und das ist dieselbe Regel wie im Rest von Metas Plattform.

Kann ich Threads-Posts mit der API planen?

Auf Metas Seite nicht. Die API veröffentlicht, sobald du threads_publish aufrufst, also hält dein eigener Scheduler die Queue und feuert zur richtigen Minute, oder du nimmst einen Dienst, der das für dich übernimmt. Denk an die empfohlenen 30 Sekunden Wartezeit zwischen dem Erstellen des Containers und dem Veröffentlichen.

AB

Antoine BlancoGründer von PlugKit. Betreibt seine eigenen Instagram-, YouTube- und X-Accounts über die hier beschriebene API und den MCP-Server.