Introduction
This tutorial will walk through what you need to get started with the programming language R and the Twitter API v2. Using R to connect to the user lookup endpoint, I’ll show how to work with JSON returned from the Twitter API. User lookup is a GET method and returns information about a user or group of users, specified by a user ID or a username.
If you aren’t familiar, R is one of the most popular languages for common Data Science tasks like time-series analysis, modeling, visualization, and other data analysis, and is often used in conjunction with the Twitter API. With the user lookup endpoint, you can use the user object to determine a correlation between the number of followers a person has and the sentiment score of their bio. The user object may also be used to map a group of accounts based on the location publicly listed in their profiles.
Getting started with the Twitter API
Before you can use the Twitter API v2, you will need to sign up for adeveloper account.
Once you have an approved developer account, you will need to first create aProject. Projects allow you to organize your work based on how you intend to use the Twitter API, so you can effectively manage your access to the API, and monitor your usage.
Each Project contains anApp, with which you can generate the credentials required to use the Twitter API. You can learn more about how to get started with the Twitter API, in thegetting startedsection of our documentation.
Getting your R environment set up
First, you need todownload Rwhich you can do on thecran website.
After, to set up an environment to work with R, you can useR studio, the R extension pack forVisual Studio Code, or aJupyter notebookif you come from the Python world.
Setting up your environment variable
For the code examples, I’m going to be showing today, you will want to create an environment variable for your bearer token. The Bearer Token is what allows you to authenticate to the Twitter API and start making requests. First, replace “your-bearer-token” with your own bearer token, which can be obtained from the keys and tokens section of your App in the developer portal. You’ll need to run this line of code in the console before you start writing a script.
You can now begin writing your R script to connect to the API. At the top of the file, call the packageshttr,jsonlite, anddplyr.
The first step in your code sample is to get set up to authenticate to the Twitter API. Grab the Bearer Token you pulled from your App, and pass that into your headers for authentication. In the below example, replace $BEARER_TOKEN with your token.
Once you got your authentication set up, define the parameters of your request. By default, you will get back the id, name, and username of each user you get back. You can make adjustments to this payload by adding additionalfieldsandexpansions. For this example, you will want the profile bio of the user which is requested using user.fields=description, and an expansion that contains the pinned Tweet of the user.
Now you are ready to format your URL with the Twitter handle, also known as account, you are looking to get more information about. Use thereadlinemethod to allow this sample to be reusable. After you type the handle you want to look at, format your URL to contain the handle you define by replacing $USERNAME with the desired Twitter handle.
At this point, use thehttrpackage to make a GET request to the URL you just created, pass in our authentication credential via the header, and pass in the parameters you defined. You can save the response as a text object in the variable obj and print this out to view the result of the request you made.
Working with our JSON payload
One of my favorite ways to work with a JSON is to use a data frame, which allows you to easily access complex nested data. To do this, use thefromJSONmethod of thejsonlitepackage to flatten your file to allow the fields to be in the same object. Then, pass that object into a data frame. Now you are ready to view this data frame.
You can access the fields of the data from the data frame and pass them into a string that has the handle, the username, and bio.
Usecatinstead of print to view the object with newlines between each field you are pulling.
If you had multiple handles you made requests for, you could easily use a loop to access each data frame element.
Conclusion
Hopefully, this tutorial can be a starting place to work with R and the Twitter API. As a next step, you may want to look at our R samples for recent search, Tweet lookup and user lookup in ourv2 sample code. Be sure to let us know on theforumsif you run into any troubles along the way or Tweet us at@TwitterDevif this tutorial inspires you to create anything.
