Follow these steps to connect your X Organic (Twitter) data to Supermetrics and use your data in any of our data destinations — Google Sheets, Looker Studio, Excel, data warehouses, and Power BI, as well as the Supermetrics API. You can also connect to data sources from the Supermetrics Hub.
You can share your data source connection with your team and use the connection across all data destinations you use with Supermetrics. Learn more about shared connections.
Before you begin
Before using the X Organic (Twitter) data source connector to fetch organic tweet data, you must have a completed Twitter profile and an active Twitter Ads account connected to it. Follow these steps to create a Twitter Ads account.
If the account is already linked to a Twitter Ads account, and you didn't create a new account, set up Tweet permissions in Twitter Ads account:
- Open the Twitter Ads portal.
- In the top right-hand corner, click your account name and select Edit access to account.
- Click Edit access.
- Check the box for Can compose promotable Tweets next to your account.
- 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:
- Create a Twitter ad account if they don’t have one already. Follow these steps to create a Twitter Ads account.
- Navigate to Twitter Ads.
- Click the account name in the top right corner and select Edit access to account.
- Click Add access.
- Enter the name of your Twitter handle in the text box, select Campaign analyst, and save the changes.
Query types
- Profile info: Get Twitter profile-level metrics.
- Tweet engagement: Measure the organic performance of your tweets.
Instructions
Make sure you've installed the Supermetrics add-on before you connect.
- Open a new Google Sheets file.
- Navigate to Extensions → Supermetrics → Launch sidebar to open Supermetrics.
- Click Create new query.
- Under Data source, select X Organic (Twitter).
- Choose to make this connection shared or private.
- Click Start.
- Log in to the Twitter account you want to fetch data from.
- Click Authorize app to allow the Supermetrics app to access your profile data.
- Select the accounts you'd like to include in your reporting.
- Navigate to Report configuration and select a query type.
Learn about advanced settings, best practices, and troubleshooting tips for Supermetrics for Google Sheets.
Make sure you've connected Supermetrics to Looker Studio before following the steps below.
- To start using X Organic (Twitter) in Looker Studio, click this link.
- You'll see two buttons that read Authorize. If you're using Supermetrics for the first time, click the left-hand one and log in with the Google Account you use with Supermetrics.
- Once that's done, or if you've done it before, click the right-hand Authorize button (under "X Organic (Twitter) requires authorization to connect to data").
- Select a team that has access to the account you want to connect.
- Choose to make this connection shared or private.
- Click Start.
- Log in to the Twitter account you want to fetch data from.
- Click Authorize app to allow the Supermetrics app to access your profile data.
- Select the accounts you'd like to include in your reporting.
- Select a query type, and click Next.
- In the pane's top right, click Connect.
- Click Create report.
- Click Add to report.
Learn about advanced settings, best practices, and troubleshooting tips for Supermetrics for Looker Studio.
Make sure you've installed the Supermetrics add-on before you connect.
- Open an Excel file.
- Click Data → Show Supermetrics.
- Under Data source, select X Organic (Twitter).
- Choose to make this connection shared or private.
- Click Start.
- Log in to the Twitter account you want to fetch data from.
- Click Authorize app to allow the Supermetrics app to access your profile data.
- Select the accounts you'd like to include in your reporting.
- Navigate to Report configuration and select a query type.
Learn about advanced settings, best practices, and troubleshooting tips for Supermetrics for Excel.
Follow these instructions to set up a transfer with Supermetrics for BigQuery (marketplace). See the instructions below for other data warehouse destinations.
Set up transfer for BigQuery (marketplace)
Make sure you've enrolled the data source before you connect.
- Log in to the Google Cloud Platform.
- Navigate to BigQuery → Data transfers.
- Click +Create transfer.
- Select the X Organic (Twitter) data source.
- Fill in the transfer details. See detailed instructions on how to set up a transfer.
- Under Third-party connection, click Connect source.
- Accept the agreement.
- Click Authorize with X Organic (Twitter).
- Log in to the Twitter account you want to fetch data from.
- Select the accounts you'd like to include in your reporting and define the transfer settings.
- Click Submit.
- Click Save.
Set up data warehouse transfer on the Supermetrics Hub
Make sure you've set up a data warehouse destination before you connect.
- Log in to the Supermetrics Hub.
- In the left-side menu, under Export, go to Data warehousing → Transfers.
- Click Create new.
- Select the X Organic (Twitter) data source.
- Fill in the transfer details. See detailed instructions on how to set up a transfer.
- In the Connections section, click Add new connection.
- Click Start.
- Log in to the Twitter account you want to fetch data from.
- Click Authorize app to allow the Supermetrics app to access your profile data.
- In the transfer setup view, select the accounts you'd like to include in your reporting.
- Click Create transfer.
- Log in to the Supermetrics Hub.
- In the left-side menu, under Export, click Power BI.
- Click Select data source.
- Select the X Organic (Twitter) data source.
- Click Start.
- Log in to the Twitter account you want to fetch data from.
- Click Authorize app to allow the Supermetrics app to access your profile data.
- Select the accounts you'd like to include in your reporting.
- Fill in the query details.
- Click Run query to test your query.
- Log in to the Supermetrics Hub.
- In the left-side menu, under Transform, click Query Manager (API).
- Select for Supermetrics API from the dropdown menu next to the page title.
- Click Select data source.
- Select the X Organic (Twitter) data source.
- Click Start.
- Log in to the Twitter account you want to fetch data from.
- Click Authorize app to allow the Supermetrics app to access your profile data.
- Select the accounts you'd like to include in your reporting.
- Fill in the query details. See detailed instructions on how to set up a Supermetrics API query in Query Manager.
- Click Run to test your query.
- Log in to the Supermetrics Hub.
- In the left-side menu, select Connect → Data sources.
- Scroll down to the list of data sources you haven't connected to. You see this list below your existing connections, under the title Connect to new data source.
- Hover over the X Organic (Twitter) data source, and click Connect.
- Click Start.
- Log in to the Twitter account you want to fetch data from.
- Click Authorize app to allow the Supermetrics app to access your profile data.
- Select the accounts you'd like to include in your reporting.