threads/
search

Threads per Keyword oder Hashtag nach den Top-Beiträgen durchsuchen, die die App anzeigt, rund 20 pro Suche, jeweils mit Text, Autor, Likes, Antworten, Reposts, Medien und Zeitpunkt.

Threads Search API

Keyword oder Hashtag als Suche
Top-Beiträge im Threads-Ranking
Likes, Antworten und Reposts
0,6 Credits pro Ergebnis
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

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

ParameterErforderlichBeschreibung
queryErforderlichDas 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.

  1. Senden Sie {"query": "basketball"} per POST an /v1/threads/search und bewahren Sie die zurückgegebene task_id auf.
  2. Fragen Sie GET /v1/tasks/{task_id} ab, bis succeeded gemeldet wird.
  3. 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.

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.

Weitere Plattformen entdecken

Kombinieren Sie Threads-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

Threads Search API — FAQ

Threads Search API ist eine Programmierschnittstelle, mit der sich öffentliche Threads-Beiträge per Keyword oder Hashtag durchsuchen lassen. Sie liefert die Top-Beiträge zur Suche mit Text, Autor, Likes, Antworten, Reposts, Medien und Zeitpunkt.

Tragen Sie das Hashtag genauso wie ein Keyword in query ein, und die Beiträge, die Threads für dieses Tag einstuft, kommen zurück.

Rund 20, in der Reihenfolge, in der Threads seine Top-Ergebnisse für die Suche einstuft. Sortieren Sie selbst nach published_at, wenn Sie die neuesten zuerst brauchen.

Jeder gelieferte Beitrag kostet 0,6 Credits, eine volle Suche mit rund 20 Beiträgen kommt also auf etwa 12 Credits.