Metrics
Métricas de X (Twitter) con la API
Tu cliente conecta su cuenta de X (Twitter) y tu producto consulta 17 métricas por el mismo endpoint que las demás plataformas. Cada métrica tiene un identificador (reference_key) que va en la llamada.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"comparison_start": "2026-09-01",
"comparison_end": "2026-09-30",
"metrics": [
{
"id": "m1",
"reference_key": "twitter:followers_count",
"component": "number_v1",
"metrics": [
"followers_count"
],
"dimensions": [
"user"
]
}
]
}Más ejemplos de llamadas a X (Twitter)
El mismo endpoint para cada tipo de métrica. Los campos metrics y dimensions de cada ítem vienen del catálogo de la plataforma (GET /api/metrics/{integration_slug}).
Gráfico
Compromiso total a lo largo del tiempo
Este gráfico muestra el número total de interacciones diarias recibidas por sus tweets publicados durante el período de análisis. Esto incluye todos los clics en cualquier parte del Tweet (incluidos los enlaces, el avatar y el nombre de usuario), los retweets, las citas, las respuestas y los Me gusta. Esta métrica no tiene en cuenta los seguimientos, los clics en hashtags ni las expansiones de tweets.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "twitter:total_engagement_over_time",
"component": "chart_v1",
"metrics": [
"total_engagement_over_time"
],
"dimensions": [
"tweets"
]
}
]
}Tabla
Tuits destacados
Resumen de rendimiento de los Tweets publicados durante el período de revisión.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "twitter:featured_tweets",
"component": "datatable_v1",
"metrics": [
"tweets_impression",
"tweets_engagement",
"tweets_epi",
"tweets_likes",
"tweets_replies",
"tweets_retweets",
"tweets_clicks",
"profile_clicks",
"created_at"
],
"dimensions": [
"tweets"
]
}
]
}Número
Tweets
Número total de tweets realizados en su cuenta, en el período analizado. Esta métrica no incluye las respuestas a los tweets.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "twitter:only_tweets_count",
"component": "number_v1",
"metrics": [
"only_tweet_count"
],
"dimensions": [
"tweets"
]
}
]
}Números
10 métricas
Número de seguidores
Número total de seguidores en su cuenta
twitter:followers_countTweets
Número total de tweets realizados en su cuenta, en el período analizado. Esta métrica no incluye las respuestas a los tweets.
twitter:only_tweets_countTweets totales
Número total de tweets realizados en su cuenta durante el período analizado. Esta métrica considera las respuestas a los Tweets.
twitter:total_tweets_countImpresiones Totales
Número total de vistas de sus Tweets publicados durante el período de revisión.
twitter:total_impressions_countImpresiones de tuits
Número de veces que un usuario recibió un Tweet, publicado durante el período de análisis, en la línea de tiempo o en los resultados de búsqueda. Esta métrica no considera las respuestas a los Tweets.
twitter:tweets_impressions_countTotal de interacción
Número total de veces que los usuarios interactuaron con un tweet publicado durante el período de análisis. Esto incluye todos los clics en cualquier parte del Tweet (incluidos los enlaces, el avatar y el nombre de usuario), los retweets, las citas, las respuestas y los Me gusta. Esta métrica no tiene en cuenta los seguimientos, los clics en hashtags ni las expansiones de tweets.
twitter:total_engagementEngajamentos dos Tweets
Número de veces que un usuario interactuó con un Tweet (clics, retweets, respuestas, citas y me gusta) durante el período analizado. Esta métrica no tiene en cuenta las interacciones en las respuestas.
twitter:tweets_engagementTasa de participación
El número de interacciones (clics, retweets, respuestas, citas y me gusta) dividido por el número total de impresiones.
twitter:total_engagement_rateTasa de compromiso de los tweets
El número total de compromisos de los Tweets (clics, retweets, respuestas, citas y me gusta) dividido por el número total de impresiones. Esta métrica no considera las interacciones en las respuestas.
twitter:tweets_engagement_rateMenciones
Número total de veces que se mencionó su cuenta durante el período de revisión.
twitter:mentions
Gráficos
6 métricas
Compromiso total a lo largo del tiempo
Este gráfico muestra el número total de interacciones diarias recibidas por sus tweets publicados durante el período de análisis. Esto incluye todos los clics en cualquier parte del Tweet (incluidos los enlaces, el avatar y el nombre de usuario), los retweets, las citas, las respuestas y los Me gusta. Esta métrica no tiene en cuenta los seguimientos, los clics en hashtags ni las expansiones de tweets.
twitter:total_engagement_over_timeCompromiso de los Tweets durante el tiempo
Este gráfico muestra la cantidad de interacciones diarias recibidas por sus tweets publicados durante el período de análisis. El compromiso incluye clics, retweets, respuestas, citas y me gusta, pero no considera las interacciones en las respuestas.
twitter:tweets_engagement_over_timeImpresiones totales de tweets a lo largo del tiempo
Este gráfico muestra el número total de vistas de sus Tweets publicados durante el período de análisis.
twitter:total_impressions_over_timeImpresiones de los Tweets durante el tiempo
Este gráfico muestra la cantidad de veces que un usuario recibió un Tweet publicado durante el período de análisis, ya sea en la línea de tiempo o en los resultados de búsqueda. No se tienen en cuenta las respuestas a los Tweets.
twitter:tweets_impressions_over_timeTasa de compromiso de los tweets durante el tiempo
Este gráfico muestra cómo la tasa de compromiso de los tweets varió a lo largo del período de análisis. La tasa es el número total de compromisos de los Tweets (clics, retweets, respuestas, citas y me gusta) dividido por el número total de impresiones. Esta métrica no considera las interacciones en las respuestas. Esta métrica es una estimación.
twitter:tweets_engagement_rate_over_timeTasa de compromiso total durante el tiempo
Este gráfico muestra cómo la tasa de compromiso total varió a lo largo del período de análisis. La tasa de compromiso es el número total de compromisos (clics, retweets, respuestas, citas y me gusta) dividido por el número total de impresiones. Esta métrica es una estimación.
twitter:total_engagement_rate_over_time
Tablas
1 métrica
Tuits destacados
Resumen de rendimiento de los Tweets publicados durante el período de revisión.
twitter:featured_tweets
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
