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 lesen, und für dein eigenes Profil gibt es kein App Review zu bestehen. Die Obergrenze liegt bei 250 veröffentlichten Posts und 1.000 Antworten pro 24 Stunden. Alles Folgende stammt aus Metas Threads-Dokumentation, gelesen am 10. September 2026.
Was die Threads API heute kann
Laut dem Threads API-Überblick 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 listet außerdem Profile, Mentions, Insights, Webhooks, Keyword-Suche und Standort-Tagging.
Die Calls gehen an graph.threads.com oder graph.threads.net, mit einem Access Token. Die Scopes sind granular, frag also nur nach dem, was du auch nutzt:
| Operation | Erforderliche Scopes |
|---|---|
| Ein Profil und seine Posts lesen | threads_basic |
| Einen Post oder eine Antwort veröffentlichen | threads_basic, threads_content_publish |
| Antworten ausblenden, freigeben oder moderieren | threads_basic, threads_content_publish, threads_manage_replies |
| Einen Post löschen | threads_basic, threads_delete |
| Insights lesen | threads_basic, threads_manage_insights |
| Standorte taggen und suchen | threads_basic, threads_location_tagging |
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
Gleiche Form wie bei Instagram. Erstelle einen Media-Container, dann veröffentliche ihn, wie im Posts-Guide.
# 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 nimmt TEXT, IMAGE oder VIDEO, mit image_url oder video_url für Medien. Textbeiträge sind auf 500 Zeichen begrenzt, und Emojis zählen mit der Anzahl ihrer UTF-8-Bytes, sodass bei einem Beitrag mit vielen Emojis der Platz früher ausgeht, als es 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 ist derselbe Ablauf mit einer zusätzlichen Ebene: Erstelle jeden Child-Container mit is_carousel_item=true, erstelle einen Parent-Container vom Typ CAROUSEL mit der Auflistung der Children, dann veröffentliche den Parent. Minimum zwei Children, Maximum 20, Bilder und Videos können gemischt werden. Ein Carousel zählt gegen dein Rate Limit als ein einzelner Beitrag.
Antworten nutzen dieselben Publish-Endpoints mit einem reply_to_id, und sie haben ihr eigenes Budget, getrennt von Posts.
Bei der Moderation ist die Threads API der von Instagram wirklich voraus. Aus der Doku zur Antwortverwaltung:
reply_controlwird beim Erstellen des Beitrags gesetzt und nimmteveryone,accounts_you_follow,mentioned_only,parent_post_author_onlyoderfollowers_only.enable_reply_approvals=trueam Container hält Antworten zur Genehmigung zurück, statt sie zu veröffentlichen.POST /<THREADS_REPLY_ID>/manage_replyblendet eine Top-Level-Antwort samt allem, was darunter hängt, aus oder wieder ein.POST /<THREADS_REPLY_ID>/manage_pending_replygenehmigt oder lehnt eine Antwort ab, die in der Warteschlange liegt, undGET /<threads-media-id>/pending_replieslistet 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:
| Operation | Limit pro 24 Stunden |
|---|---|
| Veröffentlichte Posts | 250 |
| Antworten | 1,000 |
| Löschungen | 100 |
| Standortsuchen | 500 |
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 verwendet 4800 Calls mal die Anzahl der engaged users. Threads ist für Publishing-Volumen das großzügigste der drei. Die vollständige plattformübergreifende Tabelle findest du in unserer Referenz zu Rate Limits von Social-Media-APIs, und das größere Bild findest du im Social-Media-API-Guide 2026.
Insights: was du tatsächlich messen kannst
Zwei Endpoints, beide brauchen threads_manage_insights, laut Insights-Doku.
Pro Post, GET /<threads-media-id>/insights liefert views, likes, replies, reposts, quotes und shares.
Pro Account, GET /<threads-user-id>/threads_insights liefert views als Zeitreihe, dann likes, replies, reposts, quotes, clicks, followers_count und follower_demographics als Gesamtwerte. Beachte: Die Metrik replies zählt auf Account-Ebene nur Top-Level-Antworten und liegt damit niedriger als die Summe der Antwortzahlen deiner einzelnen Beiträge.
Eine harte Grenze: 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 begrenzen.
Neues zur Threads API: was im September 2026 in den Docs steht
Die Threads API kam 2024 als Publishing plus einfaches Lesen. Wer die Doku heute liest, findet vier Dinge, die über diese erste Version hinausgehen: Antwort-Moderation mit ausstehenden Freigaben, Keyword-Suche, Webhooks und Standort-Tagging mit eigenem Scope threads_location_tagging und ein Limit von 500 Suchen pro Tag.
Für die meisten Projekte sind die Webhooks am wichtigsten. Polling GET /<threads-media-id>/pending_replies nach Zeitplan frisst dein Call-Budget gegen diese Impressions-Formel, ein Abo dagegen 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.
Das Argument für eine Zwischenschicht ist dasselbe wie überall: Du willst außerdem Instagram, LinkedIn, X, TikTok und YouTube, und du willst nicht sechs Token-Stores, sechs Media-Pipelines und drei App Reviews. PlugKit veröffentlicht auf Threads, mit denselben Einschränkungen, die Meta setzt: nur Text bis 500 Zeichen, ein Bild oder Video, oder ein Karussell aus 2 bis 20. Der Publishing-Guide hat die Details Plattform für Plattform.
Was eine Zwischenschicht ändert, wenn ein Agent der Aufrufer ist und nicht ein Cronjob, findest du unter dem Hermes-Agent-Setup-Guide und den /social-media-api/ Hub. PlugKit kostet 29 $ pro 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 Lesen eigener Beiträge und des eigenen Profils, Antworten und Moderation, Insights, Webhooks, Keyword-Suche und Standort-Tagging ab. Sie läuft über 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?
Nicht für dein eigenes Profil. Zum Veröffentlichen brauchst du die Scopes threads_basic und threads_content_publish, die du dir selbst autorisieren kannst. App Review kommt ins Spiel, wenn deine App im Namen fremder Profile handelt, und das ist dieselbe Regel wie im Rest von Metas Plattform.
Kann ich Threads-Posts mit der API planen?
Nicht auf Metas Seite. Die API veröffentlicht, wenn du threads_publish aufrufst, dein eigener Scheduler hält also 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.
Ein Plug für jede Plattform, die dein Agent anfasst
29 $ im Monat für 5 verbundene Accounts, jederzeit kündbar. Jede Funktion in jedem Tarif.
Hol dir deinen API-Key →