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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Erforderliche öffentliche Status-URLs von x.com oder twitter.com. Die unterstützten Host-Varianten müssen nach /status/ eine numerische Post-ID enthalten. |
results_limit | Optional | Optionales 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.
- Bereiten Sie öffentliche URLs von x.com oder twitter.com vor, deren Pfad /status/{numeric_id} enthält.
- Senden Sie das Array urls mit einem optionalen results_limit per POST an /v1/x/post-quotes und speichern Sie die task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe succeeded oder failed erreicht.
- 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 trueAnwendungsfä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.
Verwandte APIs
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.
- Twitter Profile Scraper API
- Twitter Search API
- X Followers List API
- X Following List API
- X Trends API
- Twitter User Search API
- X Community 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 Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API