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.

IDTypeNameDescription
profile_followers_countNUMERICFollowers count (profile)Total number of followers the X user has.
profile_following_countNUMERICFollowing count (profile)Total number of accounts X user is following.
profile_like_countNUMERICLike count (profile)Total number of likes this X account has.
profile_listed_countNUMERICLists count (profile)Total number of public lists that this X user is a member of.
profile_media_countsNUMERICMedia count (profile)Total number of videos and pictures this X account has.
profile_tweet_countNUMERICTweets 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.

IDTypeNameDescription
account_idTEXTAccount IDAccount ID.
account_nameTEXTAccount NameAccount Name.
author_idTEXTAuthor IDUnique identifier of this user. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.
clicksNUMERICClicksNumber of times a user clicks on a URL link or URL preview card in a Tweet organically.
conversation_idTEXTConversation IDThe Tweet ID of the original Tweet of the conversation (which includes direct replies, replies of replies).
created_atDATECreated atCreation time of the Tweet.
dateDATEDateDate.
engagement_ratePERCENTEngagement RateOrganic engagements divided by impressions.
engagementsNUMERICEngagementsTotal organic engagements on the Tweet: likes, replies, retweets, URL link clicks and user profile clicks.
impression_countNUMERICImpression countNumber of times the Tweet has been viewed organically (not in Ad placement).
in_reply_to_user_idTEXTIn reply to user idIf 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.
langTEXTLangLanguage of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.
like_countNUMERICLike countNumber of likes the Tweet has received organically.
media_keyTEXTTweet media keyTweet media key
media_typeTEXTTweet media keyTweet media key
playback_0_countNUMERICQuartile video views 0The 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_countNUMERICQuartile video views 100The 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_countNUMERICQuartile video views 25The 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_countNUMERICQuartile video views 50The 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_countNUMERICQuartile video views 75The 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_countNUMERICQuote countNumber of times the Tweet has been quoted (Quote Tweets).
reply_countNUMERICReply countNumber of replies the Tweet has received organically.
reply_settingsTEXTReply settingsShows who can reply to this Tweet. Fields returned are `everyone`, `mentionedUsers`, and `following`.
retweet_countNUMERICRetweet countNumber of times the Tweet has been Retweeted organically.
sourceTEXTSourceThe name of the app the user Tweeted from.
textTEXTTextThe content of the Tweet.
tweet_idTEXTTweet IDUnique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.
TEXTTweet PermalinkPermanent link to the Tweet.
twitter_handleTEXTTwitter HandleYour Twitter handle linked to your Ad account
NUMERICUrl link clicksNumber of times a user clicks on a URL link or URL preview card in a Tweet organically.
user_profile_clicksNUMERICUser profile clicksNumber of times a user clicks the following portions of a Tweet organically - display name, user name, profile picture.
video_viewsNUMERICVideo viewsA 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.

IDTypeNameDescriptionReport
data_fetched_atTIMESTAMPData fetched atUTC 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.
datasourceTEXTData SourceThe name of the Windsor connector returning the row
day_of_monthTEXTDay of monthDay of the month
monthTEXTMonthNumber of the month
nowTIMESTAMPNowCurrent timestamp
todayDATETodayToday's date
weekTEXTWeekWeek (Sun-Sat).
week_dayTEXTDay of week and day numberWeekday number and name combined (Sun-Sat).Numbered from 0 Sunday to 6 Saturday.
week_day_isoTEXTDay of week and day number, ISOWeekday number and name combined, ISO format (Mon-Sun).Numbered from 1 Monday to 7
week_isoTEXTWeek ISOWeek, ISO format (Mon-Sun).
yearTEXTYearYear
year_monthTEXTYearmonthYear and month, e.g. 2024|3
year_month_nameTEXTYear month nameYear and month with the month name written out, e.g. "Jan 2025".
year_of_weekTEXTYear of weekThe year that contains first day of the week (Sun-Sat).
year_of_week_isoTEXTYear of week, ISOThe year that contains first day of the ISO week (Mon-Sun).
year_weekTEXTYear weekYear and week for US weeks (Sun-Sat), e.g. 2024|15
year_week_isoTEXTYear week ISOYear and week for ISO weeks (Mon-Sun), e.g. 2024|20