knitr::opts_chunk$set( fig.align = 'center', collapse = TRUE, comment = "#>", fig.path = "man/figures/README-")
Rinstapkg is an R package that connects to the Instagram API using tidy principles. Rinstapkg is short for the Real Instagram Package. With this package you can like, comment, follow, and slide into some DMs just like the real Instagram. You can also get tons of feed data: user feeds, timeline feeds, location feeds and more! All this comes without the need to register for an application. Here are some of the package highlights:
ig_auth()
)ig_my_timeline()
, ig_get_user_feed()
, ig_get_hashtag_feed()
, and more!ig_get_followers()
, ig_get_user_tags()
, ig_get_media_comments()
, ig_search_users()
, etc.NOTE: With great power comes great responsibility. Use of this package means that you will not use it to spam, harass, or perform other nefarious acts.
# install from CRAN install.packages("Rinstapkg") # get the latest version available on GitHub using the devtools package # install.packages("devtools") devtools::install_github("eric88tchong/Rinstapkg")
If you encounter a bug or issue, please file a minimal reproducible example on GitHub.
First, load the Rinstapkg package and log in. There are two ways to authenticate:
It is recommended to use OAuth 2.0 if you apply for and are approved for an Instagram App. This way multiple users can use your app without having to explicity share their credentials with you. If you do not have an approved app, you can still use this package by providing your username and password.
library(Rinstapkg) # OAuth2.0 token authentication, which we won't use here #token_path <- here::here("tests", "testthat", "Rinstapkg_token.rds") #suppressMessages(ig_auth(token = token_path, verbose = FALSE)) # Username-Password authentication settings <- readRDS(here::here("tests", "testthat", "Rinstapkg_test_settings.rds")) ig_auth(username=settings$dev$username, password=settings$dev$password)
library(Rinstapkg) # Using OAuth 2.0 authentication ig_auth() # Using Basic Username-Password authentication ig_auth(username = "YOUR_USERNAME_OR_EMAIL_HERE", password = "YOUR_PASSWORD_HERE")
After logging in with ig_auth()
, you can check your connectivity by looking at
the information returned about your timeline (ig_my_timeline()
), inbox (ig_my_inbox()
),
or recent activity (ig_my_recent_activity()
). It should be information about you!
A simple function to start with is verifying that you can retrieve your timeline as
it would appear in the Instagramm app or online. This function returns data that
would appear in the authenticated user's timeline feed. By default, the data is
returned as a tidy tbl_df
where each row represents one post from the feed. If
you prefer to work with a list format, then just specify return_df=FALSE
as an
argument.
timeline_results <- ig_my_timeline() timeline_results
With the ig_get_followers()
function you can retrieve a tbl_df
of all the users
that follow a particular user. Just provide the user_id
of the account whose followers
you would like to get. NOTE: The Instagram APIs use Ids to retrieve information so
instead of giving the account's username (typically starting with an \@symbol), you
need to first grab the user_id
of that account using the username, then supply it
to the ig_get_followers()
function.
# Get Justin's Biebers beliebers! # Side Note: A belieber is a HUGE Justin Bieber fan. bieber_user_id <- ig_get_user_id("justinbieber") follower_results <- ig_get_followers(bieber_user_id) follower_results
In the example above you'll notice that we didn't retrieve all 100M+ followers that
Justin Bieber has. By default the function only returns the top 10 pages of followers,
but you can set the max_pages
argument equal to Inf
to return all of them. Caution:
This might take awhile!
# return all 100M+ followers of Justin Bieber follower_results <- ig_get_followers(bieber_user_id, max_pages = Inf)
With the ig_get_following()
function you can retrieve a tbl_df
of all the users
that a particular user is following. For example, Justin Bieber follows ~100 users. Who
are those lucky few?
following_results <- ig_get_following(bieber_user_id) following_results
Future methods to support:
ig_profile_picture_change()
ig_profile_picture_remove()
ig_profile_set_private()
ig_profile_set_public()
ig_profile_get()
ig_profile_edit()
ig_remove_self_tag()
ig_approve_friendship()
ig_ignore_friendship()
ig_ignore_friendship()
ig_upload_photo()
ig_upload_video()
ig_upload_album()
ig_direct_message()
ig_direct_share()
ig_follow()
ig_unfollow()
ig_block()
ig_unblock()
This application uses other open source software components. The authentication components are mostly verbatim copies of the routines established in the googlesheets package (https://github.com/jennybc/googlesheets). Methods are inspired by the Instagram-API-python library (https://github.com/LevPasha/Instagram-API-python) and Instagram-API library (https://github.com/mgp25/Instagram-API). We acknowledge and are grateful to these developers for their contributions to open source.
Use of this package means that you will not use it to spam, harass, or perform other nefarious acts. For more details on how to use the API please see this package's website at https://eric88tchong.github.io/Rinstapkg.
Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.