X Thread Context
Ein X-Thread verbindet einen Post mit der Nachricht, auf die er antwortet, mit früheren Nachrichten entlang dieser Antwortkette und mit den Antworten, die folgen, statt einfach Posts zu gruppieren, die um dieselbe Zeit veröffentlicht wurden. Werden diese Beziehungen zusammen mit Posttext und Autorenangaben festgehalten, lässt sich nachvollziehen, wie sich eine Diskussion entwickelt hat, und der Kontext einer einzelnen Nachricht besser verstehen.
Funktionen der X Thread Context API
- Den ausgewählten Post mit der Diskussion um ihn herum lesenErfassen Sie über einen Post-Link die Zielnachricht zusammen mit früheren öffentlichen Nachrichten entlang ihrer Antwortkette und den verfügbaren Antworten, die folgen, und erhalten Sie so Kontext über die ausgewählte Nachricht hinaus.
- Verstehen, welche Posts zusammengehören und wer wem antwortetNeben Text, Autoren und Interaktionszahlen gibt conversation_id an, zu welchem Gespräch ein Post gehört, und in_reply_to_id nennt den Post, auf den er direkt antwortet. So erhalten Sie Verknüpfungen zwischen den einzelnen Datensätzen.
Parameter der X Thread Context API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Erforderliche Liste öffentlicher X-Post-Links, die /status/ gefolgt von einer numerischen Post-ID enthalten, zum Beispiel https://x.com/BaganiTohid/status/2110635249889919362. Tragen Sie im Playground einen Link pro Zeile ein oder verwenden Sie ein JSON-Array urls, und geben Sie keine Profil- oder Community-Links an. |
results_limit | Optional | Optionale maximale Anzahl Kontextdatensätze für jeden Eingabe-Post, von 1 bis 2.000, Standard ist 100. Bei zwei Post-Links mit einem Limit von je 20 werden jeweils bis zu 20 verwandte Datensätze angefordert, und die 20 sind keine gemeinsame Gesamtzahl. |
So verwenden Sie die X Thread Context 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 den öffentlichen Post-Link, den Sie verstehen möchten, und legen Sie fest, wie viele Kontextdatensätze dafür angefordert werden; bei mehreren Links tragen Sie jeden in die Liste urls ein.
- 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/thread-context 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 Post und seine verfügbaren Gesprächsbeziehungen. 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/thread-context" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/BaganiTohid/status/2110635249889919362"],"results_limit":20}'Anwendungsfälle der X Thread Context API
- Eine Nachricht mit dem Kontext prüfen, der zum Verständnis nötig ist: Stellen Sie den Ziel-Post neben die zurückgegebenen früheren Nachrichten und Antworten samt Text und Autoren, um eine Leseansicht für jemanden vorzubereiten, der prüft, worauf die ausgewählte Nachricht reagiert hat.
- Eine Karte der zurückgegebenen Antwortbeziehungen aufbauen: Gruppieren Sie Posts nach conversation_id und ordnen Sie jede in_reply_to_id der id eines anderen Datensatzes zu, um die vorhandenen Antwortverknüpfungen zu zeichnen. Lücken bleiben sichtbar, wenn ein referenzierter Post nicht zurückgegeben wurde.
- Quellenmaterial für eine Gesprächszusammenfassung vorbereiten: Speichern Sie Posttext, Autorennamen, Zeiten und Antwortbeziehungen als geordnete Lesemenge für einen separaten Zusammenfassungsschritt durch Menschen oder Software, statt eine fertige Zusammenfassung in der Antwort zu erwarten.
Profi-Tipps zur X Thread Context API
- Verbinden Sie beim Anordnen einer Diskussion zum Lesen die Posts zuerst über ihre Beziehungs-IDs und nutzen Sie die Veröffentlichungszeit nur als zusätzlichen Kontext, denn eine nach Zeit sortierte Liste allein verrät nicht, auf welche Nachricht jeder Post antwortet.
- Verweist in_reply_to_id auf eine ID, die in Ihren gespeicherten Datensätzen fehlt, behalten Sie diesen Verweis als fehlende Verknüpfung bei, statt die Antwort an einen anderen Post zu hängen oder den fehlenden Text zu erfinden.
- Gehören mehrere übergebene Links zum selben Gespräch, führen Sie die gespeicherten Ergebnisse anhand der Post-ID zusammen, damit ein gemeinsamer früherer Post nicht mehrfach in Ihrer Lesemenge auftaucht.
- Brauchen Sie nur die Antworten auf einen ausgewählten Post, verwenden Sie X Post Replies; brauchen Sie nur den ausgewählten Post selbst, verwenden Sie X Posts, statt den umgebenden Kontext zu erfassen.
Verwandte APIs
Ergänzend zur X Thread Context 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.
- X Community Posts API — Die in einer Community geteilten öffentlichen Posts auslesen – mit Text, Autoren und Interaktionszahlen.
- 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 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 Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API