x/
list-followers

Sehen, wer öffentliche X-Listen abonniert hat: Listen-URL senden und zu jedem Follower Bio, Standort, Verifizierungs-Flag, Beitrittsdatum sowie die Zahl der Follower, gefolgten Konten und Posts erhalten.

Twitter List Followers API

Listen-URL als Eingabe
Abonnenten der Liste
Bis zu 2.000 pro Liste
0,7 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 List Followers

Die Follower einer X-Liste, früher Twitter-Liste, sind die Konten, die eine Liste abonniert haben, um die Tweets ihrer Mitglieder zu lesen, und jedes davon hat ein öffentliches Profil mit Bio, Standort, Verifizierung, Beitrittsdatum und der Zahl der Follower, gefolgten Konten und Posts. Wer einer Liste folgt, entscheidet sich bewusst dafür, bei ihrem Thema auf dem Laufenden zu bleiben, deshalb zeigen diese Profile, wen eine Nische anzieht, ermöglichen den Vergleich der Leser verwandter Listen und verweisen auf Personen, deren Ansprache zu diesem Thema sich lohnt.

Funktionen der Twitter List Followers API

  • Abonnenten jeder öffentlichen ListeSenden Sie Links der Form x.com/i/lists/<id> und erhalten Sie die Konten, die sich entschieden haben, der Timeline jeder Liste zu folgen, bis zu 2.000 pro Liste.
  • Wer jeder Follower istJede Zeile enthält username, Anzeigename, die Bio in text, Avatar, Titelbild, website und location.name, die zusammen zeigen, welche Art von Menschen eine Liste anzieht.
  • Reichweite, Aktivität, Kontoalter und Verifizierungmetrics.followers_count, following_count und posts_count, published_at als Beitrittsdatum und is_verified helfen, etablierte, aktive Follower von neuen oder wenig aktiven Konten zu unterscheiden.

Parameter der Twitter List Followers API

ParameterErforderlichBeschreibung
urlsErforderlichEine oder mehrere öffentliche X-Listen-URLs, jeweils in der Form https://x.com/i/lists/<numeric id>. Für jede angegebene Liste werden die Follower erfasst.
results_limitOptionalZu erfassende Follower pro Liste: ein Vielfaches von 20 zwischen 20 und 2.000, Standard ist 100.

So verwenden Sie die Twitter List Followers API

Starten Sie eine Aufgabe mit einer oder mehreren Listen-URLs und blättern Sie dann durch die Konten, die jeder Liste folgen.

  1. Senden Sie {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100} per POST an /v1/x/list-followers und behalten Sie die task_id.
  2. Rufen Sie GET /v1/tasks/{task_id} in Abständen auf, bis status zu succeeded wechselt.
  3. Sammeln Sie die Follower aus results.items und übergeben Sie beim nächsten Aufruf results.next_cursor, solange has_more true ist.
curl -X POST "https://api.socq.ai/v1/x/list-followers" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/i/lists/1940592907737845989"],"results_limit":100}'

# Every item is an account that follows the list; the list's members come from /v1/x/list-members.

Anwendungsfälle der Twitter List Followers API

  • Sehen, wer Ihrer eigenen Liste folgt: Erfassen Sie die Follower einer öffentlichen Liste, die Sie pflegen, um zu erfahren, wer sie liest und welche Leser laut followers_count das größte Publikum haben.
  • Das Publikum eines Themas beschreiben: Lesen Sie die Bios und location.name der Personen, die einer Liste zu Climate Tech oder SaaS-Gründern folgen, um zu beschreiben, wer sich für dieses Thema interessiert.
  • Kontakte für die Ansprache vorauswählen: Filtern Sie Follower nach Stichwörtern in text und nach followers_count, um Konten auszuwählen, die bereits über Ihr Fachgebiet lesen.
  • Die Leser konkurrierender Listen vergleichen: Erfassen Sie in einer Aufgabe die Follower zweier Listen zum selben Thema und gleichen Sie sie über id ab, um gemeinsame Leser und die Leser zu finden, die jeweils nur einer Liste folgen.
  • Startdaten für eine Lookalike-Zielgruppe liefern: Exportieren Sie Benutzernamen und id-Werte der Follower einer gut ausgewählten Liste als Ausgangsdaten für Lookalike- oder Interessen-Targeting in Ihren Werbetools.

Profi-Tipps zur Twitter List Followers API

  • Gleichen Sie die Follower über id mit den Mitgliedern der Liste aus der Twitter List Members API ab, um Mitglieder zu finden, die der Liste auch folgen, und Leser außerhalb des Mitgliederkreises.
  • Verwenden Sie für jede Liste, die Sie vergleichen, dasselbe results_limit, damit jedes Publikum bis zur gleichen Tiefe erfasst wird.
  • Speichern Sie die id-Werte der Follower aus jedem Durchlauf; ein späterer Export derselben Liste zeigt dann, wer ihr zwischenzeitlich zu folgen begonnen hat.

Ergänzend zur Twitter List Followers 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 Followers List API — Identitäten öffentlicher Follower-Konten und sichtbare Profilkennzahlen zu einem oder mehreren X-Benutzernamen erfassen.
  • 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 List Tweets API — Die Timeline einer Liste abrufen, neueste Posts zuerst, mit gekennzeichneten Reposts und ihren Originalautoren.
  • Twitter List Members API — Die Konten einer Liste als vollständige Profile mit Bio, Standort und Kennzahlen exportieren.

Weitere Plattformen entdecken

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

Twitter List Followers API — FAQ

Twitter List Followers API ist eine Programmierschnittstelle, die die Konten erfasst, die öffentlichen X-Listen folgen beziehungsweise sie abonniert haben, und zwar über die Listen-URL mit /i/lists/. Sie liefert zu jedem Follower Benutzername, Name, Bio, Standort, Website, Verifizierungs- und Privat-Flag, Beitrittsdatum sowie die Zahl der Follower, gefolgten Konten und Posts.

Ja, bei öffentlichen Listen. Senden Sie die Listen-URL, und jeder Abonnent kommt als Profilzeile zurück, bis zu 2.000 pro Liste.

Follower haben eine Liste abonniert, um ihre Timeline zu lesen; Mitglieder sind die Konten, die der Eigentümer der Liste hinzugefügt hat. Diese API liefert Follower, die Twitter List Members API liefert Mitglieder.

Nein. Sie liefert die Abonnenten einer Liste. Für die Konten, die einem Nutzerprofil folgen, verwenden Sie die X Followers List API.

Kleine Listen haben oft nur wenige Abonnenten, und das Ergebnis enthält genau die Konten, die der Liste folgen. Jeder zurückgegebene Follower kostet 0,7 Credits, ein leeres Ergebnis kostet nichts.