Package: instaclient
instaclientinstaclientis a Python library for accessing Instagram's features.
With this library you can create Instagram Bots with ease and simplicity. The InstaClient takes advantage of the selenium library to excecute tasks which are not allowed in the Instagram Graph API (such as sending DMs).The only thing you need to worry about is to spread your requests throughout the day to avoid reaching Instagram spam limits.Disclaimer:Please note that this is a research project.I am by no means responsible for any usage of this tool.Use it on your behalf. I'm also not responsible if your accounts get banned or restricted due to the extensive use of this tool.Table of ContentsFeaturesInstallationUsageContributingChangelogHelp - CommunityCreditsLicenseFeaturesScrapingScrape a user's followers (Via scrolling or with GraphQL)Scrape a user's following (Via scrolling or with GraphQL)Scrape a HashtagScrape a LocationScrape a ProfileScrape a user's postsScrape a hashtag's postsScrape a location's postsScrape a post's info via its shortcodeInteractingFollow a userUnfollow a userLike a postUnlike a postAdd a comment on a postSend DMs to users (both Private & Public)Check Incoming NotificationsTO DO:Define Classes:CommentPostLocationScrape User Posts's shorturlScrape Post by shorturlAdd comment to post by shorturlLike post by shorturlUnlike post by shorturlScrape LocationSave cookiesShare/Forward a postScrape explore pageUpload postsScrape feedInteract with posts on feedView feed storiesView user storiesSave/Unsave postsInstallationUse the package managerpipto install instaclient.pipinstallinstaclientTo update the package:pipinstall-UinstaclientUsageINSTALL A DRIVER (LocalHost)If you are running your code on a localhost, then you'll need to install a chromedriver fromhere. Install and extract the chromedriver.exe file and save it in your project folder. Make sure to install the version that matches your Chrome version.
To check your chrome version, typechrome://version/in the chrome address bar.SET ENVIROMENT VARIABLES (Web Server)If you are running your code on a web server (Like Heroku), you should set the following enviroment variable:CHROMEDRIVER_PATH = /app/.chromedriver/bin/chromedriverGOOGLE_CHROME_BIN = /app/.apt/usr/bin/google-chromeCREATE THE CLIENTfrominstaclientimportInstaClientfrominstaclient.errorsimport*# Create a instaclient object. Place as driver_path argument the path that leads to where you saved the chromedriver.exe fileclient=InstaClient(driver_path='<projectfolder>/chromedriver.exe')LOGIN INTO INSTAGRAMfrominstaclient.errorsimport*try:client.login(username=username,password=password)# Go through Login ProcedureexceptVerificationCodeNecessary:# This error is raised if the user has 2FA turned on.code=input('Enter the 2FA security code generated by your Authenticator App or sent to you by SMS')client.input_verification_code(code)exceptSuspisciousLoginAttemptErroraserror:# This error is reaised by Instagramiferror.mode==SuspisciousLoginAttemptError.EMAIL:code=input('Enter the security code that was sent to you via email: ')else:code=input('Enter the security code that was sent to you via SMS: ')client.input_security_code(code)INSTAGRAM OBJECTSMany client methods return objects defined in theinstagrampackage of this library.
Such objects are reppresentations of the data returned by instagram, but they are not continuesly synced with Instagram, hence the data may not always be updated. To sync the local object to instagram, most objects have.refresh()method, as seen in the example below:profile=client.get_profile('<username>')# Other code hereprofile.refresh()# syncing with instagramSEND A DIRECT MESSAGEresult=client.send_dm('<username>','<Message to send>')# send a DM to a userMake sure to distrubute your client.send_dm() requests over a period of time to avoid reaching Instagram's spam limits.GET A USER'S FOLLOWERSfollowers=client.get_followers(user='<username>')# replace with the target usernameThe client.scrape_followers() method can take a lot of time depending on the amount of followers you want to scrape.This method might be updated in the near future to cache scraped data in a SQLite database or to scrape the followers in a separate thread with a queue.SCRAPE NOTIFICATIONSnotifications=client.get_notifications(count=10)This returns a Notification object, which contains information about the type of notification and the user who caused it.SCRAPE A PROFILEprofile=client.get_profile('<username>')This returns a Profile object, from which you can get posts and all sorts of information.SCRAPE A PROFILE's POSTSposts=client.get_user_posts('<username>',count=10)# or:profile=client.get_profile('<username>')posts=profile.get_posts(30)This returns a list of Post objects.SCRAPE A HASHTAGhashtag=client.get_hashtag(tag='<tag>')# This returns a Hashtag object, from which you can get the posts data.posts=hashtag.get_posts(count=25)SCRAPE A LOCATIONBY ID & SLUGEvery Instagram Location is defined by a slug and an ID.
You can find these two pieces of information in the URL of the location page on Instagram:https://www.instagram.com/explore/locations/270531492/italy/from this example, the ID would be270531492and the slug would beitalylocation=client.get_location(id='270531492',slug='italy')posts=location.get_posts(count=25)BY SEARCH RESULTIf you don't have access to either the ID or the slug of a location, you can still scrape such location by finding it on the search page.result=client.get_search_result('italy')location=result.get('locations')[0]ADD A COMMENTclient.comment_post('<post_shortcode>',text='Nice post!')# or:post=client.get_user_posts('<username>',count=1)[0]post.add_comment('Nice post!')LIKE A POSTclient.like_post('<post_shortcode>')# or:post=client.get_user_posts('<username>',count=1)[0]post.like()FOLLOW A USERclient.follow_user('<username>')# or:profile=client.get_profile('<username>')profile.follow()UNFOLLOW A USERclient.unfollow_user('<username>')# or:profile=client.get_profile('<username>')profile.unfollow()ContributingPull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Please make sure to updatetestsas appropriate.The format is based onKeep a Changelogand this project adheres toSemantic Versioning.
Hence, when pushing commits, it is encouraged to use the described formatting and use the following keywords:Addedfor new features.Changedfor changes in existing functionality.Deprecatedfor soon-to-be removed features.Removedfor now removed features.Fixedfor any bug fixes.Securityin case of vulnerabilities.ChangelogYou can find this repository's changelog here:CHANGELOGHelp CommunityYou can join thisTelegram Groupto ask questions about the instabot's functionalities or to contribute to the package!CreditsAUTHORSLicenseMIT