umairfaiz / instagram-insights

A Python based program to get useful insights from an Instagram creator or business page.

Partial report screenshot

Quickstart

1. Install the package using:

pip install instagram-insights

2. Run the python scripts using:

insta-insights --page-id=124567890123 --token=098754321234567890 --num-timings=2 --num-tags=3

• Page ID and Token must be provided either as options or environment variable values.
• If both options and env variables are provided options will be preferred.

Options supported

Short options	Long options	Environment variables	Description
-h	--help		Display help
-m	--machine-learning		Whether to use ML or not (currently not supported)
	--page-id	FB_PAGE_ID	Instagram Page ID
	--token	FB_TOKEN	Token to access Facebook Graph API
	--num-timings		Number of best timings needed
	--num-tags		Number of best hashtags needed
	--graphs		Whether to generate graphs or not

Python version

• >= 3.7

Packages needed

• numpy
• pandas
• requests
• matplotlib