x/
list-posts

Die neuesten Posts und Reposts aus öffentlichen X-Listen-Timelines per Listen-URL erfassen – mit Text, Autor, Likes, Aufrufen, Medien und Repost-Kennzeichnung bei jedem Eintrag, neueste zuerst.

X List Tweets API

Listen-URL als Eingabe
Reposts gekennzeichnet
Neueste Posts zuerst
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 List Tweets

Eine X-Listen-Timeline ist der Feed aus Tweets und Retweets der Konten, die jemand in einer Liste zusammengefasst hat, jeweils mit Text, Autor, Likes, Kommentaren, Reposts, Aufrufen, angehängten Bildern oder Videos, Hashtags und Erwähnungen. Zusammen gelesen zeigen diese Posts, worüber eine kuratierte Gruppe von Journalisten, Gründern oder Wettbewerbern spricht, welche Mitglieder mit ihren Posts die meiste Interaktion erzielen und wessen Inhalte die Gruppe immer wieder weitergibt.

Funktionen der X List Tweets API

  • Timeline jeder öffentlichen Liste per URLSenden Sie einen oder mehrere Links der Form x.com/i/lists/<id>, und die Timeline jeder Liste kommt mit den neuesten Posts zuerst zurück, bis zu 2.000 Tweets pro Liste.
  • Reposts gekennzeichnet, Originalautor separatis_repost markiert jeden Repost; author bleibt das Listenmitglied, das ihn geteilt hat, während reposted_author und reposted_post_id auf den ursprünglichen Creator und Post verweisen.
  • Interaktion und Medien zu jedem Postmetrics enthält Likes, Kommentare, Shares und Aufrufe, und media führt jedes Bild und Video mit URL, Vorschaubild, Breite und Höhe auf.
  • Hashtags und Erwähnungen als eigene Arrayshashtags und mentions kommen als eigene Listen, sodass sich die Themen einer Liste und die Konten, an die sich ihre Mitglieder wenden, direkt aus den Feldern zählen lassen.

Parameter der X List Tweets API

ParameterErforderlichBeschreibung
urlsErforderlichÖffentliche X-Listen-URLs in der Form https://x.com/i/lists/<numeric id>. Die Timeline jeder Liste wird separat erfasst.
results_limitOptionalAnzahl der Posts, die aus jeder Liste erfasst werden, ein Vielfaches von 20 von 20 bis 2.000. Standard ist 100.

So verwenden Sie die X List Tweets API

Senden Sie Listen-URLs, warten Sie, bis die Aufgabe abgeschlossen ist, und lesen Sie die Timeline dann Seite für Seite.

  1. Senden Sie {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100} per POST an /v1/x/list-posts.
  2. Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat.
  3. Lesen Sie die Posts aus results.items, neueste zuerst, und senden Sie results.next_cursor zurück, solange has_more true ist.
curl -X POST "https://api.socq.ai/v1/x/list-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/i/lists/1940592907737845989"],"results_limit":100}'

# Reposts arrive with is_repost set to true and the original creator in reposted_author.

Anwendungsfälle der X List Tweets API

  • Ein Themenfeld über eine kuratierte Liste verfolgen: Rufen Sie jeden Morgen die Timeline einer Liste mit Journalisten oder Analysten ab und lesen Sie text, author und published_at, um zu sehen, worüber die Gruppe seit dem letzten Durchlauf berichtet hat.
  • Die Posts ranken, auf die eine Nische reagiert: Behalten Sie die Originalposts (is_repost false) und sortieren Sie sie nach views_count und likes_count, um herauszufinden, welche Mitglieder mit ihren Posts die meiste Aufmerksamkeit erhielten.
  • Messen, wen eine Gruppe verstärkt: Zählen Sie reposted_author.username über alle Reposts, um zu sehen, welche externen Konten und welche anderen Mitglieder eine Liste am häufigsten weitergibt.
  • Ankündigungen von Wettbewerbern in einem Feed sammeln: Setzen Sie die Konten konkurrierender Marken auf eine Liste und erfassen Sie deren Timeline, um ihre Launch-Posts, Links und angehängten Medien zusammen festzuhalten.
  • Einen Themendatensatz für eine Community aufbauen: Gruppieren Sie die hashtags und mentions aus den Posts einer Liste nach published_at, um darzustellen, welche Themen und Konten die Community im Zeitverlauf diskutiert.

Profi-Tipps zur X List Tweets API

  • Filtern Sie nach is_repost, bevor Sie Mitglieder nach Interaktion ranken, denn ein Repost trägt die Likes und Aufrufe des Originalposts.
  • Wenn mehrere Mitglieder denselben Post reposten, deduplizieren Sie anhand von reposted_post_id, damit jedes Original einmal gezählt wird.
  • Erhöhen Sie results_limit, wenn Sie aus einer aktiven Liste viele Originalposts brauchen, denn Reposts können den Großteil ihrer Timeline ausmachen.
  • Der Text eines Reposts beginnt mit „RT @user:“, und seine mentions enthalten diesen Nutzer. Entfernen Sie daher Reposts oder das Präfix, bevor Sie Keywords und Erwähnungen zählen.
  • Behalten Sie bei geplanten Durchläufen nur Einträge, deren id in Ihrem Bestand neu ist, denn eine Timeline mit den neuesten Posts zuerst überschneidet sich mit dem vorherigen Durchlauf.
  • Um alle Konten zu sehen, die die Timeline speisen, auch Mitglieder, die selten posten, erfassen Sie dieselbe Liste mit der Twitter List Members API.

Ergänzend zur X List Tweets 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.
  • X Post Replies API — Öffentliche Antworten aus X-Post-URLs erfassen – mit wählbarer Sortierung, Antworttext, Autoren, sichtbaren Interaktionen, Medien und Kontext des übergeordneten Posts.
  • Twitter Mentions API — Öffentliche Posts erfassen, die ein angegebenes Konto erwähnen.
  • Twitter List Members API — Die Konten einer Liste als vollständige Profile mit Bio, Standort und Kennzahlen exportieren.

Weitere Plattformen entdecken

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

X List Tweets API — FAQ

X List Tweets API ist eine Programmierschnittstelle, die die Timeline öffentlicher X-Listen über deren Listen-URLs mit /i/lists/ erfasst. Sie liefert jeden Post oder Repost mit Text, Autor, Likes, Kommentaren, Shares, Aufrufen, Medien, Hashtags, Erwähnungen und Repost-Quelle.

Öffnen Sie die Liste auf x.com, kopieren Sie ihre URL (sie sieht so aus: https://x.com/i/lists/1940592907737845989) und übergeben Sie sie in urls. Die Posts kommen mit den neuesten zuerst zurück, in derselben Reihenfolge wie in der Timeline der Liste.

Es ist die Zahl nach /i/lists/ in der URL der Liste. Tragen Sie beim Senden die vollständige URL in urls ein.

Ja. Reposts von Listenmitgliedern werden zurückgegeben und mit is_repost markiert, mit der ID des Originalposts in reposted_post_id und seinem Creator in reposted_author. Filtern Sie nach is_repost, wenn Sie nur Originalposts möchten.

Eine URL, die auf eine nicht existierende Liste verweist, liefert ein leeres Ergebnis; die Aufgabe ist trotzdem erfolgreich und es wird nichts berechnet. Prüfen Sie, ob die Zahl nach /i/lists/ vollständig ist.

Ja. Fügen Sie jede Listen-URL zu urls hinzu. results_limit gilt pro Liste, drei Listen mit 100 können also bis zu 300 Posts liefern.