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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Öffentliche X-Listen-URLs in der Form https://x.com/i/lists/<numeric id>. Die Timeline jeder Liste wird separat erfasst. |
results_limit | Optional | Anzahl 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.
- Senden Sie {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100} per POST an /v1/x/list-posts.
- Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat.
- 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.
Verwandte APIs
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.
- Twitter Profile Scraper API
- Twitter Search API
- X Followers List API
- X Following List API
- X Post Retweeters API
- X Trends API
- Twitter User Search API
- X Community API
- X Community Posts API
- X Thread Context API
- X Account Location API
- X Verified Followers 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