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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Öffentliche X-Community-Links in der Form https://x.com/i/communities/<numeric_id>, einer pro Zeile. |
results_limit | Optional | Zurü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.
- Senden Sie {"urls": ["https://x.com/i/communities/1493446837214187523"], "results_limit": 100} per POST an /v1/x/community-members.
- Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat.
- 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.
Verwandte APIs
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.
- Twitter Tweet Scraper API
- Twitter User Tweets Scraper API
- Twitter Search API
- X Post Quotes API
- X Post Replies API
- X Post Retweeters API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community Posts API
- X Thread Context API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers 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