Cool Instagram scripts for promotion and API wrapper. Written in Python.
As you may know, Instagram closed its API in summer 2016. This Python module can do the same things without any effort.
Make sure you check out the example scripts here. Chances are, your desired functions are already there and ready to use. Examples include unfollowing non-followers, following competitor's followings and followers, liking posts of a specific hashtag, and more...
If you have any ideas, please report them in the Issues section or in our Telegram chat. Your contribution and support through stars and reporting issues will be highly appreciated. After all, this project is dependent on your testing and support. :)
Install latest stable version or update current from pip.
pip install -U instabotFull installation steps for UNIX (Linux, macOS) users here. If you are Windows user, go to Windows installation.
Choose any script from examples and run:
python example.py
If you have any problems with the script, regarding any issue or inquiry, please ask questions in the Telegram chat.
Implemented bot methods
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,
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 follow 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 |
| 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:
one item
one line
This is in regards to comments or users in a file.
| 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") |
| 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 |
| method | description | example |
|---|---|---|
| unlike | Remove like from media | bot.unlike("12321412512") |
| unlike_medias | Remove likes from medias in list | bot.unlike_medias(["123", "321"]) |
| method | description | example |
|---|---|---|
| follow | Follow user | bot.follow("activefollower") |
| follow_users | Follow users from list | bot.follow(["activefollower1", "activefollower2"]) |
| method | description | example |
|---|---|---|
| unfollow | Unfollow user | bot.unfollow("competitor") |
| unfollow_users | Unfollow users from list | bot.unfollow(["competitor1", "competitor2"]) |
| unfollow_non_followers | Unfollow users who don't follow you | bot.unfollow_non_followers() |
| 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") |
from instabot import Bot
bot = Bot()
bot.login()
bot.like_timeline()
bot.like_hashtag("dog")
bot.comment_hashtag("dogs")
bot.like_user("activefollower")
bot.follow("activefollower")
bot.unfollow_non_followers()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