Twitter Mentions
Seguir las menciones públicas revela la percepción de una marca, las consultas de los clientes y la conversación entrante en X. Los registros de menciones normalizados capturan el texto del post, los identificadores de los autores, las marcas de tiempo, los archivos multimedia adjuntos y los contadores públicos de interacción, sin autenticación en la plataforma.
Funcionalidades de la Twitter Mentions API
- Seguimiento de menciones públicasObtenga los posts públicos que mencionan a cualquier nombre de usuario, sin necesitar las credenciales de acceso de la cuenta consultada.
- Ventana de fechas acotadaLimite los flujos de menciones con los filtros start_date y end_date, en formato de fecha ISO o en segundos Unix.
- Detalle del autor y del postReciba registros de posts normalizados con el texto completo del post, los perfiles de los autores, los archivos multimedia adjuntos y los enlaces permanentes.
- Métricas de interacciónExtraiga los conteos de Me gusta, comentarios, reposts, citas, guardados y vistas de cada mención encontrada.
Parámetros de la Twitter Mentions API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
usernames | Obligatorio | Lista de nombres de usuario públicos de X cuyas menciones se quieren obtener, con o sin @ inicial. |
results_limit | Opcional | Cantidad máxima de menciones que se devuelven por nombre de usuario; debe ser un múltiplo de 20 entre 20 y 2,000. |
start_date | Opcional | Marca de tiempo inicial opcional en formato ISO (YYYY-MM-DD) o en segundos Unix para filtrar las menciones desde ese momento en adelante. |
end_date | Opcional | Marca de tiempo final opcional en formato ISO (YYYY-MM-DD) o en segundos Unix para filtrar las menciones anteriores a ese momento. |
Cómo usar la Twitter Mentions API
Envíe un nombre de usuario y un rango de fechas opcional como tarea asíncrona y consulte después los registros de menciones.
- Indique uno o más nombres de usuario en usernames y defina results_limit como un múltiplo de 20 (hasta 2,000).
- Si lo desea, indique start_date y end_date para restringir el período de recopilación de menciones.
- Envíe una solicitud POST a /v1/x/mentions con su clave de API de SocQ.
- Consulte /v1/tasks/{task_id} y recorra data.results.items por páginas 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.Casos de uso de la Twitter Mentions API
- Monitoreo de la reputación de marca: Siga las menciones entrantes, las reseñas y el sentimiento en torno al identificador de su empresa casi en tiempo real.
- Clasificación de solicitudes de soporte: Identifique quejas de clientes, errores del producto o comentarios dirigidos a sus cuentas de soporte que aún no se han atendido.
- Escucha de la presencia de directivos: Monitoree las menciones y respuestas dirigidas a las cuentas de la dirección para evaluar la reacción del sector ante los anuncios.
Consejos de expertos para la Twitter Mentions API
- results_limit debe ser un múltiplo de 20 (por ejemplo 20, 40 o 100) para coincidir con el tamaño de página del origen.
- El backend convierte automáticamente las fechas ISO como 2026-09-01 a marcas de tiempo Unix en UTC.
- Este endpoint devuelve los posts que mencionan a la cuenta; para obtener los posts publicados por la propia cuenta, use X User Posts.
- Combínelo con X Post Replies para seguir los hilos de conversación detallados que se derivan de posts de mención importantes.
APIs relacionadas
Además de la Twitter Mentions API, use estas APIs cuando necesite otro tipo de datos públicos de X.
- Twitter Tweet Scraper API — Obtiene el texto de posts públicos, autores, interacción, contenido multimedia, hashtags, menciones y relaciones de conversación desde URLs de estado de x.com o twitter.com.
- Twitter Profile Scraper API — Obtiene por nombre de usuario la identidad de la cuenta pública, biografías, avatares, imágenes de portada, estado de la cuenta y estadísticas visibles de audiencia.
- Twitter User Tweets Scraper API — Recolecta posts públicos recientes, autores, contenido multimedia, hashtags, menciones e interacción por nombre de usuario, sin incluir respuestas.
- X Post Quotes API — Recolecta posts públicos con cita de URLs de estado conocidas, con comentario, autores, interacción, contenido multimedia, marcas de tiempo y contexto del post de origen.
- X Community Posts API — Lee los posts públicos compartidos en una comunidad, con su texto, autores y conteos de interacción.
- X Thread Context API — Lee un post junto con los mensajes anteriores de su cadena de respuestas, las respuestas públicas y los IDs de relación.
- 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