X Community
Eine X-Community ist ein themenbezogener Diskussionsraum mit Name, Beschreibung, Mitgliederzahlen und Regeln für die Teilnahme. Diese Angaben helfen dabei, das Thema der Community zu verstehen, ihre Größe mit anderen zu vergleichen und ihre Teilnahmerichtlinien zu prüfen, bevor man die Diskussionen erkundet.
Funktionen der X Community API
- Verstehen, worum es in einer Community gehtSie erhalten Name, öffentliche Beschreibung, Link, Titelbild und Angaben zum Ersteller der Community zusammen und können den Raum so identifizieren und sein erklärtes Thema lesen, bevor Sie nach Posts suchen.
- Größe und Teilnahmerichtlinien einsehenSie erhalten die Zahlen zu Mitgliedern und Moderatoren zusammen mit join_policy und invites_policy, die beschreiben, wie Beitritte und Einladungen von Mitgliedern gehandhabt werden.
- Die eigenen Regeln der Community lesenDie Liste der Regeln enthält Namen und Beschreibungen der Regeln, sodass Sie die Teilnahmebedingungen zusammen mit den Grunddaten der Community aufbewahren können.
Parameter der X Community API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Erforderliche Liste öffentlicher X-Community-Links mit numerischer Community-ID, zum Beispiel https://x.com/i/communities/1493446837214187523. Tragen Sie im Playground einen Link pro Zeile ein oder verwenden Sie im Code ein JSON-Array urls, und geben Sie keinen Profil-, Such- oder Einzelpost-Link an. |
So verwenden Sie die X Community API
Die Anfrage startet eine Aufgabe, die im Hintergrund Daten erfasst. Die erste Antwort enthält deshalb eine Aufgaben-ID statt der fertigen Daten; mit dieser ID prüfen Sie den Fortschritt und rufen die Ergebnisse ab.
- Öffnen Sie die öffentliche Community-Seite und kopieren Sie ihren Link mit /i/communities/; bereiten Sie für jede Community, die Sie abfragen möchten, einen Link vor.
- Ersetzen Sie vor dem Ausführen des Beispiels $SOCQ_API_KEY durch Ihren eigenen API-Schlüssel oder setzen Sie diese Umgebungsvariable. Senden Sie die JSON-Eingabe mit dem unten gezeigten Authorization-Header per POST an /v1/x/community und speichern Sie die task_id aus der Antwort.
- Fragen Sie mit der gespeicherten ID den Endpunkt GET /v1/tasks/{task_id} ab, um den Fortschritt zu prüfen. queued bedeutet Wartestellung, running bedeutet, dass die Erfassung läuft, und retrying bedeutet, dass ein weiterer Versuch läuft. Warten Sie auf succeeded, bevor Sie die Ergebnisse lesen; hat die Aufgabe den Status failed, finden Sie den Grund in error_message.
- Wenn die Aufgabe erfolgreich war, lesen Sie data.results.items: Jeder Eintrag dieser Liste beschreibt die Details einer Community. Eine leere Liste bedeutet, dass die Aufgabe abgeschlossen wurde, ohne Datensätze zurückzugeben.
- Ist data.results.has_more gleich true, ist der Wert next_cursor die Markierung für eine weitere Seite gespeicherter Ergebnisse. Übernehmen Sie ihn unverändert in den Parameter cursor von GET /v1/tasks/{task_id}?cursor=... und fahren Sie fort, bis has_more false ist.
curl -X POST "https://api.socq.ai/v1/x/community" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/i/communities/1493446837214187523"]}'Anwendungsfälle der X Community API
- Ein Verzeichnis von Communities zum Erkunden anlegen: Tragen Sie Community-Namen, Beschreibungen, Links und Mitgliederzahlen in eine Tabelle ein, damit sich die übergebenen Communities nach Thema und Größe vergleichen lassen, bevor man entscheidet, welche Diskussionen man liest.
- Teilnahmeregeln zu einer Diskussionsprüfung aufbewahren: Speichern Sie die Regeln und Mitgliedschaftsrichtlinien unter der Community-ID und verwenden Sie anschließend X Community Posts separat, um die Posts, die Sie prüfen möchten, mit diesem Community-Hintergrund zu verbinden.
Profi-Tipps zur X Community API
- Gehen Sie von einem Post statt von einer Community-Seite aus, ermitteln Sie zuerst den öffentlichen Community-Link, denn diese Abfrage bestimmt die Community eines Posts nicht anhand der Post-URL.
- Erscheint dieselbe Community unter Links von x.com und twitter.com, verwenden Sie die numerische ID nach /i/communities/ als Abgleichsschlüssel, damit keine doppelten Einträge im Verzeichnis entstehen.
- Nutzen Sie Mitgliederzahlen beim Vergleichen von Communities als Maß für die Größe und nicht als Beleg dafür, wie aktiv Mitglieder posten; dieses Ergebnis enthält weder einen Aktivitätsverlauf noch eine Liste einzelner Mitglieder.
Verwandte APIs
Ergänzend zur X Community 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 Posts API — Die in einer Community geteilten öffentlichen Posts auslesen – mit Text, Autoren und Interaktionszahlen.
- X Community Members API — Die Mitglieder einer Community als vollständige Profile mit Bio und Follower-Zahlen exportieren.
- 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 Thread Context API
- X Account Location 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