Metrics
Métricas do X (Twitter) pela API
Seu cliente conecta a conta do X (Twitter) e seu produto consulta 17 métricas pelo mesmo endpoint das outras plataformas. Cada métrica tem um identificador (reference_key) que vai na chamada.
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"
]
}
]
}Mais exemplos de chamadas no X (Twitter)
O mesmo endpoint para cada tipo de métrica. Os campos metrics e dimensions de cada item vêm do catálogo da plataforma (GET /api/metrics/{integration_slug}).
Gráfico
Engajamento total durante o tempo
Este gráfico mostra o número total de engajamentos diários recebidos por seus tweets postados durante o período de análise. Isso inclui todos os cliques em qualquer lugar no Tweet (incluindo links, avatar e nome de usuário), retuítes, citações, respostas e curtidas. Essa métrica não considera seguidores, cliques de hashtag e expansões 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"
]
}
]
}Tabela
Tweets em destaque
Resumo do desempenho dos Tweets publicados durante o período de análise.
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 em sua conta, no período analisado. Esta métrica não inclui as respostas aos 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 da sua conta
twitter:followers_countTweets
Número total de tweets realizados em sua conta, no período analisado. Esta métrica não inclui as respostas aos tweets.
twitter:only_tweets_countTotal de Tweets
Número total de tweets realizados em sua conta durante o período analisado. Esta métrica considera as respostas aos Tweets.
twitter:total_tweets_countImpressões Totais
Número total de visualizações de seus Tweets postados durante o período de revisão.
twitter:total_impressions_countImpressões dos Tweets
Número de vezes que um usuário recebeu um Tweet, postado durante o período de análise, na linha do tempo ou nos resultados de pesquisa. Essa métrica não considera as respostas aos Tweets.
twitter:tweets_impressions_countEngajamento Total
Número total de vezes que os usuários interagiram com um tweet postado durante o período de análise. Isso inclui todos os cliques em qualquer lugar no Tweet (incluindo links, avatar e nome de usuário), retuítes, citações, respostas e curtidas. Essa métrica não considera seguidores, cliques de hashtag e expansões de tweets.
twitter:total_engagementEngajamentos dos Tweets
Número de vezes que um usuário interagiu com um Tweet (cliques, retuítes, respostas, citações e curtidas) durante o período analisado. Essa métrica não considera interações nas respostas.
twitter:tweets_engagementTaxa de engajamento total
O número total de engajamento(cliques, retuítes, respostas, citações e curtidas) dividido pelo número total de impressões.
twitter:total_engagement_rateTaxa de engajamento dos tweets
O número total de engajamento dos Tweets (cliques, retuítes, respostas, citações e curtidas) dividido pelo número total de impressões. Esta métrica não considera as interações nas respostas.
twitter:tweets_engagement_rateMenções
Número total de vezes que sua conta foi mencionada, durante o período de análise.
twitter:mentions
Gráficos
6 métricas
Engajamento total durante o tempo
Este gráfico mostra o número total de engajamentos diários recebidos por seus tweets postados durante o período de análise. Isso inclui todos os cliques em qualquer lugar no Tweet (incluindo links, avatar e nome de usuário), retuítes, citações, respostas e curtidas. Essa métrica não considera seguidores, cliques de hashtag e expansões de tweets.
twitter:total_engagement_over_timeEngajamento dos Tweets durante o tempo
Este gráfico mostra o número de engajamentos diários recebidos por seus tweets postados durante o período de análise. O engajamento inclui cliques, retuítes, respostas, citações e curtidas, mas não considera as interações nas respostas.
twitter:tweets_engagement_over_timeImpressões totais dos Tweets durante o tempo
Este gráfico mostra o número total de visualizações de seus Tweets postados durante o período de análise.
twitter:total_impressions_over_timeImpressões dos Tweets durante o tempo
Este gráfico mostra o número de vezes que um usuário recebeu um Tweet postado durante o período de análise, seja na linha do tempo ou nos resultados da pesquisa. Respostas a Tweets não são consideradas.
twitter:tweets_impressions_over_timeTaxa de engajamento dos tweets durante o tempo
Este gráfico mostra como a taxa de engajamento dos tweets variou ao longo do período de análise. A taxa é o número total de engajamento dos Tweets (cliques, retuítes, respostas, citações e curtidas) dividido pelo número total de impressões. Esta métrica não considera as interações nas respostas. Essa métrica é uma estimativa.
twitter:tweets_engagement_rate_over_timeTaxa de engajamento total durante o tempo
Este gráfico mostra como a taxa de engajamento total variou ao longo do período de análise. A taxa de engajamento é o número total de engajamento (cliques, retuítes, respostas, citações e curtidas) dividido pelo número total de impressões. Essa métrica é uma estimativa.
twitter:total_engagement_rate_over_time
Tabelas
1 métrica
Tweets em destaque
Resumo do desempenho dos Tweets publicados durante o período de análise.
twitter:featured_tweets
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
