X (formerly Twitter)
None as of 08/06/2023
Refresh Time (CST)
3am / Real Time
Alli Data Library
Before Getting Started
To get started with the X (formerly Twitter) Organic datasource, ensure you have the following:
An X (formerly Twitter) account with with Administrator, Ad Manager, or Campaign Analyst permission to an ad account.
Click the button to login to your X (formerly Twitter) account instance and provide Alli access to your ad accounts.
Select one or multiple ad accounts that you would like to gather data for.
Ads on Twitter to gather data for tweets on X (formerly Twitter).
The ID of the Twitter Ads Account. If promotable users are selected, this will display the user id.
The name of the Twitter Account.
Identifier of the Tweet.
The timezone for the data in the account.
The tweet language.
The tweet's full text
The date the tweet was created.
The twitter handle.
The date the metrics occurred.
The type of tweet.
Total number of engagements
Total number of impressions
Total number of retweets
Total number of replies
Total number of likes
Total number of follows
Total number of card engagements
Total number of clicks, including favorites and other engagements
Number of app install or app open attempts
Number of clicks on linked URLs
Total number of qualified impressions
video total views
Total number of video views
video views 25
Total number of views where at least 25% of the video was viewed.
video views 50
Total number of views where at least 50% of the video was viewed.
video views 75
Total number of views where at least 75% of the video was viewed.
video views 100
Total number of views where at least 100% of the video was viewed.
video cta clicks
Total clicks on the call to action
video content starts
Total number of video playback starts
video 3s100pct views
Total number of views where at least 3 seconds were played while 100% in view (legacy video_total_views)
video 6s views
Total number of views where at least 6 seconds of the video was viewed
Total number of views where at least 15 seconds of the video or for 95% of the total duration was viewed
Frequently Asked Questions
How much historical data can I gather with this datasource?
You are able to backfill up to 2 years of data.
What is the difference between this datasource, the Ads one, and the Public one?
The Public leverages the paid version of the API which requires a payment plan to be set up prior to enabling, reach out to the support desk for more information.
The Ads datasource follows a similar patterns as this one but will provide you data related to your ad performance rather than organic tweet performance.
What if I have multiple handles I want to gather data for?
To gather data for multiple handles, each handle will need its own ad account set up. Once that’s complete, you can select multiple accounts in the Account setting of the Additional Configurations.