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"
]
}
]
}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:viewsLikes
The number of likes on your posts.
threads:likesReplies
The number of replies on your posts.
threads:repliesReposts
The number of times your posts were reposted.
threads:repostsQuotes
The number of times your posts were quoted.
threads:quotesLink Clicks
The number of times people clicked on links you shared on Threads.
threads:clicksFollowers Count
Your total number of followers on Threads.
threads:followers_countVariation 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_countViews 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_viewsLikes 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_likesReplies 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_repliesReposts 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_repostsQuotes 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_quotesShares 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_chartVariation 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_chartViews over time
This chart shows the number of views over time for the period analyzed.
threads:views_over_timeFollowers by gender
This chart shows the number of followers by gender.
threads:followers_genderAudience 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_datatableCities with the most followers
Cities that have the largest number of profile followers.
threads:followers_cityCountries 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.
