x/
community

Öffentliche X-Community-Details über Community-Links lesen – mit Beschreibungen, Mitgliederzahlen und Regeln und mit Unterstützung für die Abfrage mehrerer Communities auf einmal.

X Community API

Community-Details
Zahlen zu Mitgliedern und Moderatoren
Regeln und Beitrittsrichtlinien
0,5 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

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

ParameterErforderlichBeschreibung
urlsErforderlichErforderliche 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.

  1. Ö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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.

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.

Weitere Plattformen entdecken

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

X Community API — FAQ

X Community API ist eine Schnittstelle zum Abrufen öffentlicher X-Community-Informationen aus einer Liste von Community-Links. Sie liefert Community-Namen, Beschreibungen, Zahlen zu Mitgliedern und Moderatoren, Regeln und Beitrittsrichtlinien, damit Sie jede Community verstehen, bevor Sie ihre Posts erkunden.

Ein Community-Link enthält /i/communities/ gefolgt von einer numerischen ID. Ein Profil-Link verweist auf ein Konto und ein Link mit /status/ auf einen Post; beides ist daher keine Eingabe für diese Abfrage.

Nein. Eine Zahl sagt Ihnen, wie viele Mitglieder die Community hat, nicht aber, wer diese Mitglieder sind; die Antwort enthält kein Mitgliederverzeichnis.

Nein. Diese Abfrage liefert die Beschreibung, die Regeln und weitere Metadaten der Community. Verwenden Sie denselben Community-Link mit X Community Posts, wenn Sie die Diskussionen selbst brauchen.

Nein. X-Communities sind Räume, die um gemeinsame Diskussionsthemen organisiert sind. Community Notes sind Anmerkungen zu Posts, und diese Anmerkungen sind nicht das Objekt, das hier zurückgegeben wird.

Jeder zurückgegebene Community-Datensatz kostet 0,5 Credits, ohne Grundgebühr. Vier übergebene Community-Links ergeben zum Beispiel eine Schätzung von 2 Credits, und vier zurückgegebene Community-Datensätze kosten 2 Credits.