Open navigation

X Organic (Twitter) connection guide

This guide contains all permissions and requirements for connecting your X Organic (Twitter) data to Supermetrics.


You can connect to data sources from the Data sources page on the Supermetrics Hub. On the Hub, you can also share an authentication link to connect to a data source you don't have direct access to.


After you connect to the data source on the Hub, you can use the data source connection in all available destinations.


Required permissions

Before you can fetch data from X Organic data source connector, you need to subscribe to the Premium package in X which gives you access to advanced analytics.


In addition to the Premium package, you must have the following to fetch X Organic data:


Next, you will need access to the Ad account linked to the X account you want to report data for:

  1. Open the Twitter Ads portal.
  2. In the top right-hand corner, click your account name and select Edit access to account.
  3. If you don't yet have access to this Ad account:
    1. Click Add access, and add your handle.
    2. Select Ad manager or Account administrator role.
    3. Check the box for Can compose promotable Tweets under the role selection.
    4. Click Save changes.
  4. If you already have your account added:
    1. Make sure you have Ad manager or Account administrator role and the option to compose promotable tweets.
    2. If not, click Edit access.
    3. Change the role.
    4. Check the box for Can compose promotable Tweets.
    5. Click Save changes.


Access Tweets from other Twitter profiles

To fetch tweets for another Twitter account with multi-user login, you must be added as a Campaign analyst or Administrator to the other Twitter Ads account.


Please ask the administrator of the other Twitter account to do the following:

  1. Create a Twitter ad account if they don’t have one already. Follow these steps to create a Twitter Ads account.
  2. Navigate to Twitter Ads.
  3. Click the account name in the top right corner and select Edit access to account.
  4. Click Add access.
  5. Enter the name of your Twitter handle in the text box, select Campaign analyst or Administrator.
  6. Check the box for Can compose promotable Tweets next to your account.
  7. Save the changes.


Query types

Query types define what sort of metrics and dimensions are available. You need to select one of the following query types when pulling data:

  • Profile info: Get Twitter profile-level metrics.
  • Tweet engagement: Measure the organic performance of your tweets.


Connection instructions

When connecting to X Organic (Twitter), you need to log in to X and select the account to pull data from.

  1. Select the X Organic (Twitter) data source on the Supermetrics Hub or in the data destination.
  2. If prompted, choose to make this connection shared or private.
  3. Click Start.
  4. Log in to the Twitter account you want to fetch data from.
  5. Click Authorize app to allow the Supermetrics app to access your profile data.
  6. In your data destination, select the account to include in your reporting and a query type.


See detailed instructions on how to connect to a data source from the Supermetrics Hub.


You can also connect to X Organic (Twitter) from these destinations:


More resources


Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.