Metadata-Version: 2.1
Name: igramscraper
Version: 0.3.5
Summary: scrapes medias, likes, followers, tags and all metadata
Home-page: https://github.com/realsirjoe/instagram-scraper
Author: realsirjoe, leungwaiban
Maintainer: realsirjoe, leungwaiban
License: MIT
Description: # instagram_scraper
        <img src="https://raw.githubusercontent.com/realsirjoe/designs/master/flat_illustration.png" align="right">
        This is a minimalistic Instagram scraper written in Python.
        <br /><br />
        It can fetch media, accounts, videos, comments etc.
        `Comment` and `Like` actions are also supported.
        
        It is not easy to get Applications approved for Instagram's API therefore I created this tool inspired by [instagram-php-scraper](https://github.com/postaddictme/instagram-php-scraper).
        <br /><br />
        The goal of this project is to become as minimalistic as possible while still having all the needed functionality so that its easy to add code to it!
        
        Any ⭐️ or contribution is appreciated if you like the project 🤘
        
        ## How to install
        Simply run:
        ```
        pip install igramscraper
        ```
        
        or download the project via git clone and run the following:
        ```
        pip install -r requirements.txt
        ```
        
        ## Usages
        Some methods do require authentication:
        ```python
        
        from igramscraper.instagram import Instagram
        
        instagram = Instagram()
        
        # authentication supported
        instagram.with_credentials('username', 'password')
        instagram.login()
        
        #Getting an account by id
        account = instagram.get_account_by_id(3)
        
        # Available fields
        print('Account info:')
        print('Id: ', account.identifier)
        print('Username: ', account.username)
        print('Full name: ', account.full_name)
        print('Biography: ', account.biography)
        print('Profile pic url: ', account.get_profile_pic_url_hd())
        print('External Url: ', account.external_url)
        print('Number of published posts: ', account.media_count)
        print('Number of followers: ', account.followed_by_count)
        print('Number of follows: ', account.follows_count)
        print('Is private: ', account.is_private)
        print('Is verified: ', account.is_verified)
        
        # or simply for printing use 
        print(account)
        ```
        If you use authentication, the program will cache the user session by default so one doesn't need to create session every time.  
        If one want to disable the user session cache, assign `True` to Instagram.login() method
        
        Two Factor Authentication is also supported through cli interface, simply use 'True' for second argument of login() function 
          
        Many of the methods do not require authentication
        
        for more info browse through the examples folder
        
        Using proxy for requests:
        ```python
        from igramscraper.instagram import Instagram 
        
        proxies = {
            'http': 'http://123.45.67.8:1087',
            'https': 'http://123.45.67.8:1087',
        }
        
        instagram = Instagram()
        instagram.set_proxies(proxies)
        
        account = instagram.get_account('kevin')
        print(account.identifier)
        ```
        
        ## Recommended Limits
        If you make too many requests too fast you will get a 429 Error or something similar.
        - It is recommended to make a short break between each request of 30s (+- random)
        - In between all 10 requests a long break (300-600s)
        
        If different proxies and accounts are used for all requests and the circle doesn't repeat too fast these limits don't apply ;)
        
        Feel free to make your own tests and let us know of any limits you experienced
        
        ## More usages
        See examples [here](https://github.com/SergioWagenleitner/instagram-scraper/tree/master/examples).
        
        ## How to contribute
        Every contribution is welcome, check out our [TODOs](https://github.com/realsirjoe/instagram-scraper/blob/master/CONTRIBUTING.md)
        <br />
        and join our telegram group: https://t.me/joinchat/J86yTBAtZlEi-6T6LOxijw
        
        ## Other
        instagram-php-scraper [here](https://github.com/postaddictme/instagram-php-scraper/)
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries
Description-Content-Type: text/markdown
