Botinsta Build Status Gem Version


This is a tag-based Instagram bot I've created under the influence of other cool Instagram bots and instabot.rb to improve my Ruby skills.

What do you mean tag-based?!

Well, tag-based means that the bot works based on solely the tags you specified. You specify the tags you want the bot to like medias and follow users from and it loops through all tags liking a number of medias specified by you and also following the owners of medias it liked. See how it works


Since this bot uses a local database to track follows and media likes. You need to install libsqlite3-dev.

$ sudo apt-get install libsqlite3-dev

Add this line to your application's Gemfile:

gem 'botinsta'

And then execute:

$ bundle

Or install it yourself as:

$ gem install botinsta


  • Follow
  • Like
  • Unfollow people followed ~~after a day~~ whenever you want. Creates a local database for that matter.
  • Avoid liking medias which has blacklisted tags

Features to come

  • Comments
  • Unlike medias
  • Avoid following blacklisted users

I am still not sure what else to add but if you have any idea don't hesitate to hit me up or send me a pull request!

Usage & How it works

You can use the bot simply like below. It already has default parameters so you could just input your username and password and let it use the defaults for the rest.

require 'botinsta'

bot = ({ username: 'YOUR_USERNAME',
                      password: 'YOUR_PASSWORD',
                      tags:              ['photography','vsco','bnw'],
                      tag_blacklist:     ['nsfw','sexy','hot'],
                      likes_per_tag:     20,
                      unfollows_per_run: 200,
                      follows_per_tag:   10,
              unfollow_threshold:  {    seconds: 0,
                                                minutes: 0,
                                                hours:   1,
                                                days:    0


IMPORTANT: First of all this bot doesn't work on a daily basis. It just loops through all the tags given to it and accomplishes its task. This is all it does. If you want to reuse it, you should run it again or look for other automation techniques to run this bot everyday (i.e. crontab or some other techniques) until I figure out a logical method to implement this feature. I will also add techniques of how to run this bot everyday with the help of crontab and other automation tools.

The bot loops through each tag liking as many images as @likes_per_tag and following as many users as @follows_per_tag.

Liking medias and following users from the tag's first page is easy because all you have to do is:

to navigate to above link and get the JSON string then parse it accordingly to extract necessary information (i.e. media ID, owner ID).

It gets complicated when you liked all the medias on the first page and need to get the next page—with next page I am referring to when you scroll down the page to load more content—to continue extracting data, liking medias & following users. So we can do the same with a GET request instead since we are using Mechanize for automation.

To get the next page you need two things:

  • query_id (query_hash)
  • end_cursor

which will be used in GET requests to get the JSON string for the next page.

An example of the link:{"tag_name":"photography","first":4,"after":"AQAiksCP1Uzk5-bXZ3qnwUsA89YRn1LBia9_yDFeWm5S1KTfzyU8eH8EFjq8LPuFOemdkRjzWb8_5vmyQ8Gnj-sTCfVGwRHs8WoKhPtBncmLbg"}

As you can see we need to provide the query_id (query_hash) and end_cursor (the same as after) in the link.

We get the above parameters with the help of methods in the module Pages.

The rest is just doing the same controls in a loop to like, follow & unfollow (just for now).

TODO: More detailed explanation will be here.


I will eventually complete all method descriptions and usages. You can help me if you would like to!


After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to

Gems used

  • Colorize
  • Hashie
  • Json
  • Mechanize
  • Nokogiri
  • Sequel
  • Sqlite3

Contributing :star:

Bug reports and pull requests are welcome on GitHub at

If you like the bot and want to see the new features very soon, please do not forget to star:star2: the repo to let me now you are interested. Boost me! :rocket: :blush:


The gem is available as open source under the terms of the MIT License.