How to create a Twitter Source

Supported Twitter Sources

Buzzspark supports the following Twitter Sources:
User – aggregates all tweets by a specific Twitter user
Hashtag – aggregates all tweets containing a specific hashtag
Mention – aggregates all tweets where a specific user has been @mentioned
List – aggregates all tweets by members of a specific Twitter list
Search – aggregates all tweets containing specific keyword(s)
Geo-Radius – aggregates all tweets originating within a given radius from a specified location

Refer to the following article if you want to import a single tweet.

Before you can start aggregating content from Twitter, your Buzzspark account must have at least one valid connection with a Twitter account.

Creating a Twitter Source

Step 1: Navigate to Sources

From the left menu, browse to Content > Sources

Step 2: Click to create add a new source

Click on the + Source button on the top right. This launches the Create New Source window. The tabs along the top in this window and the features within each tab may vary depending on the type of content you wish to ingest from Twitter. Each of the tabs are detailed in the following steps.

Step 3: General tab

Source Name (required)
Enter a short name to help you identify this Source e.g. Official.

Network (required)
From the drop-down list, select Twitter.

Type (required)
From the drop-down list, select the type of content you wish to aggregate from Twitter e.g. User. See Supported Twitter Sources.

The next field refers to the Term of the Source and depends on your choice for Type earlier.

If Type is set to User, an @username is required.

If Type is set to Hashtag, a #hashtag is required.

If Type is set to Mention, an @username is required.

If Type is set to List, a list URL is required.

If Type is set to Search, one or more keywords are required. In addition, you can optionally specify an Exact Match. By default, Twitter search matches all keywords that you enter in any order. Select this checkbox if you want to search for the exact phrase that you have entered.

If Type is set to Geo-Radius, a geo-location and radius are required. These can be entered in the highlighted fields or by dragging the marker and radius handles as shown below.



Tags (optional)
Click in the Tags field and start typing the name of an existing Tag you want to add to all tweets aggregated by this Source. You can also click on the Add New Tag button to create and add a new Tag. Tags help you group content to simplify moderation and to filter content to show on different Displays. Learn more about Tags.

At this point you could click on the Save and Close button to save the new Source and start aggregating content, however we recommend you explore the additional steps below that guide you through advanced features for refining and filtering content that is aggregated, auto moderation, aggregating historical content and scheduling.

Step 4: Advanced tab

Include ReTweets by this user or Include ReTweets that meet this Source criteria
Retweets are excluded by default. Select this checkbox if you want to aggregate ReTweets. This option is not applicable for Type: Geo-Radius. A ReTweet is a re-post (or share) of a someone else’s Tweet. See https://help.twitter.com/en/using-twitter/retweet-faqs.


Exclude Tweets by this user containing @mentions
@mention tweets are included by default. Select this checkbox to exclude any tweets by this user that contain any @mentions. This option is only applicable for Type: User. A mention includes a user’s @username information in the Tweet.

Include Reply Tweets by this user or Include Reply Tweets that meet this Source criteria
Reply tweets are excluded by default. Select this checkbox to include any Reply tweets. This option is not applicable for Type: Geo-Radius. A reply is a response to another person’s Tweet. See https://help.twitter.com/en/using-twitter/mentions-and-replies.


Include replies made to Tweets by this user
Replies by other users to tweets of the selected user are excluded by default. Select this checkbox to include replies (from other users) to tweets by this user. This option is only applicable for Type: User. A reply is a response to another person’s Tweet. See https://help.twitter.com/en/using-twitter/mentions-and-replies.

Only include Tweets from Verified accounts
Select this checkbox to only aggregate tweets from verified accounts. This also applies to all options above.

Only aggregate Tweets by users with a minimum number of followers
Only aggregates tweets form user with the specified number or more followers. Enter 0 (zero) to aggregate all tweets regardless to the number of followers. This option is not applicable for Type: Geo-Radius or User.

Filter by users and Filter Type
Allows you to filter aggregation based on a Whitelist or Blacklist of specified users. This option is not applicable for Type: Geo-Radius or User.

Whitelist
Specify a list of @usernames separated by a comma. Only tweets from these users will be aggregated.

Blacklist
Specify a list of @usernames separated by a comma. Tweets from these users will be disregarded and all other tweets will be aggregated.

Additional keyword filtering
Any hashtags or keyword entered here will be used to further filter all content that is aggregated via this Source

Only aggregate content that includes any of the following hashtags or keywords
If a tweet does not contain any of the specified keywords, it will not be aggregated, regardless to any preceding settings.

Do not aggregate content that includes any of the following hashtags or keywords
If a tweet contains any of the specified keywords, it will not be aggregated, regardless to any preceding settings.

Use partial matching
By default, only exact matches of any keywords you specify are filtered. If you enable partial matching, the match criteria are expanded so filtering for "bread" will also match "gingerbread" and "breadcrumb".

Enable Back-Off
This setting automatically optimises aggregation based on activity levels for this Source and we recommend leaving it selected.

Step 5: Moderation tab

Settings under the Moderation tab are common to Sources for all Networks. See Banned Word Filter and Auto-Moderation features in Buzzspark for further details.

Step 6: Language Settings

Enable Language Filtering
You can filter content to be aggregated by one or more languages and optionally select one language to be the Fall-back language – this is the assumed language for a post if its original language cannot be accurately determined.

When the language of a tweet can be accurately determined and matches one of your selected languages, the tweet will be aggregated, otherwise the tweet will be discarded.

When the language of a tweet cannot be accurately determined, it's language is set to the Fall-back language and the tweet is aggregated. If you have not selected a Fall-back language, the tweet is automatically discarded.

Step 7: Aggregation tab

Settings under the Aggregation tab are common to Sources for all Networks. See enabling and disabling a Source, aggregating Historic content from social networks, and how to schedule aggregation of content from social networks for further details.

Saving or Discarding changes to a Source

You can click on the Close, Save and Close or Save buttons at the bottom at any time.
Close– closes the Source page without saving and changes since the last Save.
Save and Close – saves any changes and closes the Source page
Save – saves any changes without closing the Source page

Updated on: 03/02/2023