x/
followers-list

Öffentliche Follower-Konten zu einem oder mehreren X-Benutzernamen erfassen – mit normalisierten Identitäten, sichtbaren Profilkennzahlen, asynchronen Aufgaben und Abruf per Cursor.

X Followers List API

Follower-Konten
Profilkennzahlen
Batch-Erfassung
0,5 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

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

ParameterErforderlichBeschreibung
usernamesErforderlichErforderliche 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_limitOptionalMaximale 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.

  1. Bereiten Sie einen oder mehrere öffentliche X-Benutzernamen vor; ein führendes @ ist optional.
  2. Senden Sie usernames und ein gültiges results_limit per POST an /v1/x/followers-list und behalten Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe succeeded oder failed erreicht.
  4. 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 true

Anwendungsfä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.

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.

Weitere Plattformen entdecken

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

X Followers List API — FAQ

X Followers List API ist eine Schnittstelle zum Erfassen öffentlicher Kontodatensätze von Personen, die einem oder mehreren übergebenen X-Benutzernamen folgen.

Übergeben Sie ein nicht leeres Array usernames. Jeder Wert darf ein führendes @ enthalten oder weglassen; umgebende Leerzeichen werden entfernt, und doppelte Handles werden vor der Erfassung beim Anbieter ohne Beachtung der Groß- und Kleinschreibung entfernt.

Der Wert gilt getrennt für jeden Benutzernamen, ist standardmäßig 200 und muss ein Vielfaches von 200 zwischen 200 und 2.000 sein. Er ist eine Obergrenze, sodass öffentliche Verfügbarkeit und Paginierung zu weniger Ergebnissen führen können.

Der aktuelle Serialisierer der Aufgabe liefert die Konto-ID, die kanonische Profil-URL, die Autoren-ID, Benutzername und Name, sichtbare Profilkennzahlen, den normalisierten Zeitpunkt der Kontoerstellung (sofern verfügbar) und den Erstellungszeitpunkt des gespeicherten Datensatzes.

Wiederholte Zeilen des Anbieters werden anhand der Konto-ID dedupliziert, und dasselbe Konto wird in der gesamten Aufgabe nur einmal gespeichert, selbst wenn es mehr als einem übergebenen Benutzernamen folgt.

Jedes eindeutig gespeicherte Ergebnis kostet 0,5 SocQ-Credits. Die Aufgabe wird vorab mit results_limit multipliziert mit der Anzahl der übergebenen Benutzernamen belastet, nicht genutzte Credits werden nach erfolgreicher Abrechnung erstattet; ein leeres Ergebnis kostet null Credits.