For_developers.md

Documentation

Bot Class

from instabot import Bot
bot = Bot(
            proxy=None,
            max_likes_per_day=1000,
            max_unlikes_per_day=1000,
            max_follows_per_day=350,
            max_unfollows_per_day=350,
            max_comments_per_day=100,
            max_likes_to_like=100,
            filter_users=True,
            filter_business_accounts=True,
            filter_verified_accounts=True,
            max_followers_to_follow=2000,
            min_followers_to_follow=10,
            max_following_to_follow=7500,
            min_following_to_follow=10,
            max_followers_to_following_ratio=10,
            max_following_to_followers_ratio=2,
            max_following_to_block=2000,
            min_media_count_to_follow=3,
            like_delay=10,
            unlike_delay=10,
            follow_delay=30,
            unfollow_delay=30,
            comment_delay=60,
            whitelist=False,
            blacklist=False,
            comments_file=False,
            stop_words=['shop', 'store', 'free']
)

parameter	description	example
proxy	Proxy for Instabot	None
max_likes_per_day	How many likes the bot will perform per day	1000
max_unlikes_per_day	How many medias the bot will unlike in a day	1000
max_follows_per_day	Max number of follow per day	350
max_unfollows_per_day	Max number of unfollow per day	350
max_comments_per_day	Max number of comments per day	100
max_likes_to_like	If the media has more likes then this value - it will be ignored and not be liked	200
filter_users	Filter users if True	True
filter_business_accounts	Filter business accounts if True	True
filter_verified_accounts	Filter verified accounts if True	True
max_followers_to_follow	If the user has more followers than this value - the user will not be followed or liked.	2000
min_followers_to_follow	If the user has fewer followers than this value - the user will not be followed or liked.	10
max_following_to_follow	If the user has more followings than this value - the user will not be followed or liked.	10000
min_following_to_follow	If the user has fewer followings than this value - the user will not be followed or liked.	10
max_followers_to_following_ratio	if the user's followers/following is greater than this value - the user will not be followed or liked.	10
max_following_to_followers_ratio	if user's following/followers is greater than this value - he will not be followed or liked.	2
min_media_count_to_follow	If the user has fewer media count than this value - the user will not be followed.	3
max_following_to_block	If the user have a following more than this value - the user will be blocked in blocking scripts because he is a massfollower	2000
max_likes_to_like	Max number of likes that can media have to be liked	100
like_delay	Delay between likes in seconds	10
unlike_delay	Delay between unlikes in seconds	10
follow_delay	Delay between follows in seconds	30
unfollow_delay	Delay between unfollows in seconds	30
comment_delay	Delay between comments in seconds	60
whitelist	Path to the file with users that shouldn't be unfollowed	"whitelist.txt"
blacklist	Path to the file with users that shouldn't be followed, liked or commented	"blacklist.txt"
comments_file	Path to the comments database	"comments.txt"
stop_words	A list of stop words: don't follow a user if they have any of these stop words in their description	['shop', 'store', 'free']

In all files:

first line - one item

second line - one item

Example. File comments.txt

Nice!
Great!
Good pic!

This is in regards to comments or users in a file.

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 your timeline feed	bot.get_timeline_medias()
get_user_medias	Get list of user's medias	bot.get_user_medias("ohld")
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	bot.get_hashtag_users("Dog")
get_geotag_users	Get list of users who posted with geotag	TODO
get_userid_from_username	Convert username to user_id	bot.get_userid_from_username("ohld")
get_user_followers	Get list of user's followers	bot.get_user_followers("competitor")
get_user_following	Get list of user's following	bot.get_user_following("competitor")
get_media_likers	Get list of media likers	bot.get_media_likers("12312412")
get_media_comments	Get list of media's comments	bot.get_media_comments("12312412")
get_comment	Get comment from comment file	bot.get_comment()
get_media_commenters	Get list of users who commented on the media	bot.get_media_commenters("12321")

Like

method	description	example
like	Like media_id	bot.like("1231241210")
like_medias	Like medias from list	bot.like_medias(["1323124", "123141245"])
like_timeline	Like medias from your timeline feed	bot.like_timeline()
like_user	Like last user's medias	bot.like_user("activefollower")
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	bot.follow("activefollower")
follow_users	Follow users from list	bot.follow(["activefollower1", "activefollower2"])

Unfollow

method	description	example
unfollow	Unfollow user	bot.unfollow("competitor")
unfollow_users	Unfollow users from list	bot.unfollow_users(["competitor1", "competitor2"])
unfollow_non_followers	Unfollow users who don't follow you	bot.unfollow_non_followers()

Comment

method	description	example
comment	Put a comment under the 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	bot.comment_users(["activefollower1", "activefollower2"])
is_commented	Check if media is already commented	bot.is_commented("123321")