Twitter Mentions
Monitorare le menzioni pubbliche rivela la percezione del brand, le richieste dei clienti e le conversazioni in entrata su X. I record normalizzati delle menzioni raccolgono testo dei post, handle degli autori, timestamp, media allegati e contatori pubblici di engagement, senza autenticazione sulla piattaforma.
Funzionalità della Twitter Mentions API
- Monitoraggio delle menzioni pubblicheRecupera i tweet pubblici che menzionano qualsiasi nome utente di destinazione, senza richiedere le credenziali di accesso dell’account di destinazione.
- Delimitazione della finestra di dateLimita i feed delle menzioni con i filtri start_date ed end_date in formato data ISO o secondi Unix.
- Dettagli di autore e tweetRicevi record di post normalizzati con testo completo del tweet, profili degli autori, media allegati e permalink.
- Metriche di engagementEstrai i conteggi di Mi piace, commenti, repost, citazioni, segnalibri e visualizzazioni per ogni menzione trovata.
Parametri della Twitter Mentions API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
usernames | Obbligatorio | Array di nomi utente pubblici di X di destinazione per cui recuperare le menzioni, con o senza @ iniziale. |
results_limit | Facoltativo | Numero massimo di menzioni da restituire per nome utente; deve essere un multiplo di 20 tra 20 e 2.000. |
start_date | Facoltativo | Timestamp iniziale facoltativo in formato ISO (YYYY-MM-DD) o in secondi Unix per filtrare le menzioni a partire da questo momento. |
end_date | Facoltativo | Timestamp finale facoltativo in formato ISO (YYYY-MM-DD) o in secondi Unix per filtrare le menzioni precedenti a questo momento. |
Come usare la Twitter Mentions API
Invia un nome utente di destinazione e un intervallo di date facoltativo come attività asincrona, poi interroga l’attività per ottenere i record delle menzioni.
- Indica uno o più nomi utente in usernames e imposta results_limit su un multiplo di 20 (fino a 2.000).
- Se vuoi, fornisci start_date ed end_date per limitare il periodo di raccolta delle menzioni.
- Invia una richiesta POST a /v1/x/mentions con la tua chiave API SocQ.
- Interroga /v1/tasks/{task_id} e scorri data.results.items con next_cursor.
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.Casi d’uso della Twitter Mentions API
- Monitoraggio della reputazione del brand: Segui in tempo quasi reale le menzioni in entrata, le recensioni e il sentiment intorno all’handle della tua azienda.
- Smistamento dell’assistenza clienti: Individua reclami dei clienti, bug del prodotto o feedback rivolti ai tuoi account di assistenza a cui non è stata ancora data risposta.
- Ascolto della presenza dei dirigenti: Monitora le menzioni e le risposte rivolte agli account della dirigenza per valutare la reazione del settore agli annunci.
Consigli degli esperti per la Twitter Mentions API
- results_limit deve essere un multiplo di 20 (per esempio 20, 40, 100) per corrispondere alle dimensioni di pagina a monte.
- Le stringhe di data ISO come 2026-09-01 vengono convertite automaticamente dal backend in timestamp Unix UTC.
- Questo endpoint restituisce i tweet che menzionano l’account; per ottenere i post in uscita dell’account stesso, usa X User Posts.
- Abbinalo a X Post Replies per seguire in dettaglio le conversazioni che partono dai tweet di menzione più significativi.
API correlate
Oltre alla Twitter Mentions API, usa queste API quando ti serve un altro tipo di dati pubblici di X.
- Twitter Tweet Scraper API — Recupera testo dei post pubblici, autori, engagement, media, hashtag, menzioni e relazioni della conversazione dagli URL di stato di x.com o twitter.com.
- Twitter Profile Scraper API — Recupera identità dell’account pubblico, bio, avatar, immagini di copertina, stato dell’account e statistiche visibili del pubblico a partire dal nome utente.
- Twitter User Tweets Scraper API — Raccoglie i post pubblici recenti, autori, media, hashtag, menzioni ed engagement a partire dal nome utente, escludendo le risposte.
- X Post Quotes API — Raccoglie le citazioni pubbliche di URL di stato noti con commento, autori, engagement, media, date e contesto del post di origine.
- X Community Posts API — Leggi i post pubblici condivisi in una community, con testo, autori e conteggi delle interazioni.
- X Thread Context API — Leggi un post con i messaggi precedenti della catena di risposte, le risposte pubbliche e gli ID delle relazioni.
- 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