Documentation Index

Fetch the complete documentation index at: https://docs.supermetrics.com/llms.txt

Use this file to discover all available pages before exploring further.

Threads Insights metrics and dimensions

  • Updated on Mar 5, 2026
  • Published on Aug 5, 2025
Prev Next

Supermetrics brings all your Threads Insights data into Google Sheets, Looker Studio, Power BI, Excel, BigQuery, Snowflake, Redshift, Azure

9 metrics47 dimensions

DATASOURCE

dataSourceName
Field label Data source
Description The name of the source for this data, as listed on supermetrics.com/docs
Field type dimension
Data type string.text.value
Destinations API, Data warehouse
system_metadata.data_source_logins
Field label Data source logins
Description The data source login accounts that were used to authenticate against the data source
Field type dimension
Data type string.text.json
system_metadata.data_source_login_owners
Field label Data source login owners
Description The Supermetrics users that created the data source login connections
Field type dimension
Data type string.text.json

DEMOGRAPHICS

country
Field label Country
Description The countries of the profile's followers. Only compatible with the Followers (by demographic) metric
Field type dimension
Data type string.geo.country.twolettercode
city
Field label City
Description The cities of the profile's followers. Only compatible with the Followers (by demographic) metric
Field type dimension
Data type string.geo.city
age
Field label Age
Description The age distribution of the profile's followers. Only compatible with the Followers (by demographic) metric
Field type dimension
Data type string.person.age
gender
Field label Gender
Description The gender distribution of the profile's followers. Only compatible with the Followers (by demographic) metric
Field type dimension
Data type string.person.gender

FOLLOWERS

followers_count
Field label Followers (total)
Description Your total number of followers on Threads (lifetime value)
Field type metric
Data type int.number.value

FOLLOWERS (BY DEMOGRAPHICS)

follower_demographics
Field label Followers (by demographics)
Description The demographic characteristics of followers, including countries, cities, and gender distribution. This metrics requires one of the demographic dimensions to be selected
Field type metric
Data type int.number.value

POST

post_id
Field label Post ID
Description The media's ID
Field type dimension
Data type string.text.value
text
Field label Text
Description The text in a Threads post
Field type dimension
Data type string.text.value
media_product_type
Field label Media product type
Description Surface where the media is published. In the case of Threads, the value is THREADS
Field type dimension
Data type string.text.value
media_type
Field label Media type
Description The media type for a Threads post will be one of these values: TEXT_POST, IMAGE, VIDEO, CAROUSEL_ALBUM, AUDIO, or REPOST_FACADE
Field type dimension
Data type string.text.value
media_url
Field label Media URL
Description The post's media URL
Field type dimension
Data type string.text.url
permalink
Field label Permalink
Description Permanent link to the post. Will be omitted if the media contains copyrighted material or has been flagged for a copyright violation
Field type dimension
Data type string.text.url
shortcode
Field label Shortcode
Description Shortcode of the media
Field type dimension
Data type string.text.value
thumbnail_url
Field label Thumbnail URL
Description URL of thumbnail. This only shows up for Threads media with video
Field type dimension
Data type string.text.url
is_quote_post
Field label Is quote post
Description Indicates if the media is a quoted post made by another user
Field type dimension
Data type bool
publish_date
Field label Publish date
Description Date the post was published
Field type dimension
Data type string.time.date
publish_datetime
Field label Publish datetime
Description Date and time the post was published
Field type dimension
Data type string.time.datetime

POST ACTIVITY

post_views
Field label Post views
Description The number of times your post was played or displayed
Field type metric
Data type int.number.value
likes
Field label Post likes
Description The number of likes on your posts
Field type metric
Data type int.number.value
replies
Field label Post replies
Description The number of replies on your posts. This number includes only top-level replies
Field type metric
Data type int.number.value
reposts
Field label Post reposts
Description The number of times your posts were reposted
Field type metric
Data type int.number.value
quotes
Field label Post quotes
Description The number of times your posts were quoted
Field type metric
Data type int.number.value
shares
Field label Post shares
Description The number of shares of your Threads posts
Field type metric
Data type int.number.value

PROFILE

profile_id
Field label Profile ID
Description Threads user ID
Field type dimension
Data type string.text.value
username
Field label Username
Description Handle or unique username on Threads
Field type dimension
Data type string.text.value
name
Field label Name
Description Display name of the user on Threads
Field type dimension
Data type string.text.value
profile_picture_url
Field label Profile picture URL
Description URL of the user's profile picture on Threads
Field type dimension
Data type string.text.url
biography
Field label Biography
Description Biography text on Threads profile
Field type dimension
Data type string.text.value
profile_views
Field label Profile views
Description The number of times your profile was viewed
Field type metric
Data type int.number.value

QUERY

system_metadata.query_date_range_start
Field label Start date
Description The start date of the requested query
Field type dimension
Data type string.time.date
system_metadata.query_date_range_end
Field label End date
Description The end date of the requested query
Field type dimension
Data type string.time.date
system_metadata.query_timezone
Field label Timezone
Description The timezone that is supplied to the query
Field type dimension
Data type string.time.timezone
system_metadata.query_filters
Field label Filters
Description All filters used in the query
Field type dimension
Data type string.text.json
system_metadata.query_date_start
Field label Start
Description When the query was started
Field type dimension
Data type string.time.datetime
system_metadata.query_date_end
Field label End
Description When the query completed
Field type dimension
Data type string.time.datetime
system_metadata.query_duration
Field label Duration
Description The duration in seconds of the query
Field type dimension
Data type int.duration.seconds
system_metadata.query_accounts
Field label Accounts
Description A list of accounts of which the data was pulled from
Field type dimension
Data type string.text.json
system_metadata.query_excluded_accounts
Field label Excluded invalid accounts
Description A list of unavailable accounts excluded from the query due to the "Exclude invalid accounts" setting
Field type dimension
Data type string.text.json

TIME

today
Field label Today
Description Today's date, e.g. 2017-01-31
Field type dimension
Data type string.time.date
Destinations API, Data warehouse
year
Field label Year
Field type dimension
Data type string.time.year
year_of_week
Field label Year of week (Sun-Sat)
Field type dimension
Data type string.time.year
year_of_week_iso
Field label Year of week (Mon-Sun)
Field type dimension
Data type string.time.year
year_month
Field label Year & month
Field type dimension
Data type string.time.yearmonth
month
Field label Month
Field type dimension
Data type string.time.month
year_week
Field label Year & week (Sun-Sat)
Field type dimension
Data type string.time.yearweek
year_week_iso
Field label Year & week (Mon-Sun)
Field type dimension
Data type string.time.yearweekiso
week
Field label Week (Sun-Sat)
Field type dimension
Data type string.time.week
week_iso
Field label Week (Mon-Sun)
Field type dimension
Data type string.time.weekiso
day_of_month
Field label Day of month
Field type dimension
Data type string.time.dayofmonth
day_of_week_name
Field label Day of week (Sun-Sat)
Field type dimension
Data type string.time.dayofweek
day_of_week_name_iso
Field label Day of week (Mon-Sun)
Field type dimension
Data type string.time.dayofweekiso
date
Field label Date
Field type dimension
Data type string.time.date
atom
Field label Datetime
Field type dimension
Data type string.time.datetime

© Supermetrics 2026