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
| 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. |
results_limit | Optional | Optionale 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.
- 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.
- 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.
- 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 einen Community-Post. 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-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.
Verwandte APIs
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.
- Twitter Profile Scraper API
- Twitter Search API
- X Followers List API
- X Following List API
- X Post Replies API
- X Post Retweeters API
- X Trends API
- Twitter User Search API
- X Community API
- X Account Location API
- X Verified Followers API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators 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