Die ersten Threads-Endpunkte von SocQ lesen öffentliche Profile, einzelne Beiträge und die Beiträge eines Nutzers. Am 2026-11-17 kamen fünf weitere hinzu. Zwei davon dienen der Suche: Beiträge nach Keyword oder Hashtag finden und Konten nach Namen finden. Die anderen drei lesen Unterhaltungen und Verbreitung: die Antworten unter einem Beitrag, die Antworten, die ein Konto an anderer Stelle hinterlässt, und die Beiträge, die es repostet.
Dieser Leitfaden zeigt, was jeder neue Endpunkt zurückgibt, welche Anfrage er erwartet, was er kostet und wann er sich eignet. Einen Vergleich mit Metas eigener Threads API und anderen Anbietern finden Sie unter Threads-API-Alternativen.
Kurze Antwort: Senden Sie eine
queryanPOST /v1/threads/searchoder/search-users, oder Threads-URLs inurlsan/post-replies,/user-repliesoder/user-reposts, jeweils mitAuthorization: Bearer $SOCQ_API_KEY. Fragen SieGET /v1/tasks/{task_id}ab, bisstatusden Wertsucceededhat, und lesen Sie danndata.results.items. Die Preise liegen zwischen 0,3 und 0,6 Credits pro Ergebnis ($0,0015 bis $0,003 bei $0,005 pro Credit), ohne Grundgebühr.
Die fünf neuen Threads-Endpunkte
| Endpunkt | Rückgabe | Eingabe | Preis |
|---|---|---|---|
| Search | Top-Beiträge zu einem Keyword oder Hashtag, etwa 20, mit Text, Autor, Likes, Antworten, Reposts, Medien und Zeit | query | 0,6 Credits ($0,003) pro Beitrag |
| User Search | Konten, die zu einem Namen oder Nutzernamen passen, meist bis zu 10, mit Anzeigename, Avatar und Verifizierung | query | 0,6 Credits ($0,003) pro Konto |
| Post Replies | Antworten unter einem Beitrag, etwa 20 pro Beitrag, mit Autor, Likes, Antworten, Medien und Zeit | Beitrags-URLs | 0,3 Credits ($0,0015) pro Antwort |
| User Replies | Die neuesten öffentlichen Antworten eines Kontos, bis zu etwa 25, mit Interaktionen und Medien | Profil-URLs | 0,5 Credits ($0,0025) pro Antwort |
| User Reposts | Beiträge, die ein Konto kürzlich repostet hat, bis zu etwa 25, jeweils mit ursprünglichem Autor | Profil-URLs | 0,5 Credits ($0,0025) pro Beitrag |
Threads durchsuchen
Threads Search: Beiträge nach Keyword oder Hashtag
Die Threads Search API durchsucht Threads wie die App selbst und liefert die Top-Beiträge zu einem Keyword oder Hashtag. Jeder Beitrag enthält Text, Autor, Likes, Antworten, Reposts, Medien und Veröffentlichungszeit. So sehen Sie am schnellsten, wie über ein Thema, ein Produkt oder ein Ereignis auf Threads gesprochen wird, und finden die Konten, die diese Unterhaltung prägen.
curl -X POST "https://api.socq.ai/v1/threads/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "basketball"
}'
Jede Suche liefert die Top-Beiträge, die Threads für die Suchanfrage anzeigt, etwa 20. Die Interaktionen stehen unter metrics: likes_count, comments_count und shares_count. Siehe die Search-Doku.
Threads User Search: Konten nach Namen
Die Threads User Search API findet Konten nach Namen oder Nutzernamen. Jeder Treffer liefert Nutzernamen, Anzeigenamen, Profil-URL, Avatar und Verifizierungsstatus. Nutzen Sie sie, um das richtige Handle zu bestätigen, bevor Sie Beiträge oder Antworten abrufen, oder um eine Namensliste für die Influencer-Recherche in Threads-Profile zu überführen.
curl -X POST "https://api.socq.ai/v1/threads/search-users" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "shams"
}'
Jede Suche liefert die Konten, die Threads vorschlägt, meist bis zu 10. Siehe die User-Search-Doku.
Unterhaltungen und Reposts lesen
Threads Post Replies: Die Unterhaltung unter einem Beitrag
Die Threads Post Replies API liest die Unterhaltung unter einem Beitrag. Jede Antwort enthält Text, Autor, Like- und Antwortzahlen, angehängte Medien und Zeit sowie die post_id des Beitrags, auf den sie antwortet. Nutzen Sie sie, um die Reaktion auf eine Ankündigung einzuschätzen, Kundenfeedback aus den Beiträgen einer Marke zu sammeln oder die aktivsten Personen im Publikum eines Creators zu finden.
curl -X POST "https://api.socq.ai/v1/threads/post-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://www.threads.com/@unrivaledbasketball/post/Dfa88pLDs_1"]
}'
Verwenden Sie Beitrags-URLs im Format /@{username}/post/{code}. Jeder Beitrag liefert die Antworten, die Threads darunter anzeigt, etwa 20. Siehe die Post-Replies-Doku.
Threads User Replies: Wie ein Konto mit anderen spricht
Die Threads User Replies API liefert die neuesten öffentlichen Antworten eines Kontos mit Text, Likes, Antworten, Medien, Zeit und einem Link zu jeder Antwort. Antworten zeigen Tonfall und Fachwissen direkter als ausgefeilte Beiträge. Das macht sie nützlich, um Creators zu prüfen, einen Sprecher zu beobachten oder zu untersuchen, wie eine Marke Kundengespräche führt.
curl -X POST "https://api.socq.ai/v1/threads/user-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://www.threads.com/@reuters"]
}'
Verwenden Sie Profil-URLs wie https://www.threads.com/@username. Jedes Profil liefert bis zu etwa 25 Antworten. Siehe die User-Replies-Doku.
Threads User Reposts: Wen ein Konto verstärkt
Die Threads User Reposts API liefert die Beiträge, die ein Konto repostet hat. Jede Zeile ist der ursprüngliche Beitrag mit Autor, Text, Interaktionen und Medien. Der Repost-Verlauf ist ein direktes Signal für Nähe: Er zeigt, welchen Stimmen ein Creator vertraut, welche Partner eine Marke bewirbt und welche Inhalte sich in einer Community verbreiten.
curl -X POST "https://api.socq.ai/v1/threads/user-reposts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://www.threads.com/@shams"]
}'
Jedes Profil liefert bis zu etwa 25 aktuelle Reposts; author ist der ursprüngliche Verfasser, nicht das Konto, das repostet hat. Siehe die User-Reposts-Doku.
Ein einfacher Recherche-Workflow
- Führen Sie Search für einen Produktnamen oder Hashtag aus, um die Beiträge zu finden, mit denen Menschen interagieren.
- Übergeben Sie die stärksten Beitrags-URLs an Post Replies, um die Reaktionen zu lesen.
- Lösen Sie mit User Search die auftauchenden Namen in Handles auf und nutzen Sie dann User Replies und User Reposts für diese Profile, um zu sehen, wie sie sprechen und wen sie verstärken.
- Für die eigenen Beiträge oder Profildetails eines Kontos nutzen Sie die bereits vorhandenen Endpunkte User Posts und Profiles.
Authentifizierung und der asynchrone Aufgabenablauf
Jede Anfrage enthält Ihren API-Schlüssel und einen JSON-Content-Type:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Jeder Übermittlungsaufruf startet eine Hintergrundaufgabe:
submit -> task_id -> queued -> running -> succeeded
\-> failed
Die Antwort auf die Übermittlung gibt data.task_id und data.status zurück. Fragen Sie die Aufgabe mit demselben Schlüssel ab:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Solange die Aufgabe queued, running oder failed ist, enthält die Antwort nur Metadaten der Aufgabe; bei failed lesen Sie error_message. Bei succeeded enthält dieselbe Antwort die erste Seite normalisierter Datensätze in data.results.items. limit ist standardmäßig 50 und reicht bis 500. Wenn has_more true ist, übergeben Sie results.next_cursor als cursor, um die nächste Seite zu lesen. fields akzeptiert bis zu 50 kommagetrennte Felder oder Punktpfade.
Eine Zeitüberschreitung beim Client bricht eine Aufgabe nicht ab. Setzen Sie daher mit derselben task_id fort, statt erneut zu übermitteln und für ein Duplikat zu bezahlen. Sie können dem Übermittlungs-Body auch callback_url hinzufügen, um nach Abschluss der Aufgabe einen einzelnen POST mit einer Zusammenfassung zu erhalten.
Was ein typischer Auftrag kostet
- Eine Keyword-Suche mit 20 Beiträgen: 20 × 0,6 = 12 Credits, $0,06.
- Antworten unter 10 Beiträgen mit je etwa 20: 200 × 0,3 = 60 Credits, $0,30.
- Antworten und Reposts für 10 Konten mit je etwa 25: 500 × 0,5 = 250 Credits, $1,25.
FAQ
Kann ich über die ersten 20 Suchergebnisse hinaus blättern?
Search liefert die Top-Beiträge, die Threads für die Suchanfrage anzeigt, etwa 20 pro Suche. Um die Abdeckung zu erweitern, führen Sie verwandte Keywords oder Hashtags als separate Suchen aus.
Brauche ich ein Threads- oder Instagram-Login?
Nein. Eine Anfrage enthält nur Ihren SocQ-API-Schlüssel und eine Suchanfrage oder öffentliche Threads-URLs; Zugangsdaten eines Threads-Kontos sind nicht Teil davon.
Zeigt User Reposts, wer repostet hat?
Sie fragen es für ein Profil ab, also wurde jede Zeile von diesem Profil repostet. Das Feld author jeder Zeile ist der ursprüngliche Verfasser.
Kann ich mehrere Profile oder Beiträge auf einmal senden?
Ja. Post Replies, User Replies und User Reposts nehmen eine Liste in urls entgegen, und die Ergebnismengen gelten pro URL.
Wo sehe ich alle Threads-Endpunkte und Preise?
Auf der Threads-Plattformseite und der Preisseite.
THREADS API
Workflow mit einer öffentlichen Threads-URL testen
Senden Sie öffentliche Eingaben und erhalten Sie normalisierte Datensätze mit nachvollziehbarem Quellkontext.
Threads-APIs ansehen