Twitter Organic (Legacy) Connector Reference
22 metrics33 dimensions
https://connectors.windsor.ai/x_organic?api_key=[your API key]&date_preset=last_7d&fields=tweet_id,text,lang,like_count,date,source&_renderer=csv
The Twitter Organic (Legacy) connector exposes 55 fields (22 metrics, 33 dimensions). Every field ID below can be passed to the Windsor.ai API in the fields parameter.
Twitter Organic (Legacy) Fields
Twitter Organic (Legacy) Account fields
The Account report of the Twitter Organic (Legacy) connector includes 6 fields.
| ID | Type | Name | Description |
|---|---|---|---|
| profile_followers_count | NUMERIC | Followers count (profile) | Total number of followers the X user has. |
| profile_following_count | NUMERIC | Following count (profile) | Total number of accounts X user is following. |
| profile_like_count | NUMERIC | Like count (profile) | Total number of likes this X account has. |
| profile_listed_count | NUMERIC | Lists count (profile) | Total number of public lists that this X user is a member of. |
| profile_media_counts | NUMERIC | Media count (profile) | Total number of videos and pictures this X account has. |
| profile_tweet_count | NUMERIC | Tweets count (profile) | Total number of tweets this X user has. |
Twitter Organic (Legacy) Tweet fields
The Tweet report of the Twitter Organic (Legacy) connector includes 32 fields.
| ID | Type | Name | Description |
|---|---|---|---|
| account_id | TEXT | Account ID | Account ID. |
| account_name | TEXT | Account Name | Account Name. |
| author_id | TEXT | Author ID | Unique identifier of this user. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers. |
| clicks | NUMERIC | Clicks | Number of times a user clicks on a URL link or URL preview card in a Tweet organically. |
| conversation_id | TEXT | Conversation ID | The Tweet ID of the original Tweet of the conversation (which includes direct replies, replies of replies). |
| created_at | DATE | Created at | Creation time of the Tweet. |
| date | DATE | Date | Date. |
| engagement_rate | PERCENT | Engagement Rate | Organic engagements divided by impressions. |
| engagements | NUMERIC | Engagements | Total organic engagements on the Tweet: likes, replies, retweets, URL link clicks and user profile clicks. |
| impression_count | NUMERIC | Impression count | Number of times the Tweet has been viewed organically (not in Ad placement). |
| in_reply_to_user_id | TEXT | In reply to user id | If this Tweet is a Reply, indicates the user ID of the parent Tweet's author. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers. |
| lang | TEXT | Lang | Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag. |
| like_count | NUMERIC | Like count | Number of likes the Tweet has received organically. |
| media_key | TEXT | Tweet media key | Tweet media key |
| media_type | TEXT | Tweet media key | Tweet media key |
| playback_0_count | NUMERIC | Quartile video views 0 | The number of users who played through to less than the first quartile in a video from organic contexts. This reflects the number of quartile views across all Tweets in which the given video has been posted. |
| playback_100_count | NUMERIC | Quartile video views 100 | The number of users who played through to fourth quartile in a video from organic contexts. This reflects the number of quartile views across all Tweets in which the given video has been posted. |
| playback_25_count | NUMERIC | Quartile video views 25 | The number of users who played through to first quartile in a video from organic contexts. This reflects the number of quartile views across all Tweets in which the given video has been posted. |
| playback_50_count | NUMERIC | Quartile video views 50 | The number of users who played through to second quartile in a video from organic contexts. This reflects the number of quartile views across all Tweets in which the given video has been posted. |
| playback_75_count | NUMERIC | Quartile video views 75 | The number of users who played through to third quartile in a video from organic contexts. This reflects the number of quartile views across all Tweets in which the given video has been posted. |
| quote_count | NUMERIC | Quote count | Number of times the Tweet has been quoted (Quote Tweets). |
| reply_count | NUMERIC | Reply count | Number of replies the Tweet has received organically. |
| reply_settings | TEXT | Reply settings | Shows who can reply to this Tweet. Fields returned are `everyone`, `mentionedUsers`, and `following`. |
| retweet_count | NUMERIC | Retweet count | Number of times the Tweet has been Retweeted organically. |
| source | TEXT | Source | The name of the app the user Tweeted from. |
| text | TEXT | Text | The content of the Tweet. |
| tweet_id | TEXT | Tweet ID | Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers. |
| tweet_permalink | TEXT | Tweet Permalink | Permanent link to the Tweet. |
| twitter_handle | TEXT | Twitter Handle | Your Twitter handle linked to your Ad account |
| url_link_clicks | NUMERIC | Url link clicks | Number of times a user clicks on a URL link or URL preview card in a Tweet organically. |
| user_profile_clicks | NUMERIC | User profile clicks | Number of times a user clicks the following portions of a Tweet organically - display name, user name, profile picture. |
| video_views | NUMERIC | Video views | A count of how many times the video included in the Tweet has been viewed from organic contexts. |
Twitter Organic (Legacy) other fields
The Twitter Organic (Legacy) connector has 17 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 |
|---|---|---|---|---|
| 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 | |
| day_of_month | TEXT | Day of month | Day of the month | |
| month | TEXT | Month | Number of the month | |
| now | Now | Current timestamp | ||
| 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 |
