x/
community-members

Die Mitglieder einer öffentlichen X-Community über ihren Link exportieren – mit Bio, Standort, Website, Verifizierungs-Flag und Followerzahlen jedes Mitglieds, bis zu 2.000 pro Community.

X Community Members API

Community-Link als Eingabe
Ein Profil pro Mitglied
Bis zu 2.000 Mitglieder pro Community
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

X Community Members

Die Mitglieder einer X-Community sind die Konten, die sich bewusst einer themenbezogenen Community angeschlossen haben, und jedes davon hat ein öffentliches Profil mit Bio, Standort, Website, Verifizierungsstatus, Erstellungsdatum des Kontos und der Zahl der Follower, gefolgten Konten und Posts. Da der Beitritt eine bewusste Entscheidung rund um ein einzelnes Thema ist, beschreiben diese Profile ein selbst gewähltes Publikum, dessen Größe sich einschätzen lässt, das sich nach Reichweite oder Ort segmentieren und mit den Mitgliedern einer benachbarten Community vergleichen lässt.

Funktionen der X Community Members API

  • Mitgliederlisten aus Community-LinksFügen Sie einen oder mehrere Links der Form https://x.com/i/communities/<id> ein, und jedes Mitglied jeder Community kommt als eigene Profilzeile zurück.
  • Wer jedes Mitglied istDie Zeilen enthalten Benutzername, Anzeigename, die Bio in text, Avatar, Titelbild, Website und den angegebenen Standort, sodass sich ein Mitglied allein aus dem Export erkennen und beschreiben lässt.
  • Reichweite jedes Mitgliedsmetrics enthält followers_count, following_count und posts_count und trennt so die lauten Stimmen einer Community von ihrer stillen Mehrheit.
  • Verifizierung und Kontoalteris_verified, is_private und published_at, das Erstellungsdatum des X-Kontos des Mitglieds, zeigen auf einen Blick, wie etabliert jede Person in der Liste ist.

Parameter der X Community Members API

ParameterErforderlichBeschreibung
urlsErforderlichÖffentliche X-Community-Links in der Form https://x.com/i/communities/<numeric_id>, einer pro Zeile.
results_limitOptionalZurückzugebende Mitglieder pro Community, ein Vielfaches von 20 von 20 bis 2.000. Standard ist 100.

So verwenden Sie die X Community Members API

Senden Sie Community-Links und blättern Sie durch die Mitgliederprofile.

  1. Senden Sie {"urls": ["https://x.com/i/communities/1493446837214187523"], "results_limit": 100} per POST an /v1/x/community-members.
  2. Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat.
  3. Lesen Sie die Mitgliederprofile aus results.items und senden Sie results.next_cursor zurück, solange has_more true ist.
curl -X POST "https://api.socq.ai/v1/x/community-members" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/i/communities/1493446837214187523"],"results_limit":100}'

# results_limit is applied to each community in urls, so two links can return up to 200 members here.

Anwendungsfälle der X Community Members API

  • Das Publikum einer Community beschreiben: Gruppieren Sie die Mitglieder nach location.name, durchsuchen Sie die Bios in text nach Berufsbezeichnungen und Interessen und stellen Sie followers_count grafisch dar, um zu beschreiben, wer einer Community tatsächlich beigetreten ist.
  • Mitglieder für Partnerschaften vorauswählen: Sortieren Sie die Mitglieder nach metrics.followers_count, behalten Sie die verifizierten und nutzen Sie website und Bio, um innerhalb einer Nische die Creator auszuwählen, deren Ansprache sich lohnt.
  • Die Überschneidung zweier Communities messen: Exportieren Sie die Mitglieder zweier verwandter Communities und gleichen Sie sie über id ab, um die Personen zu zählen, die beiden angehören.
  • Eine Community auf frisch erstellte Konten prüfen: Kombinieren Sie ein junges published_at mit niedrigen Werten bei posts_count und followers_count, um zu sehen, welcher Anteil der Mitglieder einer Community aus neu erstellten oder kaum aktiven Konten besteht.

Profi-Tipps zur X Community Members API

  • Senden Sie eine Community pro Aufgabe, wenn Sie Mitgliedschaften vergleichen wollen; Mitgliederzeilen enthalten nur das Profil, deshalb ordnet erst die Eingabe der Aufgabe jede Zeile ihrer Community zu.
  • Lesen Sie zuerst members_count aus X Community oder X Communities Search und setzen Sie results_limit auf das nächste Vielfache von 20 darüber, um die ganze Liste in einer Aufgabe anzufordern.
  • Normalisieren Sie location.name, bevor Sie nach Land gruppieren: Das Feld enthält den frei eingegebenen Ort eines Mitglieds, etwa „Sydney“, und die Felder für Stadt und Land sind oft leer.

Ergänzend zur X Community 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 Community API — Aus Community-Links Beschreibung, Mitgliederzahlen, Regeln und Beitrittsregeln auslesen.
  • 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 Community Moderators API — Die Admins und Moderatoren einer Community als vollständige Profile abrufen.

Weitere Plattformen entdecken

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

X Community Members API — FAQ

X Community Members API ist eine Programmierschnittstelle, die die Mitglieder öffentlicher X-Communities über ihre Links mit /i/communities/ exportiert. Sie liefert pro Mitglied ein Profil mit Benutzername, Bio, Standort, Website, Verifizierungsstatus und der Zahl der Follower, gefolgten Konten und Posts.

Ja. Der Community-Link ist die einzige Eingabe, Sie können also die Mitglieder einer öffentlichen Community exportieren, der Sie nie beigetreten sind, und ein X-Login wird dafür nicht benötigt.

Suchen Sie mit X Communities Search nach einem Keyword. Jedes Ergebnis enthält die url der Community, die Sie unverändert an diesen Endpunkt übergeben können.

Bis zu 2.000. results_limit akzeptiert Vielfache von 20 von 20 bis 2.000, hat den Standardwert 100 und gilt separat für jeden Community-Link in der Anfrage.

Nein. published_at ist das Datum, an dem das X-Konto des Mitglieds erstellt wurde. Das Beitrittsdatum zur Community ist nicht Teil des Ergebnisses.

Wird keine der Communities in einer Anfrage gefunden, schlägt die Aufgabe fehl und die Credits werden vollständig erstattet. Fehlen nur einige, werden die Mitglieder der übrigen trotzdem zurückgegeben.