x/
thread-context

Den Kontext rund um einen X-Post über dessen Link lesen – mit dem Ziel-Post, den früheren Posts, auf die er antwortet, und öffentlichen Antworten samt Beziehungs-IDs in einem Ergebnis.

X Thread Context API

Der Post und sein Kontext
Welcher Post auf welchen antwortet
Gruppierung von Gesprächen
0,5 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 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

ParameterErforderlichBeschreibung
urlsErforderlichErforderliche 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_limitOptionalOptionale 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.

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.

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.

Weitere Plattformen entdecken

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

X Thread Context API — FAQ

X Thread Context API ist eine Schnittstelle zum Abrufen des öffentlichen Diskussionskontexts aus X-Post-Links. Sie liefert den Ziel-Post, frühere Posts entlang seiner Antwortkette, verfügbare Antworten und Beziehungs-IDs, die zeigen, wie die zurückgegebenen Posts zusammenhängen.

Das Ziel ist der Post, dessen Link Sie senden. Frühere Posts, manchmal Vorgänger genannt, sind Nachrichten, die man erreicht, indem man den Antwortbeziehungen des Ziels rückwärts folgt, und nicht jeder Post, der davor veröffentlicht wurde.

Wenn A einen Post veröffentlicht und B auf A antwortet, enthält die in_reply_to_id von B die Post-ID von A. conversation_id fasst Posts zum selben Gespräch zusammen, während in_reply_to_id die direkte Antwortverknüpfung benennt; antwortet C auf B, verweist C auf B und nicht direkt auf A.

Thread Context umfasst neben den Antworten auch den ausgewählten Post und öffentliche frühere Posts entlang seiner Antwortkette. X Post Replies konzentriert sich auf Antworten auf den übergebenen Post und passt daher zu einer engeren Aufgabe, bei der nur Antworten erfasst werden.

Nein. Das Limit und die öffentliche Sichtbarkeit können Lücken hinterlassen, und eine Beziehungs-ID kann auf einen Post verweisen, der in Ihren Ergebnissen nicht enthalten ist. Bewahren Sie die verfügbaren Verknüpfungen, ohne fehlende Nachrichten oder deren Bedeutung zu unterstellen.

Nein. Der Cursor liest eine weitere Seite von Datensätzen, die diese Aufgabe bereits gespeichert hat; er startet keine weitere Erfassung und erhöht auch nicht das ursprüngliche Ergebnislimit.

Jeder zurückgegebene Post-Datensatz kostet 0,5 Credits, ohne Grundgebühr. Zwei Links mit einem Limit von 100 ergeben eine Schätzung von 100 Credits; liefert die Aufgabe insgesamt 30 Posts, beträgt die endgültige Abrechnung 15 Credits.