x/
mentions

Öffentliche Posts erfassen, die ein bestimmtes Benutzer-Handle erwähnen – mit Filter für den Zeitraum und Interaktionskennzahlen.

Twitter Mentions API

Markenerwähnungen
Eingehende Gespräche
Monitoring von Erwähnungen
0,7 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

Twitter Mentions

Wer öffentliche Erwähnungen verfolgt, erkennt die Markenwahrnehmung, Kundenanfragen und eingehende Gespräche auf X. Normalisierte Erwähnungsdatensätze enthalten Posttext, Autoren-Handles, Zeitstempel, Medienanhänge und öffentliche Interaktionszähler, ganz ohne Authentifizierung bei der Plattform.

Funktionen der Twitter Mentions API

  • Verfolgung öffentlicher ErwähnungenRufen Sie öffentliche Posts ab, die einen beliebigen Ziel-Benutzernamen erwähnen, ohne dass die Zugangsdaten des Zielkontos nötig sind.
  • Begrenzung auf ein ZeitfensterGrenzen Sie Erwähnungs-Feeds mit den Filtern start_date und end_date ein, angegeben als ISO-Datum oder in Unix-Sekunden.
  • Details zu Autor und PostSie erhalten normalisierte Post-Datensätze mit vollständigem Posttext, Autorenprofilen, Medienanhängen und Permalinks.
  • InteraktionskennzahlenErfassen Sie für jede gefundene Erwähnung die Zahl der Likes, Kommentare, Reposts, Zitate, Lesezeichen und Aufrufe.

Parameter der Twitter Mentions API

ParameterErforderlichBeschreibung
usernamesErforderlichArray öffentlicher Ziel-Benutzernamen auf X, für die Erwähnungen abgerufen werden, mit oder ohne führendes @.
results_limitOptionalMaximale Anzahl der Erwähnungen, die pro Benutzername zurückgegeben werden; muss ein Vielfaches von 20 zwischen 20 und 2.000 sein.
start_dateOptionalOptionaler Startzeitpunkt im ISO-Format (YYYY-MM-DD) oder in Unix-Sekunden, um Erwähnungen ab diesem Zeitpunkt zu filtern.
end_dateOptionalOptionaler Endzeitpunkt im ISO-Format (YYYY-MM-DD) oder in Unix-Sekunden, um Erwähnungen vor diesem Zeitpunkt zu filtern.

So verwenden Sie die Twitter Mentions API

Senden Sie einen Ziel-Benutzernamen und einen optionalen Zeitraum als asynchrone Aufgabe und fragen Sie anschließend die Erwähnungsdatensätze ab.

  1. Geben Sie in usernames einen oder mehrere Benutzernamen an und setzen Sie results_limit auf ein Vielfaches von 20 (bis zu 2.000).
  2. Geben Sie optional start_date und end_date an, um den Erfassungszeitraum der Erwähnungen einzuschränken.
  3. Senden Sie mit Ihrem SocQ-API-Schlüssel eine POST-Anfrage an /v1/x/mentions.
  4. Fragen Sie /v1/tasks/{task_id} ab und blättern Sie mit next_cursor durch data.results.items.
curl -X POST "https://api.socq.ai/v1/x/mentions" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["@OpenAI"],"results_limit":20}'

# Poll GET /v1/tasks/{task_id}, then fetch data.results.items.

Anwendungsfälle der Twitter Mentions API

  • Monitoring des Markenrufs: Verfolgen Sie eingehende Erwähnungen, Bewertungen und die Stimmung rund um das Handle Ihres Unternehmens nahezu in Echtzeit.
  • Triage im Kundensupport: Erkennen Sie unbeantwortete Kundenbeschwerden, Produktfehler oder Rückmeldungen, die an Ihre Support-Konten gerichtet sind.
  • Beobachtung der Präsenz der Führungsebene: Überwachen Sie Erwähnungen und Antworten an Konten der Führungsebene, um die Resonanz der Branche auf Ankündigungen einzuschätzen.

Profi-Tipps zur Twitter Mentions API

  • results_limit muss ein Vielfaches von 20 sein (zum Beispiel 20, 40, 100), damit es zu den Seitengrößen der vorgelagerten Quelle passt.
  • ISO-Datumsangaben wie 2026-09-01 werden vom Backend automatisch in Unix-Zeitstempel in UTC umgewandelt.
  • Dieser Endpunkt liefert Posts, die das Konto erwähnen; für die eigenen ausgehenden Posts des Kontos verwenden Sie X User Posts.
  • Kombinieren Sie ihn mit X Post Replies, um detaillierte Gesprächsverläufe zu verfolgen, die von wichtigen Erwähnungs-Posts ausgehen.

Ergänzend zur Twitter Mentions 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.
  • X Post Quotes API — Öffentliche Zitat-Posts zu bekannten Status-URLs erfassen – mit Kommentar, Autoren, Interaktionen, Medien, Zeitstempeln und Kontext des Quell-Posts.
  • X Community Posts API — Die in einer Community geteilten öffentlichen Posts auslesen – mit Text, Autoren und Interaktionszahlen.
  • X Thread Context API — Einen Post zusammen mit früheren Nachrichten der Antwortkette, öffentlichen Antworten und Beziehungs-IDs auslesen.

Weitere Plattformen entdecken

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

Twitter Mentions API — FAQ

Twitter Mentions API erfasst öffentliche Posts, die bestimmte Benutzer-Handles auf X erwähnen. Sie liefert normalisierte Postdaten, Autoreninformationen, Zeitstempel und Interaktionskennzahlen innerhalb optionaler Zeitgrenzen.

Nein. Der Endpunkt fragt öffentlich zugängliche Erwähnungen allein anhand öffentlicher Benutzernamen ab; weder OAuth des Kundenkontos noch Anmelde-Token des Benutzers sind erforderlich.

Der vorgelagerte Datenanbieter liefert Erwähnungen in einzelnen Seiten mit je 20 Einträgen, daher müssen die Anfragen zu diesem Stapelschritt passen.