X Articles
X-Artikel, oft noch Twitter-Artikel genannt, sind lange Posts, die Premium-Abonnenten mit Titel, Titelbild und formatiertem Haupttext veröffentlichen; in Timelines erscheinen sie als kurze Vorschau und sammeln Likes, Antworten, Zitate und Aufrufe wie jeder andere Post. Liegen Titel, Vorschau und der gesamte Haupttext als Text neben diesen Zahlen vor, lassen sich lange Texte archivieren, zusammenfassen oder klassifizieren, und man sieht, wie Artikel gegenüber den regulären Posts eines Autors abschneiden.
Funktionen der X Articles API
- Artikel-Posts per URLSenden Sie einen oder mehrere Links zu den Tweets, die Artikel veröffentlichen, in der Form x.com/{username}/status/{post_id}, und jeder Artikel liefert eine Zeile, deren id und url zu diesem Post gehören.
- Vollständiger Haupttext als Klartexttext enthält den gesamten Artikel mit einer Leerzeile zwischen den Absätzen, bereit zum Aufteilen in Absätze oder zur Übergabe an einen Reader, einen Suchindex oder ein Sprachmodell.
- Titel, Vorschauzeile und Titelbildtitle, summary (die Vorschau, die X in Timelines zeigt) und cover_url beschreiben den Artikel so, wie Leser ihm zuerst in ihrem Feed begegnen.
- Autor und Interaktionauthor liefert Handle, Anzeigename, Avatar und Verifizierungs-Flag, metrics liefert Likes, Antworten, Zitate und Aufrufe, und published_at hält fest, wann der Artikel online ging.
Parameter der X Articles API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Eine oder mehrere X-Post-URLs in der Form /{username}/status/{post_id}, die jeweils auf den Post verweisen, der einen Artikel veröffentlicht. |
So verwenden Sie die X Articles API
Senden Sie die Links der Posts, die die Artikel enthalten, und lesen Sie dann eine Zeile pro Artikel.
- Senden Sie {"urls": ["https://x.com/USDOL/status/2119796255089947070"]} per POST an /v1/x/article.
- Fragen Sie GET /v1/tasks/{task_id} ab, bis der Status der Aufgabe succeeded lautet.
- Lesen Sie die Artikel aus results.items; solange has_more true ist, senden Sie results.next_cursor, um die nächste Seite zu erhalten.
curl -X POST "https://api.socq.ai/v1/x/article" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/USDOL/status/2119796255089947070"]}'
# text holds the whole Article, with a blank line between paragraphs.Anwendungsfälle der X Articles API
- Die langen Texte eines Autors archivieren: Speichern Sie title, text, cover_url, published_at und url für jeden Artikel, um eine durchsuchbare Kopie dessen zu behalten, was ein Konto in Langform veröffentlicht hat.
- Artikel mit einem Sprachmodell zusammenfassen: Teilen Sie text an den Leerzeilen auf und übergeben Sie die Absätze mit title als Kontext an ein Zusammenfassungstool oder Sprachmodell, um aus langen Artikeln kurze Übersichten zu machen.
- Artikel mit den regulären Posts eines Autors vergleichen: Stellen Sie views_count, likes_count und quotes_count der Artikel eines Autors denselben Zahlen seiner regulären Posts gegenüber, um zu sehen, welches Format sein Publikum liest und weitergibt.
- Einen Artikel nach der Veröffentlichung verfolgen: Fragen Sie dieselbe URL in Abständen ab und halten Sie fest, wie sich Aufrufe, Antworten und Zitate in den Tagen nach published_at entwickeln.
- Ankündigungen wörtlich zitieren: Wenn eine Behörde, ein Unternehmen oder ein Gründer eine Ankündigung als Artikel veröffentlicht, übernehmen Sie exakte Passagen aus text und zitieren Sie sie mit url und published_at.
Profi-Tipps zur X Articles API
- Wenn Sie unsicher sind, welche Posts Artikel sind, senden Sie sie in einem Batch: Nur Artikel liefern Zeilen und werden berechnet, und ein Batch, der ausschließlich aus gewöhnlichen Posts besteht, schlägt mit vollständiger Erstattung fehl.
- Zeigen Sie summary in Vorschauen und Karten und text in der Leseansicht; summary wiederholt die ersten Zeilen des Haupttexts, wer beides zusammenfügt, gibt diese Passage also doppelt aus.
- Speichern Sie jeden Artikel unter id, der ID des Posts, der ihn veröffentlicht, damit eine erneute Erfassung desselben Artikels seine gespeicherten Kennzahlen aktualisiert.
- Weisen Sie metrics.comments_count als Zahl der Antworten auf den Post des Artikels aus, wenn Sie die Interaktion mit Artikeln in ein Dashboard aufnehmen.
Verwandte APIs
Ergänzend zur X Articles 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 Profile Scraper API — Öffentliche Kontoidentität, Bios, Avatare, Titelbilder, Kontostatus und sichtbare Statistiken zur Zielgruppe per Benutzername 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 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
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API