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"
]
}
]
}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:viewsCurtidas
O número de curtidas nas suas publicações.
threads:likesRespostas
O número de respostas nas suas publicações.
threads:repliesReposts
O número de vezes que suas publicações foram repostadas.
threads:repostsCitações
O número de vezes que suas publicações foram citadas.
threads:quotesCliques nos Links
O número de vezes que as pessoas clicaram nos links que você compartilhou no Threads.
threads:clicksNúmero de seguidores
O número total de seguidores no Threads.
threads:followers_countVariaçã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_countVisualizaçõ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_viewsCurtidas 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_likesRespostas 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_repliesReposts 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_repostsCitaçõ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_quotesCompartilhamentos 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_chartVariaçã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_chartVisualizaçõ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_timeSeguidores por gênero
Este gráfico mostra o número de seguidores por gênero.
threads:followers_genderAudiê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_datatableCidades com o maior número de seguidores
Cidades que possuem o maior número de seguidores do perfil.
threads:followers_cityPaí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.
