As previously communicated, our Twitter data source connectors are going through major changes in May.
The Twitter Premium data source connector remains available, but due to Twitter policy changes, it's required that our customers purchase an additional Twitter Enterprise API subscription from Twitter directly. The required subscription starts from 42,000 USD per month.
The change to Twitter Premium will come into effect on May 31, 2023. You can take steps now to set up your own Twitter Enterprise API subscription so you can switch over on May 31 and keep existing queries running. Otherwise, queries will stop working.
Alternatively, you can switch to using the Twitter Organic connector. This will require you to recreate your queries using the new connector, but this does not require any additional API subscriptions from Twitter. See this article for more details about the new Twitter Organic data source connector.
What is required
You'll need the following items on May 31 to successfully log in to and use the Supermetrics Twitter Premium data source:
- A Twitter developer account
- A valid subscription to Twitter's Enterprise API access (starting from 42,000 USD a month)
- A live Twitter application (app) tied to your developer account
- The API client ID and secret for that app so you can log in to Supermetrics
- A Twitter Premium license for Supermetrics, with Historical Tweets report feature enabled
This article instructs you on how to get set up with the required items. We can also assist you with the process of obtaining and setting up the Twitter Enterprise API. Please reach out to your Customer Success Manager or to our support team.
Instructions
If you don't have one already, the first step is to create the developer account that will be linked to your Twitter Enterprise subscription and your app that will be used by the data source.
- Go to Twitter Developer Platform.
- Log in with the Twitter profile you want to have your Enterprise API subscription attached to.
This should automatically create a developer account for your profile. - If you check your Twitter Developer Portal dashboard now, you should have a project and an app with the Free tier.
Now you're ready to set up Enterprise API access!
Once you have your developer account, you can start the process of subscribing to Twitter's Enterprise API access. This level of API access starts at 42,000 USD, with larger packages costing more.
- First, fill in the Twitter Enterprise API Interest Form.
- Once that's complete, a Twitter account manager or sales representative will reach out to you to continue the process.
Once your Enterprise subscription is activated, you can configure your app and gather the API keys needed to log in later.
- Go back to your Twitter developer portal.
- You should see at least one project and one project app. This project should be under "Elevated" to show it has Enterprise API access.
On the project app, click the cog-icon to open the app settings.
- Under User authentication settings, click Edit.
- Set App permissions to "Read".
- Leave Type of App unchecked.
- Under App info:
- Set the Callback URI / Redirect URL to https://supermetrics.com/login-complete/.
- Set Website URL to your own website.
- Set the Organization name to your own company name.
- The rest are optional and can be skipped if you wish.
- Click Save.
- Back on the Settings page, go to the Keys and tokens tab.
- Under the Consume Keys section, click Regenerate.
- You'll get a popup with your API key and API key secret. Copy them for later use — these two values are needed to log in to the Twitter Premium data source.
Store the API key and API key secret securely
Treat the API key and API key secret like a username and password. Save them securely, such as in a password vault, in case you need to reconnect later. This information is only shown once — if you lose them, you'll need to regenerate them and log in to the data source again with the new keys.
With your API key and API key secret saved, you're now ready to log in to the data source on May 31, when the changes take place!
Actions to take on May 31 to keep queries running
When the changes are live on May 31, you'll need to take the following steps to ensure your API keys are in our system and keep existing queries running.
- Open the data destination of your choice, or go to the data source management page on the Supermetrics Hub.
- In the Data Source list, pick Twitter Premium.
If you don't see this option, please contact our support team so we can add you to the whitelist to see the data source. - Click + Add connection.
- Fill in the fields — all are required.
- Client ID: the API key from your Twitter app
- Client Secret: the API key secret from your Twitter app
- Choose to make this connection shared or private.
- Click Start.
- If the keys are correct, you're asked to log in to the Twitter profile you want to get data for. Enter the credentials for that profile, and click Authorize app.
Repeat steps 2-7 for additional profiles you want to connect. - Finally, follow the steps here to replace your old Twitter Premium connection to use the new API key login.
Now your existing queries should automatically update to use the API key login!