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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
usernames | Erforderlich | Array öffentlicher Ziel-Benutzernamen auf X, für die Erwähnungen abgerufen werden, mit oder ohne führendes @. |
results_limit | Optional | Maximale Anzahl der Erwähnungen, die pro Benutzername zurückgegeben werden; muss ein Vielfaches von 20 zwischen 20 und 2.000 sein. |
start_date | Optional | Optionaler Startzeitpunkt im ISO-Format (YYYY-MM-DD) oder in Unix-Sekunden, um Erwähnungen ab diesem Zeitpunkt zu filtern. |
end_date | Optional | Optionaler 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.
- Geben Sie in usernames einen oder mehrere Benutzernamen an und setzen Sie results_limit auf ein Vielfaches von 20 (bis zu 2.000).
- Geben Sie optional start_date und end_date an, um den Erfassungszeitraum der Erwähnungen einzuschränken.
- Senden Sie mit Ihrem SocQ-API-Schlüssel eine POST-Anfrage an /v1/x/mentions.
- 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.
Verwandte APIs
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.
- Twitter Search API
- X Followers List API
- X Following List API
- X Post Replies API
- X Post Retweeters API
- X Trends API
- Twitter User Search API
- X Community 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