Skip to main content

Instadective is a tool that analyzes your Instagram account to show various useful insights.

Project description

Instadective

Instadective is a simple command-line tool uses Instagram's API (using instagrapi) to gain various insights about your Instagram account along with changes to followers and following over time.

Features

  • Detects users you follow that don't follow you back on Instagram.
  • Detects change in follower/following between two scans.
  • Scans your account to store your followers and following locally which can be used later.
  • Uses your Instagram sessionid to do so.
  • Uses Instagram's official API via instagrapi.

Installation

You can directly install instadective using pip:

pip install instadective

Also, you can clone the Github repo:

git clone https://github.com/mozaxn/Instadective.git
cd Instadective
pip install -r requirements.txt

Usage

To display help, run:

instadective -h

This will show something similar to:

                             _________ _        _______ _________ _______                               
                             \__   __/( (    /|(  ____ \\__   __/(  ___  )                              
                                ) (   |  \  ( || (    \/   ) (   | (   ) |                              
                                | |   |   \ | || (_____    | |   | (___) |                              
                                | |   | (\ \) |(_____  )   | |   |  ___  |                              
                                | |   | | \   |      ) |   | |   | (   ) |                              
                             ___) (___| )  \  |/\____) |   | |   | )   ( |                              
                             \_______/|/    )_)\_______)   )_(   |/     \|                              
                                                                                                        
                     ______   _______  _______ __________________          _______                      
                    (  __  \ (  ____ \(  ____ \\__   __/\__   __/|\     /|(  ____ \                     
                    | (  \  )| (    \/| (    \/   ) (      ) (   | )   ( || (    \/                     
                    | |   ) || (__    | |         | |      | |   | |   | || (__                         
                    | |   | ||  __)   | |         | |      | |   ( (   ) )|  __)                        
                    | |   ) || (      | |         | |      | |    \ \_/ / | (                           
                    | (__/  )| (____/\| (____/\   | |   ___) (___  \   /  | (____/\                     
                    (______/ (_______/(_______/   )_(   \_______/   \_/   (_______/                     
                                                                                                        
                                             VERSION 1.0.0                                              
                                           DEVELOPED BY ZAXN                                            
                                         mozaxn@protonmail.com                                          



usage: instadective [-h] [-s SESSIONID] [--scan] [-o OUT] [-n] [-c SCAN1 SCAN2]

options:
  -h, --help            show this help message and exit
  -s, --sessionid SESSIONID
                        Your Instagram SESSION_ID
  --scan                Perform core scan. This displays your followers and following. Use with flag
                        -o to save the results to a file.
  -o, --out OUT         Save the output of a scan to a directory. Mention the directory without the
                        '/' at the end.
  -n, --non-follow      Identify accounts you follow but don't follow you back.
  -c, --compare SCAN1 SCAN2
                        Compare two core scans to identify changes in followers & following.

Non-follower Scan

To perform the non-follower scan, run it directly from your terminal:

instadective -s SESSION_ID -n

or,

instadective --sessionid SESSION_ID --non-follow

Core Scan

To perform core scan, run:

instadective -s SESSION_ID --scan

To output the scan to a JSON file:

instadective -s SESSION_ID --scan -o DEST_DIRECTORY

Compare Scans

To compare two scans:

instadective -c SCAN_1 SCAN_2

or,

instadective --compare SCAN_1 SCAN_2

License

Licensed under the GPL-3.0 License — see the LICENSE file for details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

instadective-1.0.0.tar.gz (18.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

instadective-1.0.0-py3-none-any.whl (18.9 kB view details)

Uploaded Python 3

File details

Details for the file instadective-1.0.0.tar.gz.

File metadata

  • Download URL: instadective-1.0.0.tar.gz
  • Upload date:
  • Size: 18.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for instadective-1.0.0.tar.gz
Algorithm Hash digest
SHA256 2acdb42507ec5f2237e1fbe427eac3d7557f5f9249ce6197879bab39558f3288
MD5 e193de1887f5aadc6bc8b20af7d367d5
BLAKE2b-256 0bb8cac48ebe1aa1ad56f4e848978710f855582f0b16ddb65a830165c05fd7df

See more details on using hashes here.

File details

Details for the file instadective-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: instadective-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 18.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for instadective-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 de87ad195cd9d8f8d226fbabb8bab63665bd98d8ed3ef6c5d35e88aa04efc8fa
MD5 e7300574efbe72f5c4629184da46b091
BLAKE2b-256 d29c0dcad9a02605db01fd446ae3c12060629a74a5ba7f76322046036fefbb39

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page