Twitter List Members
Die Mitglieder einer Twitter-Liste sind die Konten, die der Eigentümer der X-Liste von Hand ausgewählt und hinzugefügt hat, und jedes davon hat ein öffentliches Profil mit Name, Bio, Standort, Website, Verifizierung, Beitrittsdatum und der Zahl der Follower, gefolgten Konten und Posts. Weil jemand aus dem Fachgebiet die Auswahl bereits getroffen hat, ergeben diese Profile eine fertige Shortlist für Akquise, Influencer-Recherche und Kontoanreicherung, und wiederholte Momentaufnahmen halten fest, wie sich eine kuratierte Gruppe verändert.
Funktionen der Twitter List Members API
- Vom Eigentümer ausgewählte Konten aus einer Listen-URLJede übermittelte URL der Form x.com/i/lists/<id> liefert die Konten, die der Eigentümer auf die Liste gesetzt hat, bis zu 2.000 pro Liste – so wird aus einer handverlesenen Gruppe eine Tabelle, die Sie sortieren und filtern können.
- Ein vollständiges Profil für jedes MitgliedDie Zeilen enthalten username, Anzeigename, die Bio in text, Avatar- und Titelbild, website und location.name – genug, um direkt aus der Zeile zu beurteilen, ob ein Konto passt.
- Reichweite, Aktivität und Kontoaltermetrics.followers_count, following_count und posts_count zeigen Publikum und Output jedes Mitglieds, und published_at gibt das Datum an, an dem das Konto X beigetreten ist.
- Flags für Verifizierung und Privatsphäreis_verified und is_private kennzeichnen verifizierte Mitglieder und geschützte Konten, sodass sich jede Gruppe gesondert behandeln lässt.
Parameter der Twitter List Members API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Öffentliche X-Listen-URLs, die auf /i/lists/<numeric id> enden, zum Beispiel https://x.com/i/lists/1940592907737845989. Die Mitglieder jeder Liste werden separat zurückgegeben. |
results_limit | Optional | Maximale Zahl der Mitglieder, die pro Liste exportiert werden, in Schritten von 20 von 20 bis 2.000. Standard ist 100. |
So verwenden Sie die Twitter List Members API
Senden Sie die Listen-URLs, die Sie exportieren möchten, und holen Sie die Mitgliederprofile ab, sobald die Aufgabe abgeschlossen ist.
- Kopieren Sie die URL jeder Liste auf x.com und senden Sie {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100} per POST an /v1/x/list-members.
- Prüfen Sie GET /v1/tasks/{task_id} alle paar Sekunden, bis der Status succeeded lautet.
- Speichern Sie die Mitgliederprofile aus results.items; solange has_more true ist, fordern Sie die nächste Seite mit results.next_cursor an.
curl -X POST "https://api.socq.ai/v1/x/list-members" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/i/lists/1940592907737845989"],"results_limit":100}'
# Each member's bio is in text and the date the account joined X is in published_at.Anwendungsfälle der Twitter List Members API
- Aus einer kuratierten Liste eine Shortlist für die Akquise machen: Exportieren Sie eine Liste wie Fintech-Gründer oder KI-Forscher und behalten Sie vor der Kontaktaufnahme die Mitglieder, deren Bio in text und deren website zu Ihrem Angebot passen.
- Die Konten einer Nische ranken und in Stufen einteilen: Sortieren Sie die Mitglieder nach metrics.followers_count und teilen Sie sie nach is_verified oder location.name auf, um die größten Stimmen und regionale Gruppen voneinander zu trennen.
- CRM- und Lead-Datensätze anreichern: Ergänzen Sie Kontaktdatensätze um username, website, location.name und Bio, abgeglichen über die Konto-ID jedes Mitglieds in id.
- Festhalten, wie sich eine Liste verändert: Exportieren Sie dieselbe Liste regelmäßig und vergleichen Sie die id-Werte der Mitglieder zwischen den Durchläufen, um zu sehen, wer hinzugefügt oder entfernt wurde.
Profi-Tipps zur Twitter List Members API
- Gleichen Sie Mitglieder über Exporte hinweg anhand der id ab, denn Benutzernamen können geändert werden.
- Lesen Sie location.name, um zu sehen, wo ein Mitglied nach eigener Angabe ist; city, region und country können null sein, auch wenn ein Ort angezeigt wird. Werten Sie location.name daher selbst aus, bevor Sie nach Land gruppieren.
- Setzen Sie results_limit auf das nächste Vielfache von 20 oberhalb der Mitgliederzahl der Liste, um die ganze Liste in einer Aufgabe zu exportieren; berechnet werden nur die zurückgegebenen Mitglieder.
- Übergeben Sie dieselbe Listen-URL an die X List Tweets API, um zu lesen, was diese Mitglieder posten, und an die Twitter List Followers API, um zu sehen, wer die Liste liest.
Verwandte APIs
Ergänzend zur Twitter List Members 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 Account Location API — Das Land, in dem ein Konto ansässig ist, die Art der Verbindung mit X, das Beitrittsdatum und Änderungen des Benutzernamens nachschlagen.
- X List Tweets API — Die Timeline einer Liste abrufen, neueste Posts zuerst, mit gekennzeichneten Reposts und ihren Originalautoren.
- 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 API
- X Community Posts API
- X Thread Context API
- X Verified Followers 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 Follow Checker API
- Twitter Video Transcript API