X Followers List
Eine X-Follower-Liste ist die Menge öffentlicher Kontodatensätze, die zum Zeitpunkt der Erfassung für die Personen zurückgegeben wird, die einem übergebenen Benutzernamen folgen. Sie unterstützt Zielgruppenanalysen und die Anreicherung von Listen, unterliegt dabei aber der öffentlichen Verfügbarkeit, der Paginierung des Anbieters und der Deduplizierung innerhalb der Aufgabe.
Funktionen der X Followers List API
- Follower-Erfassung für mehrere KontenÜbergeben Sie in einer einzigen Aufgabe einen oder mehrere öffentliche X-Benutzernamen, mit oder ohne führendes @.
- Ergebnissteuerung pro BenutzernameFordern Sie pro Benutzername 200 bis 2.000 Follower-Datensätze in Schritten von 200 an; standardmäßig gelten 200.
- Normalisierte öffentliche KontodatensätzeSie erhalten Konto-IDs, kanonische Profil-URLs, Autorenidentität, sichtbare Profilzähler und normalisierte Zeitstempel über das öffentliche Aufgabenergebnis.
- Optionen für die asynchrone BereitstellungFragen Sie die Aufgabenergebnisse mit einem undurchsichtigen Cursor ab, bis die Erfassung abgeschlossen ist, und lesen Sie danach alle verfügbaren Ergebnisseiten nacheinander aus.
Parameter der X Followers List API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
usernames | Erforderlich | Erforderliche Liste öffentlicher X-Benutzernamen. Die Werte dürfen ein führendes @ enthalten oder weglassen; Leerzeichen werden entfernt, und doppelte Benutzernamen werden vor der Erfassung ohne Beachtung der Groß- und Kleinschreibung entfernt. |
results_limit | Optional | Maximale Anzahl der Ergebnisse, die pro Benutzername erfasst werden. Standard ist 200; zulässig sind Vielfache von 200 von 200 bis 2.000. |
So verwenden Sie die X Followers List API
Starten Sie eine Follower-Erfassung, warten Sie auf den Abschluss und lesen Sie die gespeicherten öffentlichen Kontodatensätze seitenweise aus.
- Bereiten Sie einen oder mehrere öffentliche X-Benutzernamen vor; ein führendes @ ist optional.
- Senden Sie usernames und ein gültiges results_limit per POST an /v1/x/followers-list und behalten Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe succeeded oder failed erreicht.
- Lesen Sie nach einem Erfolg data.results.items und geben Sie next_cursor an den Aufgaben-Endpunkt zurück, solange has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/x/followers-list" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["@X"],"results_limit":200}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueAnwendungsfälle der X Followers List API
- Stichproben für Zielgruppenanalysen aufbauen: Erfassen Sie öffentliche Follower-Konten ausgewählter X-Profile und analysieren Sie die sichtbare Größenordnung der Konten in der zurückgegebenen Stichprobe.
- Verzeichnisse bekannter Konten anreichern: Ergänzen Sie nachgelagerte Kontodatensätze um kanonische X-Profil-URLs, Anzeigeidentitäten, Konto-IDs und sichtbare Zähler.
- Wiederholbare Follower-Momentaufnahmen erstellen: Führen Sie dieselbe begrenzte Erfassung im Zeitverlauf aus und behalten Sie die Zeitstempel der Aufgaben, um gespeicherte Mengen öffentlicher Konten zu vergleichen.
Profi-Tipps zur X Followers List API
- Entfernen Sie Duplikate bei den Benutzernamen vor dem Senden, denn die vorläufige Credit-Schätzung nutzt die Länge des übergebenen Arrays, während die Erfassung doppelte Handles normalisiert.
- Verstehen Sie results_limit als Obergrenze pro Benutzername und nicht als Zusage, dass jedes Konto die angeforderte Zahl öffentlicher Datensätze liefert.
- Verwenden Sie die id jedes Ergebnisses als stabilen Schlüssel; derselbe Follower, der unter mehreren übergebenen Benutzernamen auftaucht, wird innerhalb einer Aufgabe nur einmal gespeichert.
- Trennen Sie die Paginierung des Anbieters vom Abruf der Ergebnisse: Öffentlich ist nur der undurchsichtige next_cursor von /v1/tasks/{task_id}.
- Behandeln Sie leere und unvollständige Ergebnisse, ohne den Workflow scheitern zu lassen, denn nicht verfügbare Konten, Zugriffsbeschränkungen oder eine erschöpfte Quelle können eine Erfassung verkürzen.
Verwandte APIs
Ergänzend zur X Followers List 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.
- X Following List API — Profile erfassen, denen öffentliche X-Konten folgen – mit Identität, Bios, Kontosignalen, sichtbaren Zählern und Quell-Benutzernamen.
- X Post Retweeters API — Eine auf Aufgabenebene eindeutige Menge normalisierter öffentlicher Profile von Konten erfassen, die bekannte X- oder Twitter-Status-URLs repostet haben.
- X Community API — Aus Community-Links Beschreibung, Mitgliederzahlen, Regeln und Beitrittsregeln auslesen.
- X Verified Followers API — Die verifizierten Konten erfassen, die einem Profil folgen – mit Benutzername, Anzeigename, Profilbild und Beitrittsdatum.
- Twitter Follow Checker API — Prüfen, ob ein Konto anderen folgt und ob diese zurückfolgen.
- Twitter Tweet Scraper API
- Twitter User Tweets Scraper API
- Twitter Search API
- X Post Quotes API
- X Post Replies API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community Posts API
- X Thread Context API
- X Account Location API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Video Transcript API