X Post Replies
X Post Replies sind öffentliche Antworten innerhalb eines Gesprächs zu einem Post und enthalten Text, Autorenidentität, Sprache, Medien, sichtbare Interaktion, Veröffentlichungszeit und Verknüpfungen zu übergeordneten oder verwandten Posts. Diese Gesprächsdatensätze unterstützen die Analyse von Reaktionen, die Rekonstruktion von Threads, das Monitoring von Antworten und die Vorbereitung von Datensätzen für die Triage.
Funktionen der X Post Replies API
- Gesprächsumfang bekannter PostsNimmt eine oder mehrere öffentliche X-Status-URLs entgegen, extrahiert jede numerische Post-ID und liefert die Antworten, wobei der übergebene übergeordnete Post selbst ausgeschlossen bleibt.
- Antwort- und AutorendatensätzeLiefert für jede gespeicherte Antwort die Antwort-ID, kanonische URLs, Text, Sprache, Veröffentlichungszeiten und die normalisierte öffentliche Autorenidentität.
- Sichtbare ReaktionssignaleBehält die öffentlichen Zahlen zu Likes, Antworten, Reposts, Zitaten, Aufrufen und Lesezeichen zusammen mit Medien, Hashtags und Erwähnungen bei.
- Wählbare Sortierung der TimelineFordern Sie für jeden übergebenen Post die Sortierung nach Relevanz, nach Aktualität oder nach Likes an und wenden Sie dabei auf jedes Gespräch ein eigenes Ergebnislimit an.
- Nachvollziehbarkeit des GesprächsBewahrt die übergebene URL, die ID des übergeordneten Posts, die Gesprächs-ID, das Antwortziel sowie Signale zu Quelle, Zitat, Repost und eingeschränkten Antworten im normalisierten Kontext.
Parameter der X Post Replies API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Erforderliches Array öffentlicher Post-URLs von x.com oder twitter.com. Jeder Pfad muss /status/{numeric_id} enthalten; die Host-Varianten www, m und mobile werden akzeptiert. |
results_limit | Optional | Maximale Anzahl der Antworten, die pro übergeordnetem Post angefordert werden. Standard ist 100; zulässig sind Vielfache von 20 von 20 bis 2000. |
sort_by | Optional | Sortierung der Antwort-Timeline für jeden übergebenen Post: relevance, latest oder likes. Standard ist relevance. |
So verwenden Sie die X Post Replies API
Senden Sie bekannte öffentliche Post-URLs als asynchrone Aufgabe und lesen Sie anschließend die normalisierten Antwortdatensätze aus der abgeschlossenen Aufgabe.
- Bereiten Sie eine oder mehrere öffentliche URLs von x.com oder twitter.com mit einer numerischen /status/{id} vor und wählen Sie die Sortierung nach relevance, latest oder likes.
- Senden Sie urls, ein results_limit pro Post von 20 bis 2000 in Schritten von 20 und sort_by per POST an /v1/x/post-replies.
- Behalten Sie die zurückgegebene task_id und fragen Sie GET /v1/tasks/{task_id} ab, solange die Aufgabe queued, running oder retrying ist.
- Lesen Sie nach einem Erfolg data.results.items und fragen Sie dieselbe Aufgabe mit cursor=data.results.next_cursor ab, solange data.results.has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/x/post-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/OpenAI/status/1950240351547248941"],"results_limit":100,"sort_by":"relevance"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and pass data.results.next_cursor as cursor while has_more is trueAnwendungsfälle der X Post Replies API
- Analyse öffentlicher Reaktionen: Vergleichen Sie Antworttext, Sprache, Autoren und sichtbare Interaktion über ausgewählte übergeordnete Posts hinweg, um zu untersuchen, wie sich öffentliche Gespräche unterscheiden.
- Rekonstruktion von Gesprächs-Threads: Verwenden Sie parent_post_id, conversation_id, die in_reply_to-Felder, Antwort-IDs und kanonische URLs, um gespeicherte Antworten wieder mit ihrem sichtbaren Thread-Kontext zu verbinden.
- Monitoring von Antworten über mehrere Erfassungsläufe: Verfolgen Sie Veröffentlichungszeiten der Antworten, collected_at, Autoren und öffentliche Zähler für eine feste Menge von Post-URLs über geplante Momentaufnahmen hinweg.
- Vorbereitung von Datensätzen für die manuelle Triage: Kombinieren Sie Antworttext, Autorenidentität, Zeitstempel, URLs und sichtbare Interaktion, um Antwortdatensätze für nachgelagerte Prüfwarteschlangen vorzubereiten.
Profi-Tipps zur X Post Replies API
- Prüfen Sie vor dem Senden jede URL auf einen akzeptierten X- oder Twitter-Host und eine numerische /status/-ID, damit Profil- und Such-Links keine fehlgeschlagenen Aufgaben erzeugen.
- Extrahieren Sie die numerische Status-ID und deduplizieren Sie sie über die URL-Varianten von x.com und twitter.com hinweg, denn verschiedene URL-Zeichenfolgen können auf denselben übergeordneten Post zeigen.
- Legen Sie results_limit pro übergeordnetem Post in Schritten von 20 fest; die Gesamtzahl möglicher Kandidaten kann sich urls × results_limit nähern, bevor Gesprächsenden und die Deduplizierung innerhalb der Aufgabe greifen.
- Wählen Sie sort_by passend zum Erfassungsziel, vergleichen Sie Positionen aber nicht über die Modi relevance, latest und likes hinweg als gemeinsamen Ranking-Wert.
- Berücksichtigen Sie beim Rekonstruieren vieler übergeordneter Gespräche die Deduplizierung von Antworten innerhalb der Aufgabe, denn eine gespeicherte Antwort behält nur eine übergebene URL und einen Kontext des übergeordneten Posts.
- Verstehen Sie ein kurzes oder leeres Ergebnis als Folge der öffentlichen Sichtbarkeit und speichern Sie nullable Felder zu Autor, Medien, Kennzahlen und Beziehungen, ohne Platzhalter zu erfinden.
Verwandte APIs
Ergänzend zur X Post Replies 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.
- Twitter Search API — Öffentliche Posts per Suchausdruck finden – mit Sortierung nach neuesten oder beliebtesten Posts und konfigurierbarem Ergebnislimit.
- X Post Quotes API — Öffentliche Zitat-Posts zu bekannten Status-URLs erfassen – mit Kommentar, Autoren, Interaktionen, Medien, Zeitstempeln und Kontext des Quell-Posts.
- X User Replies API — Die Antworten eines Kontos erfassen – jeweils mit dem Post, auf den sie sich beziehen.
- X Followers List API
- X Following List API
- X Post Retweeters API
- X Trends API
- Twitter Mentions 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 Articles API
- X Spaces API
- Twitter Media Scraper API
- Twitter Follow Checker API
- Twitter Video Transcript API