This guide will walk you through how to create a Basic App on X, so you can pull in UGC content from X.
About the X API
Twitter has depreciated their longstanding free API, instead introducing API v2 (requiring paid access).
In order to "read" tweets to display them on your UGC streams, you will need to set up a Basic Plan
Gist on the Basic Plan
Twitter's Basic API plan will give you the ability to pull up to 10,000 tweets/month to showcase on your UGC streams. To see Twitter's full spread of plans, you can visit their website here.
How to set up a Basic API Plan
1. Log into your Business Account for X
Log into the business account you use for X.
2. Go to your developer portal
Once you are logged in, go to this link
If you need to create an X developer account click here
3. Create a new App
Choose Basic API Plan and click Subscribe
4. Fill out the Developer Agreement & Policy
Under the section labelled "Describe all of your use cases of Twitter's Data and API" please copy and paste the following:
Tweets and Twitter content will be pulled in and displayed on a microsite used to aggregate all social content related to one of our events/promotions. This includes:
-Collecting tweets from fans using specific hashtags
-Approving and display Tweets from fans on an external source which may include: A jumbotron screen, an external display screen, or embedded into a website.
Twitter content will be displayed at row level.
Once you have input the above paragraph, agree with Twitter's Terms & Conditions and click Submit
5. Set up your Billing Information
6. Choose "Production" as your App Environment
When setting up your App, choose "Production" as your App Environment
7. Give your App a Name
Name your App. We recommend the following format:
your business name(lowercase) - tbits2023
8. Copy all Keys & Tokens
On your final stage of App creation, you will be given a page with the following keys/tokens:
- API Key
- API Key Secret
- Bearer Token
Make sure to copy all three of these keys/tokens down to share with your partner success team at Tradable Bits. This is the only time all 3 will be visible to you
All three are required in order for us to connect your Twitter App with Tradable Bits. If you forget to copy these credentials down during app creation, you will need to regenerate them.
9. Give your Customer Success Team all Keys & Tokens you have copied.
Forgot to copy these credentials during app set up? No worries. Simply click into the settings of your app > Keys and Tokens, then regenerate your tokens to share with your Customer Success team.
You should now have a working X App. Use the Developer Dashboard to keep track of how you are pacing against your Monthly Post Usage Cap.
FAQS
Q: What if I don’t purchase an app?
A: If you choose not to purchase a plan, you will no longer be able to pull posts for UGC in Tradable Bits (all X related UGC/Stream functions on Tbits will be disabled). However, UGC collection will still be usable for other available networks (IG etc).
Q: Ok, I’ve purchased our plan and set up our app. Now what?
A: Please share the app credentials (API key, secret and bearer token) with your Customer Success Manager who will hook it up to your Tradable Bits account. By purchasing your own Basic plan, X will be enabled again as part of UGC with a maximum of 10K posts retrievable per month.
Q. Why isn’t Tradable Bits setting up the app and paying for them as part of our annual subscription?
A: Since X has depreciated their longstanding free-access API while significantly limiting the scale of usage on its new paid API, our Tradable Bits application will no longer be able to service the volume of posts and costs required by most of our partners. As a result, the best solution here is for each partner to setup and pay for their own X API app should they wish to continue using this functionality.
For more information on set up, check out this API access guide and how to make your first request guide from X.
Please reach out to your Customer Success team if you have more questions!