x/
post-quotes

Öffentliche Zitat-Posts zu bekannten X-Status-URLs erfassen – mit Kommentar, Autorenidentität, Medien, Zeitstempeln, Gesprächskontext und sichtbaren Interaktionskennzahlen.

X Post Quotes API

Zitatkommentare
Kontext des Quellposts
Limits pro Post
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 Post Quotes

X Post Quotes erfasst öffentliche Zitat-Posts zu bestimmten X-Posts und liefert Autorenidentität, Zitatkommentar, Medien, Veröffentlichungszeit und sichtbare Interaktionsdaten für die Meinungsbeobachtung, die Stimmungsanalyse und die Bewertung der Verbreitung.

Funktionen der X Post Quotes API

  • Zitat-Posts ausgehend von einem QuellpostGehen Sie von einer oder mehreren öffentlichen Status-URLs aus und erfassen Sie die öffentlichen Posts, die diese Quellen zitieren, nicht aber Antworten oder reine Reposter-Profile.
  • Unabhängige Limits pro QuelleFordern Sie pro Quellpost 20 bis 2.000 Datensätze in Schritten von 20 an; jeder übergebene Status durchläuft dabei seinen eigenen Cursor des Anbieters.
  • Normalisierte KommentardatensätzeSie erhalten Zitattext, Sprache, Autorenidentität, Veröffentlichungs- und Erfassungszeitpunkt, Medien, Entitäten und sichtbare Interaktion in einer einheitlichen Struktur.
  • Quellennachweis und DeduplizierungDie übergebene URL und die ID des übergeordneten Posts bleiben in extra erhalten, während wiederholte IDs von Zitat-Posts innerhalb der Aufgabe nur einmal gespeichert werden.

Parameter der X Post Quotes API

ParameterErforderlichBeschreibung
urlsErforderlichErforderliche öffentliche Status-URLs von x.com oder twitter.com. Die unterstützten Host-Varianten müssen nach /status/ eine numerische Post-ID enthalten.
results_limitOptionalOptionales Maximum pro übergebenem Quellpost. Standard ist 100; zulässig sind Vielfache von 20 von 20 bis 2.000.

So verwenden Sie die X Post Quotes API

Senden Sie bekannte öffentliche Status-URLs, fragen Sie dann die asynchrone Aufgabe ab und blättern Sie durch ihre normalisierten Zitat-Post-Datensätze.

  1. Bereiten Sie öffentliche URLs von x.com oder twitter.com vor, deren Pfad /status/{numeric_id} enthält.
  2. Senden Sie das Array urls mit einem optionalen results_limit per POST an /v1/x/post-quotes und speichern Sie die task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe succeeded oder failed erreicht.
  4. Lesen Sie data.results.items und verwenden Sie next_cursor erneut, solange has_more den Wert true hat; dieser Ergebnis-Cursor ist von der Paginierung des Anbieters getrennt.
X_POST_URL="https://x.com/OpenAI/status/1950240351547248941"

curl -X POST "https://api.socq.ai/v1/x/post-quotes" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"urls\":[\"${X_POST_URL}\"],\"results_limit\":100}"

# Poll GET /v1/tasks/{task_id}?limit=50
# Follow data.results.next_cursor while data.results.has_more is true

Anwendungsfälle der X Post Quotes API

  • Hinzugefügte Kommentare untersuchen: Stellen Sie eine Prüfmenge dessen zusammen, was öffentliche Autoren hinzugefügt haben, als sie einen Produktstart, eine Ankündigung, einen Forschungslink oder einen Kampagnen-Post zitiert haben.
  • Öffentliche Verstärker erkennen: Vergleichen Sie Zitat-Autoren und sichtbare Interaktion, um Konten zu finden, deren Einordnung eine deutliche öffentliche Reaktion ausgelöst hat.
  • Momentaufnahmen von Zitat-Posts archivieren: Sichern Sie Kommentar, Medienverweise, Zeitstempel und Zähler zum Erfassungszeitpunkt für eine festgelegte Liste von Quellposts.

Profi-Tipps zur X Post Quotes API

  • Prüfen Sie Hostnamen und numerische /status/-ID vor dem Senden; Profil-, Such- und andere Links, die keine Status-Links sind, werden abgelehnt.
  • Planen Sie results_limit pro Quellpost und nicht pro Aufgabe: Zwei URLs mit je 100 können bis zu 200 Datensätze ergeben.
  • Rechnen Sie damit, dass dieselbe ID eines Zitat-Posts in den gespeicherten Aufgabenergebnissen nur einmal vorkommt, auch wenn mehrere übergebene Quellen zu ihr führen.
  • Verstehen Sie das angeforderte Limit als Obergrenze und nicht als Garantie für Vollständigkeit, denn gelöschte, geschützte, eingeschränkte oder von der Suche ausgeschlossene Posts können fehlen.
  • Speichern Sie die nullable Felder zu Medien, Entitäten, Gespräch und Interaktion defensiv und nutzen Sie collected_at, wenn Sie sich verändernde Zähler vergleichen.

Ergänzend zur X Post Quotes 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 Replies API — Öffentliche Antworten aus X-Post-URLs erfassen – mit wählbarer Sortierung, Antworttext, Autoren, sichtbaren Interaktionen, Medien und Kontext des übergeordneten Posts.
  • X Post Retweeters API — Eine auf Aufgabenebene eindeutige Menge normalisierter öffentlicher Profile von Konten erfassen, die bekannte X- oder Twitter-Status-URLs repostet haben.
  • 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 Post Quotes API — FAQ

X Post Quotes API ist eine Schnittstelle zum Erfassen öffentlicher Zitat-Posts, die auf bekannte X-Status-URLs verweisen. Sie liefert normalisierte Kommentare, Autoren, Interaktion, Medien, Zeitstempel und Kontext des Quellposts.

Übergeben Sie ein nicht leeres Array urls mit öffentlichen Links von x.com oder twitter.com, deren Pfad /status/ gefolgt von einer numerischen Post-ID enthält.

Die Erfassung zielt auf Zitat-Posts, die zu jedem Quellstatus zurückgegeben werden. Antworten und Konten, die die Quelle nur repostet haben, werden von separaten Ressourcen abgedeckt.

Standardmäßig gilt 100 pro übergebener Quell-URL; zulässig sind Vielfache von 20 von 20 bis 2.000. Die verfügbaren öffentlichen Ergebnisse können weniger sein als die angeforderte Obergrenze.

Die Seiten des Anbieters werden pro Quelle anhand der Post-ID dedupliziert, und beim Speichern wird dieselbe normalisierte ID eines Zitat-Posts innerhalb der Aufgabe nur einmal abgelegt.

Die Aufgabe schätzt 0,5 Credits für jedes angeforderte Ergebnis über alle übergebenen URLs, rechnet dann mit 0,5 Credits pro eindeutig gespeichertem Ergebnis ab und erstattet nicht genutzte, vorab belastete Credits.