XTwitter Community APIX Community Info APITwitter Community Details APICommunity-Metadaten

Twitter/X-Community-Details per API abrufen: Anleitung

Erstellen Sie mit SocQ eine Profiltabelle für Twitter/X-Communities. Exportieren Sie Namen, Regeln und Zahlen mit Quelllinks und Erfassungszeiten und verknüpfen Sie Posts für die Recherche.

SocQAktualisiert am 16. Oktober 20266 Min. Lesezeit

Mit SocQ lassen sich Namen, Beschreibungen, Regeln sowie die Zahl der Mitglieder und Moderatoren von Twitter/X-Communities in einer Profiltabelle ordnen. Speichern Sie Quellen und Erfassungszeiten und verknüpfen Sie anschließend Posts mit dem erfassten Community-Kontext, um sie zu prüfen.

Die SocQ X Community API fragt Metadaten anhand der öffentlichen Community-URL ab. Diese Anleitung behandelt Anfragen, zurückgegebene Felder sowie JSON- und CSV-Exporte mit Quelllinks und Erfassungszeiten.

Kurzantwort: Tragen Sie Links der Form x.com/i/communities/{numeric_id} in urls ein und senden Sie sie an POST /v1/x/community. Nach erfolgreichem Abschluss lesen Sie Namen, Beschreibungen, Regeln, die Zahl der Mitglieder und Moderatoren sowie Beitritts- und Einladungsrichtlinien aus data.results.items. Posts fragen Sie separat über Community Posts ab.

Profiltabelle aus Community-URLs erstellen

Tragen Sie eine Community-URL in urls ein, um Name, Beschreibung, Regeln, die Zahl der Mitglieder und Moderatoren sowie Beitritts- und Einladungsrichtlinien abzufragen. Dieses Beispiel verwendet die Community Build in Public:

https://x.com/i/communities/1493446837214187523

Das letzte numerische Segment ist die Community-ID. Übergeben Sie in urls die vollständige URL der Form /i/communities/{numeric_id}.

Wenn Sie nur einen Namen haben, ermitteln Sie zuerst die zugehörige Community-URL. Ordnen Sie Datensätze über die numerische Community-ID zu und halten Sie Communities mit unterschiedlichen IDs getrennt, auch wenn ihre Namen übereinstimmen.

FrageVerwenden
Welche Metadaten gibt es zu dieser Community?X Community
Welche Posts lassen sich aus der Community erfassen?X Community Posts
Wie hängen die Posts einer Diskussion zusammen?X Thread Context

Dieser Endpunkt fragt die Metadaten von Themen-Communities ab. Community Notes sind Anmerkungen zu einzelnen Posts und ein eigener Datentyp.

Community-Details abfragen

Setzen Sie SOCQ_API_KEY und senden Sie dann die URL:

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"]}'

Für einen Batch ergänzen Sie weitere öffentliche Community-Links in urls. Jeder zurückgegebene Datensatz beschreibt eine Community; zählen Sie die Ergebnisse anhand der tatsächlich zurückgegebenen Datensätze.

Speichern Sie data.task_id als TASK_ID und fragen Sie dann die bestehende Aufgabe ab:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=100" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Warten Sie zwischen den Abfragen, solange der Status queued, running oder retrying lautet. Lesen Sie nach succeeded die Einträge in data.results.items und alle weiteren gespeicherten Ergebnisseiten. Schlägt die Aufgabe fehl, prüfen Sie data.error_message. Die Paginierung der Aufgabe liest gespeicherte Daten; sie aktualisiert keine Community-Informationen.

Regeln, Zahlen und Beitrittsrichtlinien auslesen

Dieses Metadaten-Beispiel zeigt ausgewählte Felder und eine Regel aus dem Array rules:

{
  "id": "1493446837214187523",
  "type": "community",
  "name": "Build in Public",
  "metrics": {"members_count": 268858, "moderators_count": 6},
  "join_policy": "Open",
  "invites_policy": "MemberInvitesAllowed",
  "rules": [
    {
      "id": "1493447542045958144",
      "name": "Share what you're working on",
      "description": "Don't be scared to share unfinished work"
    }
  ],
  "collected_at": "2026-10-15T08:12:58.252843Z"
}

text enthält die Beschreibung, rules die strukturierte Regelliste und metrics die Zahlen. Halten Sie Regelnamen und Beschreibungen getrennt und setzen Sie null, wenn die Quelle eine Beschreibung auslässt.

metrics.members_count hält die Gesamtzahl der Mitglieder fest, metrics.moderators_count die Gesamtzahl der Moderatoren. Speichern Sie die zugehörigen Erfassungszeiten, um die Zahlen derselben Community über mehrere Erfassungen hinweg zu vergleichen.

join_policy und invites_policy speichern die ursprünglichen Zeichenfolgen der Beitritts- und Einladungsrichtlinie. Behalten Sie das Original, wenn Sie einen bekannten Wert beschriften, und zeigen Sie unbekannte Werte so an, wie sie zurückgegeben wurden. Prüfen Sie den tatsächlichen Beitrittszugang in der aktuellen Produktoberfläche von X.

Profiltabelle der Communities mit Python exportieren

Speichern Sie diesen Aufgaben-Helfer, der nur die Standardbibliothek nutzt, als socq_collect.py:

import json
import os
import time
from urllib.parse import urlencode
from urllib.request import Request, urlopen

BASE = "https://api.socq.ai/v1"
PENDING = {"queued", "running", "retrying"}

def api(method, path, payload=None):
    body = json.dumps(payload).encode("utf-8") if payload is not None else None
    request = Request(
        BASE + path, data=body, method=method,
        headers={
            "Authorization": "Bearer " + os.environ["SOCQ_API_KEY"],
            "Content-Type": "application/json",
        },
    )
    with urlopen(request, timeout=60) as response:
        result = json.load(response)
    if result.get("code") != 200:
        raise RuntimeError(result)
    return result["data"]

def collect(endpoint, payload):
    task_id = api("POST", "/" + endpoint, payload)["task_id"]
    print("Task:", task_id, flush=True)
    path = "/tasks/" + task_id
    deadline = time.monotonic() + 600
    data = api("GET", path + "?limit=100")
    while data["status"] in PENDING:
        if time.monotonic() >= deadline:
            raise TimeoutError("Resume GET " + path + "; do not resubmit automatically")
        time.sleep(2)
        data = api("GET", path + "?limit=100")
    if data["status"] != "succeeded":
        raise RuntimeError(data.get("error_message") or data["status"])

    items, seen_cursors = [], set()
    while True:
        if time.monotonic() >= deadline:
            raise TimeoutError("Resume pagination for " + task_id)
        page = data["results"]
        items.extend(page["items"])
        if not page["has_more"]:
            return task_id, items
        cursor = page.get("next_cursor")
        if not cursor or cursor in seen_cursors:
            raise RuntimeError("Missing or repeated result cursor")
        seen_cursors.add(cursor)
        data = api("GET", path + "?" + urlencode({"limit": 100, "cursor": cursor}))
        if data["status"] != "succeeded":
            raise RuntimeError("Task is not ready for result pagination")

Speichern Sie den Exporter als export_communities.py im selben Verzeichnis:

import csv
import json
from socq_collect import collect

urls = ["https://x.com/i/communities/1493446837214187523"]
task_id, items = collect("x/community", {"urls": urls})
with open("communities.json", "w", encoding="utf-8") as f:
    json.dump({"task_id": task_id, "input": {"urls": urls}, "items": items},
              f, ensure_ascii=False, indent=2)

fields = ["community_id", "url", "name", "description", "members_count",
          "moderators_count", "join_policy", "invites_policy", "rules_json", "collected_at"]
def csv_cell(value):
    if value is None:
        return ""
    if isinstance(value, str) and value.lstrip().startswith(("=", "+", "-", "@")):
        return "'" + value
    return value

with open("communities.csv", "w", encoding="utf-8-sig", newline="") as f:
    writer = csv.DictWriter(f, fieldnames=fields)
    writer.writeheader()
    for item in items:
        metrics = item.get("metrics") or {}
        row = {"community_id": item.get("id"), "url": item.get("url"),
               "name": item.get("name"), "description": item.get("text"),
               "members_count": metrics.get("members_count"),
               "moderators_count": metrics.get("moderators_count"),
               "join_policy": item.get("join_policy"),
               "invites_policy": item.get("invites_policy"),
               "rules_json": json.dumps(item.get("rules"), ensure_ascii=False),
               "collected_at": item.get("collected_at")}
        writer.writerow({k: csv_cell(v) for k, v in row.items()})
python3 export_communities.py

Das JSON enthält die rohen Standarddatensätze und die übermittelten Links. Die CSV-Datei liefert pro zurückgegebener Community eine Prüfzeile; die Regeln sind als JSON serialisiert, damit Kommas und Zeilenumbrüche ihre Struktur nicht zerstören. rules_json=null bleibt von einer leeren Liste unterscheidbar. Formelähnlicher öffentlicher Text wird nur in der CSV-Datei maskiert, und Kennungen sollten als Text importiert werden.

Liefert eine Eingabe keine Metadaten, halten Sie das leere Ergebnis und den Abfragezeitpunkt gesondert fest. Bereits gespeicherte Metadaten behalten für historische Vergleiche ihre ursprüngliche Erfassungszeit.

Community-Metadaten mit erfassten Posts verbinden

Verwenden Sie dieselbe bestätigte Community-URL mit X Community Posts, wenn Sie Diskussionen benötigen. Das startet eine eigene Aufgabe mit eigener Ergebnisobergrenze. Die Anleitung zu Community Posts zeigt, wie sich beim Export der Posts die Eingabe-Community als Quelle erhalten lässt.

Speichern Sie Community-ID, Quell-URL, Aufgaben-ID und Erfassungszeit zusammen mit den Metadaten. Hängen Sie an jeden erfassten Post die Eingabe-Community an, damit sich Profil- und Post-Tabelle über die Community-ID verknüpfen lassen.

Prüfen Sie Beschreibung, Regeln und erfasste Posts gemeinsam, jeweils mit ihren Erfassungszeiten. Für die Antwortbeziehungen eines Posts geht es mit der Anleitung zum Thread-Kontext weiter.

Community-Metadaten zur wiederverwendbaren Recherchegrundlage machen

SocQ ordnet Community-Metadaten in Standardfeldern. Mit dem Code speichern Sie eine Profiltabelle samt strukturierten Regeln und verknüpfen erfasste Posts über die Community-ID. Beschreibungen, Regeln und Diskussionen haben so eine gemeinsame, nachvollziehbare Quelle für Rechercheakten, Stichprobenprüfungen und datierte Aktualisierungen.

X Community öffnen und Ihre Quell-URL abfragen.

Häufig gestellte Fragen (FAQ)

Was liefert die Twitter Community API?

Community-Namen, Beschreibungen, Regeln, die Zahl der Mitglieder und Moderatoren sowie Beitritts- und Einladungsrichtlinien. Felddefinitionen und Abrechnung finden Sie auf der Seite zur X Community API.

Wie frage ich Metadaten nach der Ankündigung zur Community-Migration ab?

X hat eine Ankündigung zur Migration von Communities zu XChat veröffentlicht. Verwenden Sie für die Metadatenabfrage die URL der Ziel-Community: Lesen Sie die zurückgegebenen Datensätze nach erfolgreichem Abschluss der Aufgabe, speichern Sie bei leeren Ergebnissen den Abfragezeitpunkt und prüfen Sie bei Fehlern die Fehlerdetails. Funktionen für Beitritt und Teilnahme prüfen Sie in der aktuellen Oberfläche von X.

Kann ich nach einer Community über ihren Namen suchen?

Die Abfrage nimmt Community-URLs entgegen. Bestätigen Sie den zum Namen gehörenden Link und übermitteln Sie ihn dann in urls.

Enthält die Mitgliederzahl eine Liste der Mitglieder oder Moderatoren?

Die Antwort enthält die aggregierten Zahlen der Mitglieder und Moderatoren. Verzeichnisse einzelner Konten sind eigene Daten und nicht Teil dieser Metadaten-Antwort.

Bedeutet die Richtlinie Open, dass ich jetzt beitreten kann?

Open ist der in den Metadaten zurückgegebene Wert der Beitrittsrichtlinie. Prüfen Sie den aktuellen Beitrittszugang in der Oberfläche von X; dieser Endpunkt liest die Metadaten.

Sind Community-Posts oder Community Notes enthalten?

Community-Posts fragen Sie mit X Community Posts ab. Community Notes sind eigene Anmerkungen zu Posts. Dieser Endpunkt liefert Community-Metadaten.

Kann ich anhand dieser Zahlen die Aktivität von Communities einordnen?

Die Gesamtzahlen der Mitglieder und Moderatoren beschreiben die Größe. Um die Aktivität zu untersuchen, erfassen Sie Posts, wählen in Ihrer Anwendung anhand von published_at einen Zeitraum aus und zählen innerhalb dieser Stichprobe Posts, Autoren oder Interaktionen.

X API

Workflow mit einer öffentlichen X-URL testen

Senden Sie öffentliche Eingaben und erhalten Sie normalisierte Datensätze mit nachvollziehbarem Quellkontext.

X-APIs ansehen