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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
query | Erforderlich | Der 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.
- Senden Sie {"query": "shams"} per POST an /v1/threads/search-users.
- Fragen Sie GET /v1/tasks/{task_id} mit der zurückgegebenen task_id ab, bis status den Wert succeeded hat.
- 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.
Verwandte APIs
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.