Metrics

Métricas do Threads pela API

Seu cliente conecta a conta do Threads e seu produto consulta 22 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": "threads:views",
      "component": "number_v1",
      "metrics": [
        "views"
      ]
    }
  ]
}
Exemplo: "Visualizações" em outubro, comparado a setembro.

Mais exemplos de chamadas no Threads

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

Crescimento de seguidores

Esse gráfico descreve a evolução do seu perfil ao longo do tempo.

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": "threads:followers_count_chart",
      "component": "chart_v1",
      "metrics": [
        "followers"
      ],
      "dimensions": [
        "date"
      ]
    }
  ]
}

Tabela

Postagens em destaque

Esta tabela apresenta as postagens com maior engajamento durante o período de análise, considerando apenas posts realizados pela própria conta. Dados de Reposts e respostas a comentários (respostas aninhadas) não são considerados.

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": "threads:media_datatable",
      "component": "datatable_v1",
      "metrics": [
        "type",
        "views",
        "likes",
        "replies",
        "reposts",
        "quotes",
        "shares",
        "created_at"
      ],
      "dimensions": [
        "media"
      ]
    }
  ]
}

Número

Curtidas

O número de curtidas nas suas publicações.

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": "threads:likes",
      "component": "number_v1",
      "metrics": [
        "likes"
      ]
    }
  ]
}

Números

14 métricas

  • Visualizações

    O número de vezes que seu perfil foi visualizado.

    threads:views
  • Curtidas

    O número de curtidas nas suas publicações.

    threads:likes
  • Respostas

    O número de respostas nas suas publicações.

    threads:replies
  • Reposts

    O número de vezes que suas publicações foram repostadas.

    threads:reposts
  • Citações

    O número de vezes que suas publicações foram citadas.

    threads:quotes
  • Cliques nos Links

    O número de vezes que as pessoas clicaram nos links que você compartilhou no Threads.

    threads:clicks
  • Número de seguidores

    O número total de seguidores no Threads.

    threads:followers_count
  • Variação de seguidores

    Variação líquida do número de seguidores em seu perfil no período de análise. Essa métrica é calculada diminuindo o número de seguidores no último dia do período analisado do dia anterior ao primeiro dia analisado.

    threads:new_followers_count
  • Visualizações nas postagens

    O número de visualizações na publicação durante o período de análise. Dados de respostas aos comentários (respostas aninhadas) não são considerados nessa métrica.

    threads:media_views
  • Curtidas em postagens

    O número de curtidas na publicação durante o período de análise. Dados de respostas aos comentários (respostas aninhadas) não são considerados nessa métrica.

    threads:media_likes
  • Respostas em postagens

    O número de respostas na publicação durante o período de análise. Dados de respostas a comentários (respostas aninhadas) não são considerados nesta métrica.

    threads:media_replies
  • Reposts em postagens

    O número de reposts da publicação durante o período de análise. Dados de respostas a comentários (respostas aninhadas) não são considerados nesta métrica.

    threads:media_reposts
  • Citações em postagens

    O número de citações na publicação durante o período de análise. Dados de respostas a comentários (respostas aninhadas) não são considerados nesta métrica.

    threads:media_quotes
  • Compartilhamentos em postagens

    Número total de vezes que a publicação foi compartilhada no período analisado. Dados de respostas a comentários (respostas aninhadas) não são considerados nesta métrica.

    threads:media_shares

Gráficos

5 métricas

  • Crescimento de seguidores

    Esse gráfico descreve a evolução do seu perfil ao longo do tempo.

    threads:followers_count_chart
  • Variação de seguidores ao longo do tempo

    Este gráfico mostra qual foi a variação do número de seguidores da conta ao longo do período analisado. Ele é calculado subtraindo os seguidores estimados do dia anterior dos seguidores estimados do dia atual. E considera tanto os seguidores ganhos quanto os seguidores perdidos. Caso todos os valores retornem igual a zero, isso pode indicar que não temos os dados do período analisado.

    threads:new_followers_count_chart
  • Visualizações ao longo do tempo

    Este gráfico mostra o número de visualizações ao longo do tempo para o período analisado.

    threads:views_over_time
  • Seguidores por gênero

    Este gráfico mostra o número de seguidores por gênero.

    threads:followers_gender
  • Audiência por idade e gênero

    Esse gráfico mostra sua audiência, agrupada pela idade e gênero.

    threads:followers_gender_age

Tabelas

3 métricas

  • Postagens em destaque

    Esta tabela apresenta as postagens com maior engajamento durante o período de análise, considerando apenas posts realizados pela própria conta. Dados de Reposts e respostas a comentários (respostas aninhadas) não são considerados.

    threads:media_datatable
  • Cidades com o maior número de seguidores

    Cidades que possuem o maior número de seguidores do perfil.

    threads:followers_city
  • Países com o maior número de seguidores

    Países que possuem o maior número de seguidores do perfil.

    threads:followers_country

Veja o Connect aplicado ao seu produto.

Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.