x/
mentions

Raccogli i tweet pubblici che menzionano l’handle di un utente di destinazione, con filtro per intervallo di date e metriche di engagement.

Twitter Mentions API

Menzioni del brand
Conversazioni in entrata
Monitoraggio delle menzioni
0,7 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

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

ParametriObbligatorioDescrizione
usernamesObbligatorioArray di nomi utente pubblici di X di destinazione per cui recuperare le menzioni, con o senza @ iniziale.
results_limitFacoltativoNumero massimo di menzioni da restituire per nome utente; deve essere un multiplo di 20 tra 20 e 2.000.
start_dateFacoltativoTimestamp iniziale facoltativo in formato ISO (YYYY-MM-DD) o in secondi Unix per filtrare le menzioni a partire da questo momento.
end_dateFacoltativoTimestamp 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.

  1. Indica uno o più nomi utente in usernames e imposta results_limit su un multiplo di 20 (fino a 2.000).
  2. Se vuoi, fornisci start_date ed end_date per limitare il periodo di raccolta delle menzioni.
  3. Invia una richiesta POST a /v1/x/mentions con la tua chiave API SocQ.
  4. 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.

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.

Esplora altre piattaforme

Combina i dati di X con i dati pubblici delle altre piattaforme social supportate.

Twitter Mentions API — FAQ

Twitter Mentions API raccoglie i tweet e i post pubblici che menzionano gli handle utente specificati su X. Restituisce dati normalizzati dei post, informazioni sull’autore, timestamp e metriche di engagement entro limiti di date facoltativi.

No. L’endpoint interroga le menzioni accessibili pubblicamente usando solo nomi utente pubblici; non servono OAuth dell’account del cliente né token di accesso dell’utente.

Il provider di dati a monte consegna le menzioni in pagine distinte di 20 elementi ciascuna, quindi le richieste devono rispettare questo incremento del batch.