instagram-bot

Parameters

Parameter Type Description Default value
login str Your instagram username
password str Your instagram password
start_at_h int Start program at the hour 0
start_at_m int Start program at the min 0
end_at_h int End program at the hour 23
end_at_m int End program at the min 59
database_name str change the name of database file to use multiple account "follows_db.db"
like_per_day int Number of photos to like per day (over 1000 may cause throttling) 1000
media_max_like int Maximum number of likes on photos to like (set to 0 to disable) 0
media_min_like int Minimum number of likes on photos to like (set to 0 to disable) 0
follow_per_day int Photos to like per day 0
follow_time int Seconds to wait before unfollowing 5 * 60 * 60
unfollow_per_day int Users to unfollow per day 0
comments_per_day int Comments to post per day 0
comment_list [[str]] List of word lists for comment generation [['this', 'your'], ['photo', 'picture', 'pic', 'shot'], ['is', 'looks', 'is really'], ['great', 'super', 'good'], ['.', '...', '!', '!!']]
tag_list [str] Tags to use for finding posts ['cat', 'car', 'dog']
tag_blacklist [str] Tags to ignore when liking posts []
user_blacklist {str: str} Users whose posts to ignore {}
max_like_for_one_tag int How many media of a given tag to like at once (out of 21) 5
unfollow_break_min int Minimum seconds to break between unfollows 15
unfollow_break_max int Maximum seconds to break between unfollows 30
log_mod int Logging target (0 log to console, 1 log to file, 2 no log.) 0
proxy str Access instagram through a proxy. (host:port or user:password@host:port)

Methods

Method Description
get_media_id_by_tag(tag) Add photos with a given tag to like queue
like_all_exist_media(num) Like some number of media in queue
auto_mod() Automatically loop through tags and like photos
unlike(id) Unlike media, given its ID.
comment(id, comment) Write a comment on the media with a given ID.
follow(id) Follow the user with the given ID.
unfollow(id) Unfollow the user with the given ID.
logout() Log out of Instagram.

Usage examples

Basic bot implementation:

bot = InstaBot('login', 'password')
bot.auto_mod()

Standard use with custom tags:

bot = InstaBot('login', 'password', tag_list=['with', 'your', 'tag'])
bot.auto_mod()

Standard use with change default settings (you should know what you do!):

bot = InstaBot('login', 'password',
               like_in_day=1000,
               media_max_like=50,
               media_min_like=5,
               tag_list=['like', 'follow', 'f4f'],
               max_like_for_one_tag=50,
               log_mod=1)
bot.auto_mod()

Get media by one tag 'python' and like 4 of them:

bot = InstaBot('login', 'password')
bot.get_media_id_by_tag('python')
bot.like_all_exist_media(4)