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"
      ]
    }
  ]
}
Exemplo: "Número de Seguidores" em outubro, comparado a setembro.

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_count
  • Tweets

    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_count
  • Total 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_count
  • Impressões Totais

    Número total de visualizações de seus Tweets postados durante o período de revisão.

    twitter:total_impressions_count
  • Impressõ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_count
  • Engajamento 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_engagement
  • Engajamentos 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_engagement
  • Taxa 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_rate
  • Taxa 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_rate
  • Mençõ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_time
  • Engajamento 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_time
  • Impressõ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_time
  • Impressõ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_time
  • Taxa 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_time
  • Taxa 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.