x/
mentions

Recopile los posts públicos que mencionan el identificador de un usuario, con soporte para filtrar por rango de fechas y con métricas de interacción.

Twitter Mentions API

Menciones de marca
Conversación entrante
Monitoreo de menciones
0.7 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

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ámetrosObligatorioDescripción
usernamesObligatorioLista de nombres de usuario públicos de X cuyas menciones se quieren obtener, con o sin @ inicial.
results_limitOpcionalCantidad máxima de menciones que se devuelven por nombre de usuario; debe ser un múltiplo de 20 entre 20 y 2,000.
start_dateOpcionalMarca de tiempo inicial opcional en formato ISO (YYYY-MM-DD) o en segundos Unix para filtrar las menciones desde ese momento en adelante.
end_dateOpcionalMarca 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.

  1. Indique uno o más nombres de usuario en usernames y defina results_limit como un múltiplo de 20 (hasta 2,000).
  2. Si lo desea, indique start_date y end_date para restringir el período de recopilación de menciones.
  3. Envíe una solicitud POST a /v1/x/mentions con su clave de API de SocQ.
  4. 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.

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.

Explorar otras plataformas

Combine los datos de X con datos públicos de otras plataformas sociales compatibles.

Twitter Mentions API — FAQ

Twitter Mentions API recopila los posts públicos que mencionan los identificadores de usuario indicados en X. Devuelve datos normalizados de los posts, información de los autores, marcas de tiempo y métricas de interacción dentro de límites de fechas opcionales.

No. El endpoint consulta menciones de acceso público usando únicamente nombres de usuario públicos; no se requieren OAuth de la cuenta del cliente ni tokens de inicio de sesión del usuario.

El proveedor de datos de origen entrega las menciones en páginas discretas de 20 elementos cada una, por lo que las solicitudes deben ajustarse a ese incremento de lote.