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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
query | Erforderlich | Stichwortabfrage, um passende öffentliche X-Benutzerprofile zu finden. |
results_limit | Optional | Maximale 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.
- Tragen Sie Ihren Suchbegriff in query ein und setzen Sie results_limit auf ein Vielfaches von 20 (bis zu 2.000).
- Senden Sie mit Ihrem SocQ-API-Schlüssel eine POST-Anfrage an /v1/x/search-users.
- Fragen Sie /v1/tasks/{task_id} ab, bis der Aufgabenstatus succeeded ist.
- 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.
Verwandte APIs
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.
- Twitter Tweet Scraper API
- X Following List API
- X Post Quotes API
- X Post Replies API
- X Post Retweeters API
- Twitter Mentions API
- X Community API
- X Community Posts API
- X Thread Context API
- X Account Location API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API