Twitter

In this section, we present how to connect Twitter accounts to MindsDB.

Twitter is a widely recognized social media platform and microblogging service that allows users to share short messages called tweets.

The Twitter handler enables you to fetch tweets and create replies utilizing AI models wthin MindsDB. Furthermore, you can automate the process of fetching tweets, preparing replies, and sending replies to Twitter.

Prerequisites

Before proceeding, ensure the following prerequisites are met:

1. Install MindsDB locally via Docker or Docker Desktop.
2. To connect Twitter to MindsDB, install the required dependencies following this instruction.
3. Install or ensure access to Twitter.

Connection

To connect a Twitter account to MindsDB, you need a Twitter developer account.

We recommend you use the Elevated access allowing you to pull 2m tweets and to avoid parameters or authentication issue error you might get sometimes. You can check this step-by-step guide describing how to apply for the Elevated access. </Tip>

If you don't already have a Twitter developer account, follow the steps in the video below to apply for one.

Begin here to apply for a Twitter developer account

Watch this step-by-step video explaining the process.

When presented with questions under How will you use the Twitter API or Twitter Data?, use answers similar to the ones below (tweak to fit your exact use case). The more thorough your answers are, the more likely it is your account will get approved.

Intended Usage (In Your Words)

I have a blog and want to educate users how to use the Twitter API with MindsDB.

I will read tweets that mention me and use them with MindsDB machine learning to generate responses. I plan to post tweets 2-3 times a day and keep using Twitter like I normally would.

Are you planning to analyze Twitter data?

I plan to build machine learning algorithms based on Twitter data. I am interested in doing sentiment analysis and topic analysis.

I will potentially extract:

• Tweet text
• Favorite count and retweet count
• Hashtags and mentions

Will your app use Tweet, Retweet, Like, Follow, or Direct Message functionality?

I will use the Twitter API to post responses to tweets that mention me.

I will have word filters to make sure that I never share offensive or potentially controversial subjects.

Do you plan to display Tweets or aggregate data about Twitter content outside Twitter?

I plan to share aggregate data as examples for users of my upcoming blog. I don't intend to create an automated dashboard that consumes a lot of Twitter API calls.

Every API call will be done locally, or automated on a simple web server. Aggregate of data will be for educational purposes only.

Will your product, service, or analysis make Twitter content or derived information available to a government entity?

Answer NO to this one. </Accordion>

If you already have a Twitter developer account, you need to generate API keys following the instructions below or heading to the Twitter developer website.

Once you have all the tokens and keys, here is how to connect your Twitter account to MindsDB:

CREATE DATABASE my_twitter 
WITH 
    ENGINE = 'twitter',
    PARAMETERS = {
      "bearer_token": "twitter bearer token",
      "consumer_key": "twitter consumer key",
      "consumer_secret": "twitter consumer key secret",
      "access_token": "twitter access token",
	  "access_token_secret": "twitter access token secret"
    };

Usage

The my_twitter database contains a table called tweets by default.

Here is how to search tweets containing mindsdb keyword:

SELECT id, created_at, author_username, text 
FROM my_twitter.tweets 
WHERE query = '(mindsdb OR #mindsdb) -is:retweet -is:reply'
AND created_at > '2023-02-16' 
LIMIT 20;

Alternatively, you can use a Twitter native query, as below:

SELECT * FROM my_twitter (
  search_recent_tweets(
    query = '(mindsdb OR #mindsdb) -is:retweet -is:reply',
    start_time = '2023-03-16T00:00:00.000Z',
    max_results = 2
  )
);

Here is how to write tweets:

INSERT INTO my_twitter.tweets (reply_to_tweet_id, text)
VALUES 
    (1626198053446369280, 'MindsDB is great! now its super simple to build ML powered apps'),
    (1626198053446369280, 'Holy!! MindsDB is the best thing they have invented for developers doing ML');

Check out the tutorial on how to create a Twitter chatbot to see one of the interesting applications of this integration. </Tip>