Metrics

Threads metrics via API

Your customer connects their Threads account and your product queries 22 metrics through the same endpoint as every other platform. Each metric has an id (reference_key) that goes in the request.

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"
      ]
    }
  ]
}
Example: "Views" in October, compared to September.

More Threads request examples

The same endpoint for every kind of metric. The metrics and dimensions of each item come from the platform catalog (GET /api/metrics/{integration_slug}).

Chart

Followers evolution

This graph describes the evolution of your profile followers over time.

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

Table

Featured posts

This table shows the posts with the highest engagement during the analysis period, considering only posts made by the account itself. Data from Reposts and replies to comments (nested replies) are not considered.

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

Number

Likes

The number of likes on your posts.

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

Numbers

14 metrics

  • Views

    The number of times your profile was viewed.

    threads:views
  • Likes

    The number of likes on your posts.

    threads:likes
  • Replies

    The number of replies on your posts.

    threads:replies
  • Reposts

    The number of times your posts were reposted.

    threads:reposts
  • Quotes

    The number of times your posts were quoted.

    threads:quotes
  • Link Clicks

    The number of times people clicked on links you shared on Threads.

    threads:clicks
  • Followers Count

    Your total number of followers on Threads.

    threads:followers_count
  • Variation of followers

    Net change in the number of followers on your profile during the analysis period. This metric is calculated by decreasing the number of followers on the last day of the analyzed period from the number of followers on the day previous to the first day analyzed.

    threads:new_followers_count
  • Views on posts

    The number of views on the post during the analysis period. Data from responses to comments (nested replies) are not considered in this metric.

    threads:media_views
  • Likes on posts

    The number of likes on the post during the analysis period. Data from responses to comments (nested replies) are not considered in this metric.

    threads:media_likes
  • Replies on posts

    The number of replies on the post during the analysis period. Data from responses to comments (nested replies) are not considered in this metric.

    threads:media_replies
  • Reposts on posts

    The number of reposts of the post during the analysis period. Data from responses to comments (nested replies) are not considered in this metric.

    threads:media_reposts
  • Quotes on posts

    The number of quotes on the post during the analysis period. Data from responses to comments (nested replies) are not considered in this metric.

    threads:media_quotes
  • Shares on posts

    Total number of times the post was shared in the period analyzed. Data from responses to comments (nested replies) are not considered in this metric.

    threads:media_shares

Charts

5 metrics

  • Followers evolution

    This graph describes the evolution of your profile followers over time.

    threads:followers_count_chart
  • Variation of followers over time

    This graph shows the variation in the number of followers of the account over the analyzed period. It is calculated by subtracting the previous day's estimated followers from the current day's estimated followers. And it considers both followers gained and followers lost. If all values return equal to zero, this may indicate that we do not have data for the analyzed period.

    threads:new_followers_count_chart
  • Views over time

    This chart shows the number of views over time for the period analyzed.

    threads:views_over_time
  • Followers by gender

    This chart shows the number of followers by gender.

    threads:followers_gender
  • Audience by age and gender

    This graph displays your audience, grouped by age and gender.

    threads:followers_gender_age

Tables

3 metrics

  • Featured posts

    This table shows the posts with the highest engagement during the analysis period, considering only posts made by the account itself. Data from Reposts and replies to comments (nested replies) are not considered.

    threads:media_datatable
  • Cities with the most followers

    Cities that have the largest number of profile followers.

    threads:followers_city
  • Countries with the most followers

    Countries that have the largest number of profile followers.

    threads:followers_country

See Connect applied to your product.

Try it for 15 days with no card, or walk our team through your use case.