x/
community-posts

Öffentliche Posts aus X-Community-Links abrufen – mit Posttext, Autoren und Interaktionszahlen in einem Ergebnis und einer eigenen Ergebnisgrenze für jede Community.

X Community Posts API

Community-Diskussionen lesen
Posttext und Autoren
Eine Grenze 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 Posts

Community-Posts auf X sind Nachrichten innerhalb einer themenbezogenen Community, jeweils mit Autor, Veröffentlichungszeit, Text und eventuell angehängten Medien. Wenn Sie diese Posts zusammen mit ihren Interaktionszahlen lesen, lässt sich das Diskussionsmaterial ordnen, und die einzelnen Posts, aus denen die öffentliche Unterhaltung einer Community besteht, lassen sich miteinander vergleichen.

Funktionen der X Community Posts API

  • Posts aus der angegebenen Community lesenAusgehend von einem Community-Link erfassen Sie die öffentlichen Diskussionen genau dieser Community und nicht die Sammlung der Posts, die auf dem Profil einer einzelnen Person veröffentlicht wurden.
  • Für jede Community eine eigene Obergrenze festlegenWenn Sie mehrere Community-Links übergeben, gilt results_limit für jede einzelne Community, und die Posts werden in der Reihenfolge ihrer Erstellung erfasst. Mit Ihrer Eingabe legen Sie also fest, wie viele Posts je Diskussionsraum gesammelt werden.
  • Nachricht und Begleitangaben zusammenhaltenJeder Post-Datensatz enthält Text, Angaben zum Autor, Veröffentlichungszeit, Medien und die verfügbaren Interaktionszahlen. So lässt sich die Nachricht prüfen, ohne zu verlieren, wer sie wann veröffentlicht hat.

Parameter der X Community Posts 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.
results_limitOptionalOptionale maximale Anzahl Posts pro Community. Standard ist 100; zulässig sind Vielfache von 20 von 20 bis 2.000, zum Beispiel 20, 40 oder 100. Bei zwei Community-Links und einer Grenze von 20 kann jede Community bis zu 20 Posts beisteuern.

So verwenden Sie die X Community Posts 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. Kopieren Sie die Links der Communities, die Sie lesen möchten, und wählen Sie eine Grenze pro Community, zum Beispiel 20 oder 100. Verwenden Sie einen Community-Link und keine URL eines einzelnen Posts.
  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-posts 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 einen Community-Post. 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-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/i/communities/1493446837214187523"],"results_limit":20}'

Anwendungsfälle der X Community Posts API

  • Quellenmaterial für eine Diskussionsübersicht vorbereiten: Ordnen Sie Posttexte, Autoren-Handles, Links und Zeiten zu einer Leseliste, mit der jemand oder ein separates Zusammenfassungswerkzeug eine Übersicht über diese Posts schreiben kann.
  • Interaktionszahlen eines Posts über gespeicherte Momentaufnahmen vergleichen: Speichern Sie Post-IDs und die zurückgegebenen Zähler zusammen mit dem Erfassungszeitpunkt und ordnen Sie dieselben Posts in späteren Erfassungen zu, um die Veränderungen der verfügbaren Zahlen selbst zu berechnen.
  • Den Gesprächsverlauf um einen ausgewählten Post untersuchen: Wählen Sie einen Post aus den Community-Ergebnissen und übergeben Sie dessen Post-URL an X Thread Context, um die verfügbaren früheren Posts und Antworten rund um genau diese Nachricht zu lesen.

Profi-Tipps zur X Community Posts API

  • Multiplizieren Sie bei der Planung eines Batches die Anzahl der Community-Links mit results_limit, um die angeforderte Datensatzzahl abzuschätzen. Rechnen Sie dann mit dem Preis pro Post und gehen Sie nicht davon aus, dass sich alle Communities das Limit teilen.
  • Gleichen Sie bei wiederholten Erfassungen die Posts anhand ihrer IDs ab, bevor Sie sie an Ihre gespeicherte Tabelle anhängen, denn ein Post kann in einer späteren Aufgabe erneut auftauchen.
  • Speichern Sie bei Ergebnissen aus mehreren Communities die übergebenen Community-Links zusammen mit der Aufgabeneingabe, denn der Standard-Post-Datensatz enthält keine Community-ID, die diesen Eingabekontext ersetzen könnte.

Ergänzend zur X Community Posts API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher X-Daten benötigen.

  • Twitter Tweet Scraper API — Öffentliche Post-Texte, Autoren, Interaktionen, Medien, Hashtags, Erwähnungen und Gesprächsbeziehungen aus Status-URLs von x.com oder twitter.com abrufen.
  • Twitter User Tweets Scraper API — Aktuelle öffentliche Posts, Autoren, Medien, Hashtags, Erwähnungen und Interaktionen per Benutzername erfassen – ohne Antworten.
  • X Post Quotes API — Öffentliche Zitat-Posts zu bekannten Status-URLs erfassen – mit Kommentar, Autoren, Interaktionen, Medien, Zeitstempeln und Kontext des Quell-Posts.
  • Twitter Mentions API — Öffentliche Posts erfassen, die ein angegebenes Konto erwähnen.
  • X Thread Context API — Einen Post zusammen mit früheren Nachrichten der Antwortkette, öffentlichen Antworten und Beziehungs-IDs auslesen.
  • X List Tweets API — Die Timeline einer Liste abrufen, neueste Posts zuerst, mit gekennzeichneten Reposts und ihren Originalautoren.

Weitere Plattformen entdecken

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

X Community Posts API — FAQ

X Community Posts API ist eine Schnittstelle, die öffentliche Posts aus einer Liste von X-Community-Links liest. Sie liefert Posttext, Autoren, Medien, Zeitstempel und Interaktionszahlen in der Reihenfolge der Erstellung, mit einer Ergebnisgrenze für jede Community.

Eine Community bündelt die Posts, die in diesem Diskussionsraum geteilt werden, während eine Profil-Timeline die Posts eines einzelnen Kontos bündelt. Übergeben Sie hier Community-Links; verwenden Sie X User Posts, wenn Sie vom Benutzernamen eines Kontos ausgehen.

Nein. Es bedeutet bis zu 100 Posts für jeden Community-Link. Bei drei Communities können Sie zum Beispiel insgesamt bis zu 300 Posts anfordern, wobei öffentliche Verfügbarkeit und Deduplizierung die endgültige Datensatzzahl verringern können.

Das Limit muss in Schritten von 20 angegeben werden, verwenden Sie also Werte wie 20, 40, 60 oder 100. Der zulässige Bereich reicht von 20 bis 2.000, der Standardwert ist 100.

Nein. Mit dem Cursor einer Aufgabe lesen Sie lediglich eine weitere Seite der Ergebnisse, die diese Aufgabe bereits gespeichert hat. Die ursprüngliche Obergrenze pro Community wird dadurch nicht erhöht, und es wird auch keine neue Erfassung gestartet.

Nein. Er liefert Post-Datensätze, die Sie lesen, ordnen oder an einen separaten Zusammenfassungsprozess übergeben können. Eine fertige Zusammenfassung oder Analyse ist nicht Teil der Antwort.

Jeder zurückgegebene Post kostet 0,7 Credits, ohne Grundgebühr. Zwei Community-Links mit einem Limit von 100 ergeben eine Schätzung von 140 Credits; liefert die Aufgabe insgesamt 30 Posts, beträgt die endgültige Abrechnung 21 Credits.