Threads Search
Die Threads-Suche zeigt die Beiträge, die die App für ein Keyword oder Hashtag am höchsten einstuft, und jeder davon bringt Text, Autor, Veröffentlichungszeit, angehängte Bilder oder Videos sowie die Zahl der Likes, Antworten und Reposts mit. So lässt sich schnell ablesen, wie gerade über ein Thema, ein Produkt oder ein Ereignis gesprochen wird und welche Konten die Unterhaltung prägen.
Funktionen der Threads Search API
- Eine Suche, die Top-BeiträgeTragen Sie ein Keyword oder Hashtag in query ein und erhalten Sie die Top-Beiträge, die Threads dafür anzeigt, rund 20, im Ranking der App.
- Likes, Antworten und Reposts bei jedem Treffermetrics.likes_count, metrics.comments_count für Antworten und metrics.shares_count für Reposts zeigen, welche Treffer die meiste Aufmerksamkeit bekommen.
- Die Konten hinter jedem Beitragauthor liefert Benutzername, Anzeigename, Profil-url, Avatar und is_verified, sodass die Personen, die ein Thema prägen, zusammen mit ihren Aussagen erkennbar sind.
- Medien und Zeitpunktmedia listet angehängte Bilder oder Videos mit ihren Maßen auf, und published_at datiert jeden Beitrag für Aktualitätsprüfungen.
Parameter der Threads Search API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
query | Erforderlich | Das zu suchende Keyword oder Hashtag, etwa basketball oder ein Kampagnen-Hashtag. Eine Suche pro Anfrage. |
So verwenden Sie die Threads Search API
Senden Sie eine Suchanfrage und lesen Sie die Top-Beiträge, sobald die Aufgabe abgeschlossen ist.
- Senden Sie {"query": "basketball"} per POST an /v1/threads/search und bewahren Sie die zurückgegebene task_id auf.
- Fragen Sie GET /v1/tasks/{task_id} ab, bis succeeded gemeldet wird.
- Lesen Sie die Beiträge in results.items; wenn has_more true ist, fordern Sie den Rest mit results.next_cursor an.
curl -X POST "https://api.socq.ai/v1/threads/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"basketball"}'
# 0.6 credits per post returned; a search with no matches is free.Anwendungsfälle der Threads Search API
- Die Stimmung zu einem Thema erfassen: Suchen Sie nach einem Produkt, Ereignis oder Thema und lesen Sie den text der Top-Beiträge, um zu sehen, welche Blickwinkel und Meinungen die Diskussion anführen.
- Stimmen erkennen, die eine Unterhaltung lenken: Ordnen Sie die Autoren der Treffer nach den Likes und Reposts ihrer Beiträge und notieren Sie, wer verifiziert ist, um eine Kontakt- oder Beobachtungsliste aufzubauen.
- Einen Markennamen oder Hashtag beobachten: Führen Sie dieselbe Suche regelmäßig aus und behalten Sie neue Beitrags-ids mit ihrem published_at, so entsteht ein laufendes Protokoll frischer Erwähnungen.
Profi-Tipps zur Threads Search API
- Teilen Sie ein breites Thema in mehrere engere Suchen auf, etwa Produktnamen, Schreibvarianten und verwandte Hashtags, da jede Suche rund 20 Top-Beiträge liefert.
- Führen Sie Ergebnisse überlappender Suchen über id zusammen, damit ein Beitrag, der bei zwei Suchen erscheint, nur einmal gezählt wird.
- Lesen Sie metrics.comments_count als Zahl der Antworten und metrics.shares_count als Zahl der Reposts, wenn Sie Spalten in Berichten beschriften.
- Übergeben Sie die url eines Treffers an die Threads Post Replies API, wenn Sie die Unterhaltung darunter brauchen.
Verwandte APIs
Ergänzend zur Threads Search API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Threads-Daten benötigen.
- Threads Posts API — Öffentliche Beitragstexte, Autorenkontext, Medien, Zeitstempel und sichtbare Interaktionen aus unterstützten Threads-Beitrags-URLs erfassen.
- Threads Profiles API — Öffentliche Profilidentität, Bios, Bilder, Websites, sichtbare Kontozahlen und Erfassungskontext aus unterstützten Threads-Profil-URLs erfassen.
- Threads User Posts API — Öffentliche Beiträge aus Threads-Profil-URLs ermitteln – mit Limit pro Profil, normalisierten Inhalten, Autoren, Medien, Zeitstempeln, sichtbaren Interaktionen und Quellkontext.
- Threads Post Replies API — Die Antworten unter Threads-Beiträgen über Beitrags-URLs erfassen – mit Antworttext, Autoren, Likes und Antwortzahl, Medien und der ID des beantworteten Beitrags.
- Threads User Search API — Threads-Konten nach Name oder Benutzername finden – mit Benutzernamen, Anzeigenamen, Profil-URLs, Avataren und Verifizierungsstatus.
- Threads User Replies API — Die neuesten öffentlichen Antworten eines Kontos über Threads-Profil-URLs erfassen – mit Antworttext, Interaktionen, Medien und Links.