Metrics

Métricas de Threads con la API

Tu cliente conecta su cuenta de Threads y tu producto consulta 22 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": "threads:views",
      "component": "number_v1",
      "metrics": [
        "views"
      ]
    }
  ]
}
Ejemplo: "Visualizaciones" en octubre, comparado con septiembre.

Más ejemplos de llamadas a Threads

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

Evolución del número de seguidores

Este gráfico muestra la evolución de los seguidores de tu perfil a lo largo del tiempo.

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"
      ]
    }
  ]
}

Tabla

Publicaciones destacadas

Esta tabla muestra las publicaciones con mayor participación durante el período de análisis, considerando solo las publicaciones realizadas por la propia cuenta. Los datos de reposts y respuestas a comentarios (respuestas anidadas) no se consideran.

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

'Me gusta'

El número de me gusta en tus publicaciones.

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

  • Visualizaciones

    El número de veces que se vio tu perfil.

    threads:views
  • 'Me gusta'

    El número de me gusta en tus publicaciones.

    threads:likes
  • Respuestas

    El número de respuestas en tus publicaciones.

    threads:replies
  • Reposts

    El número de veces que se republicaron tus publicaciones.

    threads:reposts
  • Citas

    El número de veces que tus publicaciones fueron citadas.

    threads:quotes
  • Clics en Enlaces

    El número de veces que las personas hicieron clic en los enlaces que compartiste en Threads.

    threads:clicks
  • Número de seguidores

    El número total de seguidores en Threads.

    threads:followers_count
  • Variación de seguidores

    Cambio neto en el número de seguidores de tu perfil durante el periodo de análisis. Esta métrica se calcula disminuyendo el número de seguidores en el último día del período analizado desde el número de seguidores en el día anterior al primer día analizado.

    threads:new_followers_count
  • Visualizaciones en las publicaciones

    El número de visualizaciones en la publicación durante el período de análisis. Los datos de las respuestas a los comentarios (respuestas anidadas) no se consideran en esta métrica.

    threads:media_views
  • Me gusta en publicaciones

    El número de me gusta en la publicación durante el período de análisis. Los datos de las respuestas a los comentarios (respuestas anidadas) no se consideran en esta métrica.

    threads:media_likes
  • Respuestas en publicaciones

    El número de respuestas en la publicación durante el período de análisis. Los datos de las respuestas a comentarios (respuestas anidadas) no se consideran en esta métrica.

    threads:media_replies
  • Reposts en publicaciones

    El número de reposts de la publicación durante el período de análisis. Los datos de las respuestas a comentarios (respuestas anidadas) no se consideran en esta métrica.

    threads:media_reposts
  • Citas en publicaciones

    El número de citas en la publicación durante el período de análisis. Los datos de las respuestas a comentarios (respuestas anidadas) no se consideran en esta métrica.

    threads:media_quotes
  • Compartidos en publicaciones

    Número total de veces que se compartió la publicación en el período analizado. Los datos de las respuestas a comentarios (respuestas anidadas) no se consideran en esta métrica.

    threads:media_shares

Gráficos

5 métricas

  • Evolución del número de seguidores

    Este gráfico muestra la evolución de los seguidores de tu perfil a lo largo del tiempo.

    threads:followers_count_chart
  • Variación de seguidores a lo largo del tiempo.

    Este gráfico muestra la variación del número de seguidores de la cuenta durante el periodo analizado. Se calcula restando los seguidores estimados del día anterior de los seguidores estimados del día actual. Y considera tanto los seguidores ganados como los seguidores perdidos. Si todos los valores regresan iguales a cero, esto puede indicar que no tenemos datos para el período analizado.

    threads:new_followers_count_chart
  • Visualizaciones a lo largo del tiempo

    Este gráfico muestra el número de visualizaciones a lo largo del tiempo para el período analizado.

    threads:views_over_time
  • Seguidores por género

    Este gráfico muestra el número de seguidores por género.

    threads:followers_gender
  • Audiencia por edad y género

    Ese gráfico demuestra tu audiencia, agrupada por la edad y genero.

    threads:followers_gender_age

Tablas

3 métricas

  • Publicaciones destacadas

    Esta tabla muestra las publicaciones con mayor participación durante el período de análisis, considerando solo las publicaciones realizadas por la propia cuenta. Los datos de reposts y respuestas a comentarios (respuestas anidadas) no se consideran.

    threads:media_datatable
  • Ciudades con mayor número de seguidores

    Ciudades que poseen el mayor número de seguidores del perfil.

    threads:followers_city
  • Países con mayor número de seguidores

    Países que poseen el mayor número de seguidores del perfil.

    threads:followers_country

Mira Connect aplicado a tu producto.

Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.