X (formerly Twitter)

In this article, we will cover:

• Overview of X (formerly known as Twitter) 
• How to add an X Integration
• How to add an X Account
• Important information about adding X feeds
• How to add an X Hashtag
• How to add an X Username feed
• How to add an X Likes feed
• How to add an X Lists feed
• How to add an X Advanced feed
• How to edit an X to only ingest media
• How to edit the label on an X feed
• How to delete an X feed
• How to change the settings on an X Feed
• How to pause or unpause an X feed
• FAQ 
  • Missing Tweets

Overview of X (formerly known as Twitter)

Adding a X connection will keep your TINT updated with the latest trending tweets around the world.  Pick between hashtags, pulling tweets or likes from specific usernames, or tweets from list based on topics or interests.  Or choose Advanced and build your own X query to pull in specific tweets based on your needs.

X has 5 different feed options you can select to refine your results. These include Hashtag, Username, Likes, List, and Advanced.

How to add an X Integration

To add a X feed, you will need to add your X account via Integrations from the 1st June 2023. To find out more on this and how to get your Client ID and Secret information, click here.

To do this:

1. 1. Navigate to your name in the right-hand corner
   2. Click on Team Settings
   3. On the left-hand side, click on Integrations in the list
   4. Click on +Add
   5. Select X and click Connect
   6. Enter the previously saved Client ID and Secret for API v2 
   7. Enter the previously saved Client ID and Secret for API v1.1

Once completed, you are now ready to add an X feed to your TINT board. 

How to add an X account

1. Navigate to your name in the right-hand corner
2. Click on Team Settings
3. On the left-hand side, click on Social Accounts in the list
4. Click on +Add
5. Select X and click Connect
6. This will either bring up to add your X Integration.  Click here on how to do this or it will go to the authorization page for X if you have already added your X Integration. Click Authorize App
7. This will automatically add the X account to your list

Important information about adding X feeds

Due to the change to the individual integrations for platform X, there may be variances in how your X Developer account functions. This is dependent on the account version that you have signed up for and accounts may have different features. Also there may be differences in the rate limits that you have access to.  

With this in mind, it’s important to be aware of your accounts' rate limits. Rate limits are set to prevent overwhelming the system with too many requests in a short period. If too many feeds are added at once, your integration may exceed the limit, which can cause the feeds to fail or break. The rate limit status may take a significant amount of time to reset, depending on the extent of the violation. To prevent this, it’s advisable to stagger the addition of feeds. If you're preparing for an event, it's best to add the feeds a few days in advance to allow time for the rate limit to refresh.

How to add an X Hashtag feed

On this feed, enter a hashtag that has been active in the last 7 days to pull the tweets that you want to see.

1. Click on the X symbol
2. Select Hashtag
3. Click Next
4. Select your account from the dropdown or add your account
5. Pick your hashtag
6. Leave ticked or unticked if you want to only ingest posts that contain media
7. Leave ticked or unticked if you want manual moderation or auto-moderation on
8. Click Add Social Feed

How to add an X Username feed

On this feed, enter the username that you want to pull the tweets from.  The feed is limited to 250 posts on the first pull.

1. Click on the X symbol
2. Select Username
3. Click Next
4. Select your account from the dropdown or add your account
5. Type in the username that you want to pull content from
6. Leave ticked or untick if you want manual moderation or auto-moderation on
7. Click Add Social Feed

How to add an X Likes feed

1. Click on the X symbol
2. Select Likes
3. Click Next
4. Select your account from the dropdown or add your account
5. Type in the username that you want to pull the likes from
6. Leave ticked or untick if you want manual moderation or auto-moderation on
7. Click Add Social Feed

How to add an X Lists feed

1. Click on the X symbol
2. Select Lists
3. Click Next
4. Select your account from the dropdown or add your account
5. Type in the username that you want to pull the likes from
6. Type in the list URL you want to pull from
7. Leave ticked or untick if you want manual moderation or auto-moderation on
8. Click Add Social Feed

Please beware that the lists feed may only work on certain types of X developer accounts.

How to add an X Advanced feed

The best way to build a query and test if it’s valid and will return matched Tweets is to first try it at https://twitter.com/search-advanced. If the query returns results, you can simply insert the query as-is into the advanced query field when adding a X "Advanced" connection.  To learn more about this X Advanced feature, please have a look at https://developer.twitter.com/en/docs/twitter-api/tweets/search/integrate/build-a-query. 

The following is a list of public X search operators to help you in building your queries with some examples below:

Operator	Finds tweets...
x search	containing both "x" and "search". This is the default operator.
"happy hour"	containing the exact phrase "happy hour".
love OR hate	containing either "love" or "hate" (or both).
beer -root	containing "beer" but not "root".
#haiku	containing the hashtag "haiku".
from:alexiskold	sent from the username "alexiskold".
to:techcrunch	sent to the username "techcrunch".
@mashable	referencing the username "mashable".
geocode:"29.4241,-98.4936,15mi"	search for tweets in San Antonio, using latitude, longitude, search radius (mi or km)
"happy hour" geocode:"29.4241,-98.4936,15mi"	containing the exact phrase "happy hour" and sent with 15 miles of San Antonio.
superhero since:2010-12-27	containing "superhero" and sent since date "2010-12-27" (year-month-day).
ftw until:2010-12-27	containing "ftw" and sent up to date "2010-12-27".
hilarious filter:links	containing "hilarious" and linking to URLs.
news source:"Twitter Lite"	containing "news" and entered via Twitter Lite

If you would like to use more than one operator in a search, you will need to add (parenthesis) around each operator. 

1. Click on the X symbol
2. Select Advanced
3. Click Next
4. Select your account from the dropdown or add your account
5. Type in the query you want to look for
6. Leave ticked or untick if you want manual moderation or auto-moderation on
7. Click Add Social Feed

How to edit an X feed to only ingest media

This feature is switched on for all new feeds but if you have an older feed, you can change it so you no longer ingest text X and receive media only.  This option is only available on Hashtag and Advance X feeds.  

1. Go to the feed you would like to edit
2. Click on the Settings cog
3. Click on Change Settings
4. Tick Only ingest posts that contain media option
5. Click on Add Social Feed to update

This will change the feed from this point onwards.  

 

How to edit the label on an X feed

By default, the label for the feed itself will be either the hashtag, username, list, or advanced query you have put in when you set up the feed but you can change this to whatever you wish.  

1. Go to the feed you would like to edit
2. Click on the Settings cog
3. Click on Edit Name
4. Rename the feed to what you would like it to be 
5. Click on the tick to confirm or the x to cancel
6. Your feed should be renamed

How to delete an X feed

1. Go to the feed you would like to edit
2. Click on the Settings cog
3. Click on Remove Feed
4. A pop-up notification will appear with Are you sure? All content on this social feed will be deleted and cannot be recovered. Re-adding the exact feed will not recover these posts.  You will be presented with two buttons - No, Keep Feed or Yes, Delete Feed
5. The feed should disappear if you pressed Yes, Delete Feed

How to change the settings on an X feed

When you set up the X feed, you get two options (moderation and ingest media content that you can change later when the feed is set up.  To change these settings:

1. Go to the feed you would like to edit
2. Click on the Settings cog
3. Click on Change Settings
4. You can untick or tick the following two options: Only ingest posts that contain media and/or I would like to manually approve posts before they appear publicly on my TINT.
5. Click Add Social Feed once you have changed the settings you would like

How to pause or unpause an X feed

You can pause or unpause your X feed if you don't want to ingest content or want to restart ingesting content.

To Pause the feed:

1. Go to the feed you would like to pause 
2. Click on the pause icon to pause the feed
3. A popup box will say Are you sure? All content on this social feed will be paused and no new content will be ingested until its is un-paused
4. Click on Yes, Pause Feed
5. This will Pause the feed

To Unpause the feed:

1. Go to the feed you would like to unpause
2. Click on the Play icon to unpause the feed
3. This will unpause the feed

FAQ

Missing Tweets

When you first connect an X hashtag (or Advanced query) in TINT, X's API will only return Tweets from the last 7 days or less. This is a limitation of X's API that we cannot work around. However, once an X hashtag connection is made in TINT, we’ll continue to pull in content from that point forward.

If you run into any issues or have questions regarding X, please don't hesitate to contact Technical Support at support@tintup.com.