Destinations
Data sources
AI insights
About us
Careers
Security
Customer reviews
Contact us
Affiliate program
Solution partners
Template gallery
Looker Studio templates
Power BI templates
Excel templates
Google Sheets templates
Tableau templates
Facebook Ads templates
Google Ads templates
Data fields & Metrics
AI prompt library & Guides
Product documentation
API documentation
Case studies
Blog
Data models
Windsor vs Supermetrics
Windsor vs Funnel.io
Windsor vs Fivetran
Windsor vs Rivery
Windsor vs Portermetrics
Windsor vs Coupler.io
Send your Threads data to
Threads Connector Reference
12 metrics52 dimensions
The Threads connector exposes 64 fields (12 metrics, 52 dimensions). Every field ID below can be passed to the Windsor.ai API in the fields parameter.
Available actions
Create Image Post Publish a single image post to the connected Threads account. Provide a publicly accessible image URL (JPEG or PNG) and an optional text caption (at most 500 characters). For a text-only post use create_text_post; to reply to an existing post use create_reply.
Publish a single image post to the connected Threads account. Provide a publicly accessible image URL (JPEG or PNG) and an optional text caption (at most 500 characters). For a text-only post use create_text_post; to reply to an existing post use create_reply.
Parameters
image_urlstringRequiredtextstring
Create Reply Publish a text reply to a Threads post or reply on the connected account. reply_to_id is the media id of the post or reply being replied to, as returned by the post_id or reply_id read fields. Provide the reply text (at most 500 characters). The reply is public and attributed to the account.
Publish a text reply to a Threads post or reply on the connected account. reply_to_id is the media id of the post or reply being replied to, as returned by the post_id or reply_id read fields. Provide the reply text (at most 500 characters). The reply is public and attributed to the account.
Parameters
reply_to_idstringRequiredtextstringRequired
Create Text Post Publish a text-only post to the connected Threads account. Provide the post text (at most 500 characters). To attach an image use create_image_post; to reply to an existing post use create_reply.
Publish a text-only post to the connected Threads account. Provide the post text (at most 500 characters). To attach an image use create_image_post; to reply to an existing post use create_reply.
Parameters
textstringRequired
Threads Fields
Threads Post Insights fields
The Post Insights report of the Threads connector includes 6 fields.
| ID | Type | Name | Description |
|---|---|---|---|
| post_likes | NUMERIC | Post Likes | The number of likes on the post. |
| post_quotes | NUMERIC | Post Quotes | The number of times the post was quoted. |
| post_replies | NUMERIC | Post Replies | The number of replies on the post. Note: When the requested media is a root post, this number includes total replies. If the media is itself a reply, this number includes only direct replies. |
| post_reposts | NUMERIC | Post Reposts | The number of times the post was reposted. |
| post_shares | NUMERIC | Post Shares | The number of shares of your Threads posts. |
| post_views | NUMERIC | Post Views | The number of times your post was played or displayed. |
Threads Posts fields
The Posts report of the Threads connector includes 13 fields.
| ID | Type | Name | Description |
|---|---|---|---|
| post_alt_text | TEXT | Post Alt Text | The accessibility text label or description for an image or video in a Threads post. |
| post_id | TEXT | Post ID | The media's ID. |
| post_is_quote_post | BOOLEAN | Post Is Quote Post | Indicates if the media is a quoted post made by another user. |
| post_link_attachment_url | TEXT | Post Link Attachment URL | The URL attached to a Threads post. |
| post_media_product_type | TEXT | Post Media Product Type | Surface where the media is published. In the case of Threads, the value is THREADS. |
| post_media_type | TEXT | Post Media Type | The media type for a Threads post will be one of these values: TEXT_POST, IMAGE, VIDEO, CAROUSEL_ALBUM, AUDIO, or REPOST_FACADE. |
| post_permalink | TEXT | Post Permalink | Permanent link to the post. Will be omitted if the media contains copyrighted material or has been flagged for a copyright violation. |
| post_quoted_post_id | TEXT | Post Quoted Post ID | Media ID of the post that was quoted. Note: This only appears on quote posts. |
| post_reposted_post_id | TEXT | Post Reposted Post ID | Media ID of the post that was reposted. Note: This only appears on reposts. |
| post_shortcode | TEXT | Post Shortcode | Shortcode of the media. |
| post_text | TEXT | Post Text | Represents text for a Threads post. |
| post_thumbnail_url | IMAGE_URL | Post Thumbnail URL | URL of thumbnail. This only shows up for Threads media with video. |
| post_timestamp | Post Timestamp | The publish date and time. |
Threads Profile fields
The Profile report of the Threads connector includes 4 fields.
| ID | Type | Name | Description |
|---|---|---|---|
| profile_biography | TEXT | Profile Biography | Biography text on Threads profile. |
| profile_image_url | IMAGE_URL | Profile Image URL | URL of the user's profile picture on Threads. |
| profile_name | TEXT | Profile Name | Display name of the user on Threads. |
| profile_username | TEXT | Profile Username | Handle or unique username on Threads. |
Threads Profile Insights fields
The Profile Insights report of the Threads connector includes 10 fields.
| ID | Type | Name | Description |
|---|---|---|---|
| profile_followers_age | TEXT | Profile Followers Age | The demographic characteristics of followers age distribution. Note: a Threads profile must have at least 100 followers to breakdown followers count by age. Followers count can be broken down by only one dimension. |
| profile_followers_city | CITY | Profile Followers City | The demographic characteristics of followers city distribution. Note: a Threads profile must have at least 100 followers to breakdown followers count by city. Followers count can be broken down by only one dimension. |
| profile_followers_count | NUMERIC | Profile Followers Count | Your total number of followers on Threads. Note: this metric does not support date range filtering and will always show lifetime value. |
| profile_followers_country | COUNTRY | Profile Followers Country | The demographic characteristics of followers country distribution. Note: a Threads profile must have at least 100 followers to breakdown followers count by country. Followers count can be broken down by only one dimension. |
| profile_followers_gender | TEXT | Profile Followers Gender | The demographic characteristics of followers gender distribution. Note: a Threads profile must have at least 100 followers to breakdown followers count by gender. Followers count can be broken down by only one dimension. |
| profile_likes | NUMERIC | Profile Likes | The number of likes on your posts. |
| profile_quotes | NUMERIC | Profile Quotes | The number of times your posts were quoted. |
| profile_replies | NUMERIC | Profile Replies | The number of replies on your posts. Note: This number includes only top-level replies. |
| profile_reposts | NUMERIC | Profile Reposts | The number of times your posts were reposted. |
| profile_views | NUMERIC | Profile Views | The number of times your profile was viewed. Note: This is a time series metric and will show daily values. |
Threads Replies fields
The Replies report of the Threads connector includes 9 fields.
| ID | Type | Name | Description |
|---|---|---|---|
| reply_has_replies | BOOLEAN | Reply Has Replies | Whether the reply itself has replies. |
| reply_hide_status | TEXT | Reply Hide Status | Moderation status of the reply: NOT_HUSHED, UNHUSHED, HIDDEN or COVERED. |
| reply_id | TEXT | Reply ID | The reply's media ID. |
| reply_media_type | TEXT | Reply Media Type | The media type of the reply: TEXT_POST, IMAGE, VIDEO, CAROUSEL_ALBUM, AUDIO, or REPOST_FACADE. |
| reply_root_post_id | TEXT | Reply Root Post ID | Media ID of the top-level post that started the thread this reply belongs to. |
| reply_text | TEXT | Reply Text | Text content of the reply. |
| reply_timestamp | Reply Timestamp | The date and time the reply was published. | |
| reply_to_id | TEXT | Reply To ID | Media ID of the post or reply this reply was made to. |
| reply_username | TEXT | Reply Username | Username of the Threads account that authored the reply. |
Threads other fields
The Threads connector has 22 fields that do not belong to a named report, or belong to a report with only one or two fields.
| ID | Type | Name | Description | Report |
|---|---|---|---|---|
| account_id | TEXT | Account ID | Threads user ID. | Account |
| account_name | TEXT | Account Name | Threads account name. | Account |
| data_fetched_at | Data fetched at | UTC timestamp (second precision) of when the connector request that pulled the row started. Freshly pulled rows show this request's start time; cache hits keep the start time of the request that filled the cache. Selecting this field disables aggregation, so rows are returned individually (each keeping its own fetch time) instead of being summed. | ||
| datasource | TEXT | Data Source | The name of the Windsor connector returning the row | |
| date | DATE | Date | Date of the data. For posts, this is the date the post was published. For user insights, this is the date of insights. | Time |
| day_of_month | TEXT | Day of month | Day of the month | |
| end_time | End Time | End time for a time series metric. | Time | |
| month | TEXT | Month | Number of the month | |
| now | Now | Current timestamp | ||
| source | TEXT | Source | The name of the Windsor connector returning the row | |
| today | DATE | Today | Today's date | |
| week | TEXT | Week | Week (Sun-Sat). | |
| week_day | TEXT | Day of week and day number | Weekday number and name combined (Sun-Sat).Numbered from 0 Sunday to 6 Saturday. | |
| week_day_iso | TEXT | Day of week and day number, ISO | Weekday number and name combined, ISO format (Mon-Sun).Numbered from 1 Monday to 7 | |
| week_iso | TEXT | Week ISO | Week, ISO format (Mon-Sun). | |
| year | TEXT | Year | Year | |
| year_month | TEXT | Yearmonth | Year and month, e.g. 2024|3 | |
| year_month_name | TEXT | Year month name | Year and month with the month name written out, e.g. "Jan 2025". | |
| year_of_week | TEXT | Year of week | The year that contains first day of the week (Sun-Sat). | |
| year_of_week_iso | TEXT | Year of week, ISO | The year that contains first day of the ISO week (Mon-Sun). | |
| year_week | TEXT | Year week | Year and week for US weeks (Sun-Sat), e.g. 2024|15 | |
| year_week_iso | TEXT | Year week ISO | Year and week for ISO weeks (Mon-Sun), e.g. 2024|20 |