x/
search-users

Öffentliche X-Benutzerkonten per Stichwort durchsuchen – mit normalisierter Identität, Bio, Verifizierungsstatus und Zielgruppenkennzahlen.

Twitter User Search API

Benutzersuche
Konten entdecken
Normalisierte Profile
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

Twitter User Search

Wer auf X passende Creator-, Unternehmens- und Expertenprofile entdecken will, braucht ein gezieltes Abgleichen von Stichwörtern mit Konto-Handles und Bios. Normalisierte Profilergebnisse liefern Benutzernamen, Anzeigenamen, Bios, Standortkontext, Follower-Zahlen und Verifizierungsabzeichen.

Funktionen der Twitter User Search API

  • Konten per Stichwort findenSenden Sie einen beliebigen Suchbegriff, um passende öffentliche Profile in Namen, Benutzernamen und Konto-Bios zu entdecken.
  • Normalisierte ProfilattributeSie erhalten einheitliche Objekte mit Benutzer-ID, Handle, Anzeigename, Avatar, Banner und Biografietext.
  • ZielgruppenkennzahlenErfassen Sie für jedes zurückgegebene Konto die aktuellen Zahlen zu Followern, Gefolgten, Posts insgesamt, Medien und Favoriten.
  • Verifizierung und StatusmerkmaleErkennen Sie blaue Verifizierungsabzeichen, Kennzeichen für automatisierte Bot-Konten, den Status geschützter Konten und Standortangaben.

Parameter der Twitter User Search API

ParameterErforderlichBeschreibung
queryErforderlichStichwortabfrage, um passende öffentliche X-Benutzerprofile zu finden.
results_limitOptionalMaximale Anzahl der zurückgegebenen Benutzerprofile; muss ein Vielfaches von 20 zwischen 20 und 2.000 sein, Standard ist 20.

So verwenden Sie die Twitter User Search API

Senden Sie eine Stichwortsuche als asynchrone Aufgabe und blättern Sie anschließend durch die normalisierten Benutzerprofile.

  1. Tragen Sie Ihren Suchbegriff in query ein und setzen Sie results_limit auf ein Vielfaches von 20 (bis zu 2.000).
  2. Senden Sie mit Ihrem SocQ-API-Schlüssel eine POST-Anfrage an /v1/x/search-users.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis der Aufgabenstatus succeeded ist.
  4. Rufen Sie die normalisierten Kontodatensätze aus data.results.items ab.
curl -X POST "https://api.socq.ai/v1/x/search-users" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"OpenAI","results_limit":20}'

# Poll GET /v1/tasks/{task_id}, then fetch data.results.items.

Anwendungsfälle der Twitter User Search API

  • Influencer und Fachexperten finden: Finden Sie einflussreiche Fachexperten, Journalisten und Vordenker, indem Sie nach Fachbegriffen der Branche suchen.
  • Prüfung von Markenkonten: Entdecken Sie Marken-Handles, lokalisierte regionale Tochtergesellschaften oder inoffizielle Fan-Konten auf der gesamten Plattform.
  • Erstellung von Listen für die Kontaktaufnahme: Bauen Sie Listen potenzieller Kontakte aus relevanten Fachleuten auf, gefiltert nach Stichwörtern in ihrer öffentlichen Bio.

Profi-Tipps zur Twitter User Search API

  • Nutzen Sie diesen Endpunkt, um Konten zu entdecken; verwenden Sie X Search, wenn Sie einzelne Posts finden möchten.
  • results_limit muss ein Vielfaches von 20 sein (zum Beispiel 20, 40, 100), damit es zu den Paginierungsstapeln der vorgelagerten Quelle passt.
  • Prüfen Sie die Eigenschaften is_verified und verified_type, um festzustellen, ob ein Konto offiziell authentifiziert ist.
  • Übergeben Sie gefundene Benutzernamen an X User Posts oder X Following List, um deren Zielgruppengraphen weiter zu erkunden.

Ergänzend zur Twitter User Search API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher X-Daten benötigen.

  • Twitter Profile Scraper API — Öffentliche Kontoidentität, Bios, Avatare, Titelbilder, Kontostatus und sichtbare Statistiken zur Zielgruppe per Benutzername abrufen.
  • Twitter User Tweets Scraper API — Aktuelle öffentliche Posts, Autoren, Medien, Hashtags, Erwähnungen und Interaktionen per Benutzername erfassen – ohne Antworten.
  • Twitter Search API — Öffentliche Posts per Suchausdruck finden – mit Sortierung nach neuesten oder beliebtesten Posts und konfigurierbarem Ergebnislimit.
  • X Followers List API — Identitäten öffentlicher Follower-Konten und sichtbare Profilkennzahlen zu einem oder mehreren X-Benutzernamen erfassen.
  • X Trends API — Aktuelle öffentliche X-Trend-Momentaufnahmen für bekannte numerische WOEIDs erfassen – mit Quellrang, Suchbegriff, Beschreibung und Ortskontext.
  • X Communities Search API — Communities per Stichwort finden – mit Mitgliederzahl und einem Link für die Mitglieder- und Post-Endpunkte.

Weitere Plattformen entdecken

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

Twitter User Search API — FAQ

Twitter User Search API durchsucht öffentliche Benutzerkonten und Creator-Profile auf X anhand von Textabfragen. Sie liefert normalisierte Profildatensätze mit Follower-Zahlen, Bios, Verifizierungsabzeichen und Avatar-URLs.

Der Endpunkt X Search sucht öffentliche Posts, die zu Stichwörtern passen, während Twitter User Search gezielt nach Benutzerkonten und Kanalprofilen sucht.

Der vorgelagerte Anbieter liefert die Ergebnisse der Benutzersuche in festen Seiten mit je 20 Einträgen, daher muss das angeforderte Limit ein glattes Vielfaches von 20 sein.