In this tutorial, we'll go over creating a simple Twitter bot that uses the API and tweet what happened today in history. We'll call it History Bot. You can find the repository with the full code . Today in History here Creating Your Twitter App Before getting started in the technical part, we first need to create a Twitter App. First, log in to with the Twitter account you want the bot to tweet from. Twitter Developer's portal Once you do that, go to create a new app. You can also find this under Projects & Apps > Overview > Create App. here You will be asked to enter information like the name of the app, description of the app, and what you will be using the app for. Once you're done, you'll be shown a set of keys. You don't need to save those keys yet, as we will regenerate them later. Just scroll down and click on App Settings. When you go to your app's dashboard, click on the Settings tab, then scroll down to App permissions. You will see that it says Read. We need to change that to Read and Write if we're going to be tweeting, so click on the edit button and choose Read + Write from the list, then click Save. Now, go back to the Keys and tokens page, scroll down to Access token & secret and click Regenerate. The reason we need to regenerate them is that the initial tokens are only for the Read permission and cannot be used to add a tweet, i.e. Write. Once you click Regenerate and get the new keys, make sure to save them as you can't see them later unless you regenerate again. You will also need to Regenerate the API key & secret if you don't have them. If you do, make sure to save them for later use as well. Creating The Bot Now we'll get to the technical part. We first need to initialize our project: mkdir history-bot cd history-bot npm init When you run , you will need to enter a few information like package name or description. You can also skip that and go with the default settings by running npm init npm init -y When you are done with the above commands you will have the skeleton of the project. Next, we will install the package for easy interaction with Twitter's API: twitter-api-client npm i twitter-api-client To use our tokens and API keys securely, we'll use the package. dotenv npm i dotenv Next, create file that should hold the following keys: .env TWITTER_API_KEY= TWITTER_API_SECRET= TWITTER_ACCESS_TOKEN= TWITTER_ACCESS_TOKEN_SECRET= : if you are using the repository's code, there's a file that you can rename to and add your keys in it. Note .env.sample .env Add the keys that you saved before in and save the file. .env Now, create which will hold our code. We will start the script by requiring the packages we will use: index.js ( ).config() {TwitterClient} = ( ) require 'dotenv' const require 'twitter-api-client' The first line ensures that we can use the variables we added in our file. .env Then, we will create a Twitter client using our credentials in : .env twitterClient = TwitterClient({ : process.env.TWITTER_API_KEY, : process.env.TWITTER_API_SECRET, : process.env.TWITTER_ACCESS_TOKEN, : process.env.TWITTER_ACCESS_TOKEN_SECRET }) const new apiKey apiSecret accessToken accessTokenSecret So let's go back to what we said the bot will do. The bot will fetch from the Today in History API what happened on this day in history, then it will tweet it to our account. To send the request to the API, we will need to install axios: npm i axios Let's take a little look at the API. A GET request to the endpoint will give us an object similar to this: https://history.muffinlabs.com/date So, the response is an object that has the properties , , and . Inside there's the property that holds an array of events that happened on this day in history. In this tutorial, we'll just tweet the first item in the array. date url data data Events We will add the following code to send the request to the API and retrieve the events: axios.get( ) .then( { data = response.data.data ? response.data.data : {} tweet (data.Events && data.Events.length) { tweet = + data.Events[ ].year + + data.Events[ ].text } { tweet = } }).catch ( { .error(err) }) 'http://history.muffinlabs.com/date' => response const let if //tweet the first event in the array 'Year ' 0 ' - ' 0 else 'Nothing happened today :)' //TODO send the tweet => err console Here's what we are doing here in details: We are sending a GET request to the endpoint, then we are getting the data through . Since the response object has the property data which holds Events, we are assigning it to a new variable data: response.data data = response.data.data ? response.data.data : {} const Next, we are setting the tweet that we will be sending. If in the data object received there's an property and that holds at least one item, we are setting the tweet to the year plus the text: Event (data.Events && data.Events.length) { tweet = + data.Events[ ].year + + data.Events[ ].text } if //tweet the first event in the array 'Year ' 0 ' - ' 0 If the Events property is not received or there are no events on this day, we will set the tweet into a default text: { tweet = } else 'Nothing happened today :)' We also added a catch to the GET request in case an error occurs: .catch ( { .error(err) }) => err console What is left is to use the Twitter client we created earlier to send the tweet to our account. We will use the method which can take many optional parameters (you can check out all the details ), but requires one parameter status which is the text of the tweet. twitterClient.tweets.statusesUpdate here This will be the code to send the tweet: twitterClient.tweets.statusesUpdate({ : tweet }).then ( { .log( , response) }).catch( { .error(err) }) status => response console "Tweeted!" => err console If the tweet goes through, we will log to the console "Tweeted" with the response object. If an error occurs, we will log to the console the error. Now, our script should look like this: ( ).config() {TwitterClient} = ( ) axios = ( ) twitterClient = TwitterClient({ : process.env.TWITTER_API_KEY, : process.env.TWITTER_API_SECRET, : process.env.TWITTER_ACCESS_TOKEN, : process.env.TWITTER_ACCESS_TOKEN_SECRET }) axios.get( ) .then( { data = response.data.data ? response.data.data : {} tweet (data.Events && data.Events.length) { tweet = + data.Events[ ].year + + data.Events[ ].text } { tweet = } twitterClient.tweets.statusesUpdate({ : tweet }).then ( { .log( , response) }).catch( { .error(err) }) }).catch ( { .error(err) }) require 'dotenv' const require 'twitter-api-client' const require 'axios' const new apiKey apiSecret accessToken accessTokenSecret 'http://history.muffinlabs.com/date' => response const let if //tweet the first event in the array 'Year ' 0 ' - ' 0 else 'Nothing happened today :)' status => response console "Tweeted!" => err console => err console We are ready to run the script to send the tweet now. Go to and add inside the start script: package.json scripts : { : }, "scripts" "start" "node index.js" Then, in your terminal or command line run: npm start If all steps are done correctly, you will see in your console "Tweeted" with the response object. You can also go to the account you created the app from on Twitter and you will see your tweet! If you encounter an error related to authentication or authorization, make sure that all your keys and tokens are correct and make sure that you have enabled the Read + Write permissions. Conclusion Congrats, you've created your first Twitter bot! I suggest you go through and the package as well to see what more you can do with your Twitter bot. Twitter's documentation twitter-api-client This article was originally published on my personal blog . Previously published at https://blog.shahednasser.com/simple-twitter-bot-tutorial-with-node-js/
