threads/
search-users

Threads-Konten nach Name oder Benutzername finden und die von Threads vorgeschlagenen Treffer erhalten, meist bis zu 10, mit Benutzername, Anzeigename, Profil-URL, Avatar und Verifizierungsstatus.

Threads User Search API

Name oder Benutzername als Suche
Bis zu etwa 10 Treffer
Verifizierungsstatus
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 User Search

Die Threads-Nutzersuche ist die Liste von Konten, die die App zu einem eingegebenen Namen oder Handle vorschlägt, jeweils erkennbar an Benutzername, Anzeigename, Profillink, Avatar und Verifizierungshäkchen. Mit diesen Merkmalen lässt sich eine echte Person oder Marke von ähnlich benannten Konten unterscheiden und eine reine Namensliste in bestätigte Threads-Profile verwandeln.

Funktionen der Threads User Search API

  • Treffer zu Namen und Handlesquery akzeptiert einen Anzeigenamen oder einen Benutzernamen, und die Antwort enthält die Konten, die Threads dazu vorschlägt, meist bis zu 10.
  • Sofort nutzbare IdentitätsfelderJeder Treffer liefert username, name und url, den Profillink in der Form /@username, den andere Threads-Endpunkte als Eingabe annehmen.
  • Häkchen und Avatar zur Unterscheidungis_verified und avatar_url helfen, das echte Konto auszuwählen, wenn mehrere Treffer denselben Namen tragen.

Parameter der Threads User Search API

ParameterErforderlichBeschreibung
queryErforderlichDer Name einer Person oder Marke oder ein Threads-Benutzername, etwa shams.

So verwenden Sie die Threads User Search API

Suchen Sie nach einem Namen und lesen Sie die vorgeschlagenen Konten.

  1. Senden Sie {"query": "shams"} per POST an /v1/threads/search-users.
  2. Fragen Sie GET /v1/tasks/{task_id} mit der zurückgegebenen task_id ab, bis status den Wert succeeded hat.
  3. Lesen Sie die passenden Konten aus results.items und folgen Sie results.next_cursor, sobald has_more true ist.
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"}'

# 0.6 credits for each account returned.

Anwendungsfälle der Threads User Search API

  • Ein Handle vor dem Sammeln von Inhalten bestätigen: Prüfen Sie username, Anzeigename und is_verified, um den richtigen Treffer zu finden, und rufen Sie dann mit seiner url die Beiträge, Antworten oder Reposts dieses Kontos ab.
  • Eine Namensliste in Threads-Profile verwandeln: Suchen Sie jeden Namen einer Influencer- oder Presseliste und behalten Sie die url des verifizierten Treffers, um eine Spalte mit Threads-Profillinks aufzubauen.
  • Nachahmerkonten erkennen: Suchen Sie nach einer Marke oder einer öffentlichen Person und prüfen Sie die nicht verifizierten Treffer mit fast identischen Namen und Avataren auf mögliche Nachahmer oder Fanseiten.

Profi-Tipps zur Threads User Search API

  • Probieren Sie sowohl den vollen Namen als auch ein naheliegendes Handle, wenn das gesuchte Konto in den ersten Treffern fehlt, da query auf beides passt.
  • Wählen Sie einen Treffer anhand von username und is_verified, statt einfach die erste Zeile zu nehmen, denn gängige Namen liefern mehrere ähnliche Konten.
  • Geben Sie die gewählte url direkt an die Threads User Posts, User Replies oder User Reposts API weiter, die alle Profillinks in genau dieser Form annehmen.

Ergänzend zur Threads User 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 Search API — Threads per Keyword oder Hashtag nach den Top-Beiträgen durchsuchen – mit Text, Autoren, Likes, Antworten, Reposts, Medien und Veröffentlichungszeit.
  • 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 User Search API — FAQ

Threads User Search API ist eine Programmierschnittstelle, die Threads-Konten anhand eines Namens oder Benutzernamens findet. Sie liefert die von Threads vorgeschlagenen Konten, jeweils mit Benutzername, Anzeigename, Profillink, Avatar und Verifizierungsstatus.

Meist bis zu 10, dieselben Vorschläge, die Threads für den eingegebenen Namen oder Benutzernamen anbietet.

Suchergebnisse dienen dazu, Konten zu identifizieren. Senden Sie die url jedes Treffers an die Threads Profiles API, um Bio, Website und sichtbare Followerzahlen zu erfassen.

Jedes gelieferte Konto kostet 0,6 Credits, eine Suche mit 10 Treffern kostet also 6 Credits.