README.md

instabot

Cool instagram scripts for promotion and API wrapper. Written in Python.

---

As you may know, Instagram closed it's API in summer 2016. This Python module can do the same thing without any effort. Also it has lots of example scripts to start with.

If you have any ideas, please, leave them in issues section or in our telegram chat.

Your Contribution and Support through Stars will be highly appreciated.

How to install and update

Install latest stable version or update current from pip

pip install -U instabot

Full installation steps for UNIX (Linux, macOS) users here.

If you are Windows user, go to Windows installation.

How to run

Choose any script from examples and run

python example.py

If you have any problems with script, please ask questions in telegram chat.

Docker

As long as docker is running on your machine you can build an instabot docker image like this

docker build -t instabot .

Then run your image with an example or your custom script:

docker run --name instabot -p 80:80 -i -t instabot python examples/like_example.py

Implemented bot methods

from instabot import Bot
bot = Bot()

Bot Class

from instabot import Bot
bot = Bot(
            max_likes_per_day=1000,
            max_follows_per_day=350,
            max_unfollows_per_day=350,
            max_comments_per_day=100,
            like_delay=10,
            follow_delay=30,
            unfollow_delay=30,
            comment_delay=60,
            whitelist=False,
            blacklist=False,
            comments_file=False
)

parameter	description	example
max_likes_per_day	How many likes will bot put per day	max_likes_per_day = 1000
max_follows_per_day	Max number of follow per day	max_follows_per_day = 350
max_unfollows_per_day	Max number of follow per day	max_unfollows_per_day = 350
max_comments_per_day	Max number of comments per day	max_comments_per_day = 100
like_delay	Delay between likes in seconds	like_delay = 10
follow_delay	Delay between follows in seconds	follow_delay = 30
unfollow_delay	Delay between unfollows in seconds	unfollow_delay = 30
comment_delay	Delay between comments in seconds	comment_delay = 60
whitelist	Path to the file with user_ids that shouldn't be unfollowed	whitelist="whitelist.txt"
blacklist	Path to the file with user_ids that shouldn't be followed, liked or commented	blacklist="blacklist.txt"
comments_file	Path to the comments database	comments_file="comments.txt"

In all files one line - one item (comment or user_id).

Get

method	description	example
get_your_medias	Get list of your last medias	bot.get_you_medias()
get_timeline_medias	Get list of media_ids from you timeline feed	bot.get_timeline_medias()
get_user_medias	Get list of user_id's medias	bot.get_user_medias("352300017")
get_hashtag_medias	Get list of medias by hashtag	bot.get_hashtag_medias("Dog")
get_geotag_medias	Get list of medias by geotag	TODO
get_timeline_users	Get list of users from your timeline feed	bot.get_timeline_users()
get_hashtag_users	Get list of users who posted with hashtag	TODO
get_geotag_users	Get list of users who posted with geotag	TODO
get_userid_from_username	Convert username to user_id	TODO
get_user_followers	Get list of user's followers	bot.get_user_followers("352300017")
get_user_following	Get list of user's following	bot.get_user_following("352300017")
get_media_likers	Get list of media likers	bot.get_media_likers("12312412")
get_media_comments	Get list of media's comments	TODO
get_comment	Get comment from comment file	bot.get_comment()
get_media_commenters	Get list of users who commented media	bot.get_media_commenters("12321")

Like

method	description	example
like	Like media_id	bot.like("123124128654712904742810")
like_medias	Like medias from list	bot.like_medias(["1323124", "123141245"])
like_timeline	Like medias from your timeline feed	bot.like_timeline()
like_user_id	Like last user's medias	bot.like_user_id("352300017")
like_hashtag	Like last medias with hashtag	bot.like_hashtag("Dog")
like_geotag	Like last medias with geotag	TODO

Unlike

method	description	example
unlike	Remove like from media	bot.unlike("12321412512")
unlike_medias	Remove likes from medias in list	bot.unlike_medias(["123", "321"])

Follow

method	description	example
follow	Follow user_id	bot.follow("352300017")
follow_users	Follow users from list	bot.follow(["123", "321"])

Unfollow

method	description	example
unfollow	Unfollow user_id	bot.unfollow("352300017")
unfollow_users	Unfollow users from list	bot.unfollow(["123", "321"])
unfollow_non_followers	Unfollow users who don't follow you	bot.unfollow_non_followers()

Comment

method	description	example
comment	Put a comment under media	bot.comment("1231234", "Nice pic!")
comment_medias	Put comments under medias from list	bot.comment_medias(["123", "321"])
comment_hashtag	Put comments under medias by hashtag	bot.comment_hashtag("Dog")
comment_geotag	Put comments under medias by geotag	TODO
comment_users	Put comments under users' last medias	TODO
is_commented	Check if media is already commented	bot.is_commented("123321")

Checkpoints

method	description	example
save_checkpoint()	Save checkpoint of your account. Return path to it.	bot.save_checkpoint("my_cp")
revert_to_checkpoint(file_path)	Unfollow the new following made after checkpoint creation.	bot.revert_to_checkpoint("my_cp")
load_checkpoint(path)	Load checkpoint from path. Return Checkpoint class.	cp = bot.load_checkpoint( bot.last_checkpoint_path)
load_last_checkpoint()	Load last checkpoint if it was in current session.	bot.load_last_checkpoint()
checkpoint_followers_diff(cp)	returns a list of users who become your followers after checkpoint.	bot.checkpoint_followers_diff(cp)
checkpoint_following_diff(cp)	returns a list of users who become your following after checkpoint.	bot.checkpoint_following_diff(cp)

Sample usage

from instabot import Bot
bot = Bot()
bot.login()
bot.like_timeline()
bot.like_hashtag("dog")
bot.comment_hashtag("dogs")
bot.unfollow_non_followers()
bot.logout()

The best way to start is to go to examples and play with them.

---

by @ohld