{"id":23034716,"url":"https://github.com/ibnaleem/instatracker","last_synced_at":"2025-04-09T23:15:22.225Z","repository":{"id":246721625,"uuid":"821969889","full_name":"ibnaleem/instatracker","owner":"ibnaleem","description":"📸 an Instagram tracking script that logs any changes to an Instagram account (followers, following, posts, and bio) written in Python.","archived":false,"fork":false,"pushed_at":"2024-11-18T21:20:37.000Z","size":219,"stargazers_count":74,"open_issues_count":1,"forks_count":8,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-09T23:15:15.325Z","etag":null,"topics":["cybersecurity","information-gathering","infosec","instagram","instagram-api","instagram-bot","instagram-downloader","instagram-scraper","instagram-tool","osint","osint-framework","osint-python","osint-reconnaissance","osint-resources","osint-tool","osint-toolkit","redteam","redteaming"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ibnaleem.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-06-30T00:20:29.000Z","updated_at":"2025-04-07T11:53:23.000Z","dependencies_parsed_at":null,"dependency_job_id":"6db9942a-0a01-494d-bd79-df53313e6d31","html_url":"https://github.com/ibnaleem/instatracker","commit_stats":null,"previous_names":["ibnaleem/instatracker"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ibnaleem%2Finstatracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ibnaleem%2Finstatracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ibnaleem%2Finstatracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ibnaleem%2Finstatracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ibnaleem","download_url":"https://codeload.github.com/ibnaleem/instatracker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248125591,"owners_count":21051770,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cybersecurity","information-gathering","infosec","instagram","instagram-api","instagram-bot","instagram-downloader","instagram-scraper","instagram-tool","osint","osint-framework","osint-python","osint-reconnaissance","osint-resources","osint-tool","osint-toolkit","redteam","redteaming"],"created_at":"2024-12-15T16:35:03.686Z","updated_at":"2025-04-09T23:15:22.207Z","avatar_url":"https://github.com/ibnaleem.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cbr/\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/ibnaleem/instatracker/releases\"\u003e\n    \u003cimg src=\"https://upload.wikimedia.org/wikipedia/commons/thumb/e/e7/Instagram_logo_2016.svg/2048px-Instagram_logo_2016.svg.png\" alt=\"Logo\" width=\"20%\" height=\"20%\"\u003e\n  \u003c/a\u003e\n  \n  \u003ch2 align=\"center\"\u003eInstaTracker\u003c/h3\u003e\n\n  \u003cp align=\"center\"\u003e\n    📸 an Instagram tracker that logs any changes to an Instagram account (followers, following, posts, and bio)\n    \u003cbr /\u003e\n    \u003cbr /\u003e\n    \u003ca href=\"https://github.com/ibnaleem/instatracker/issues\"\u003eReport Bugs\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n---------------------------------------\n\n![proof of concept](https://github.com/ibnaleem/instatracker/blob/main/proof%20of%20concept/poc.png?raw=true)\n```\npython3 main.py -h\nusage: Instagram Tracker [-h] -u USERNAME\n\n📸 an Instagram tracker that logs any changes to an Instagram account\n(followers, following, posts, and bio)\n\noptions:\n  -h, --help            show this help message and exit\n  -u USERNAME, --username USERNAME\n                        The username of the account to track\n\n🤝 Contribute: https://github.com/ibnaleem/instatracker\n```\n\u003e [!IMPORTANT]\n\u003e You must login to *your* Instagram account in order to properly scrape someone else's Instagram account. This is due to Instagram blocking `HTTPS GET` requests from unauthenticated cookies. Your login information is never stored. See more [here](https://github.com/ibnaleem/instatracker/blob/main/main.py#L51C1-L56C136) and [here](https://github.com/instaloader/instaloader/blob/master/instaloader/instaloadercontext.py#L253C1-L338C43).\n\n\u003e [!TIP]\n\u003e You can always create/use an alt-account for the interative login.\n\n\n## Installation\n\u003e [!TIP]\n\u003e [Install Python if you don't have it already](https://www.python.org/downloads/)\n#### Clone this repository:\n```\n$ git clone https://github.com/ibnaleem/instatracker.git\n```\n#### Install dependencies:\n```\n$ pip install -r requirements.txt\n```\n#### Set `user` \u0026 `passwd` field on [line 71](https://github.com/ibnaleem/instatracker/blob/main/main.py#L71)\n```python\nself.bot.login(user=\"YOUR INSTAGRAM USERNAME\", passwd=\"YOUR INSTAGRAM PASSWORD\") # this allows us to access \u0026 scrape Instagram.\n```\n#### Run the script\n```\n$ python3 main.py -u USERNAME\n```\n## Automated Logging\nInstaTracker not only displays all modifications an Instagram account makes directly to the terminal (e.g., *USERNAME has unfollowed 1 person*), but it also records these changes in a text file, including the date and time.\n```\n------2024-06-30 01:01:13.659694+00:00------\njohndoe has 100\njohndoe is following 100 people\njohndoe has 0 posts\njohndoe has the following bio: this is my biography\n------2024-06-31 02:03:15.761715+00:00------\njohndoe has lost 2 followers (100 followers --\u003e 98 followers)\n------2024-06-31 05:03:15.761715+00:00------\njohndoe has gained 5 followers (98 followers --\u003e 103 followers)\n...\n```\nThis script checks for any changes every 5 minutes because Instagram's firewall starts blocking requests that are sent too quickly. You can manually update this [here](https://github.com/ibnaleem/instatracker/blob/main/main.py#L70), but do not be surprised if the script stops working.\n\n## Built With\n- [Python](https://www.python.org/)\n- [Instaloader](https://github.com/instaloader/instaloader)\n- [Rich](https://github.com/Textualize/rich)\n## LICENSE\nThis repository is under the [MIT License](https://github.com/ibnaleem/instatracker/blob/main/LICENSE)\n## Created By\n[Ibn Aleem](https://www.linkedin.com/in/shaffan-aleem-b7a852255/)\n\n## Contributing\nI welcome contributions from the community and appreciate the time and effort put into making [InstaTracker](https://github.com/ibnaleem/InstaTracker) better. To contribute, please follow the guidelines and steps outlined below:\n\n\u003e Note: **_Your pull request will be closed if you do not specify the changes you've made._**\n\n### Fork the Repository\nStart by [forking this repository](https://github.com/ibnaleem/InstaTracker/fork). You can do this by clicking on the [\"Fork\"](https://github.com/ibnaleem/InstaTracker/fork) button located at the top right corner of the GitHub page. This will create a personal copy of the repository under your own GitHub account.\n\n### Clone the Repository\nNext, clone the forked repository to your local machine using the following command:\n```bash\n$ git clone https://github.com/yourusername/instatracker.git\n```\nNavigate to the cloned directory:\n```bash \n$ cd instatracker\n```\n### Create a New Branch\nBefore making any changes, it's recommended to create a new branch. This ensures that your changes won't interfere with other contributions and keeps the main branch clean. Use the following command to create and switch to a new branch:\n```bash\n$ git checkout -b branch-name\n```\n### Make the Desired Changes\nNow, you can proceed to make your desired changes to the project. Whether it's fixing bugs, adding new features, improving documentation, or optimising code, your efforts will be instrumental in enhancing the project.\n\n### Commit and Push Changes\nOnce you have made the necessary changes, commit your work using the following commands:\n```bash\n$ git add .\n$ git commit -m \"Your commit message\"\n```\nPush the changes to your forked repository:\n```bash\n$ git push origin branch-name\n```\n### Submit a Pull Request\nHead over to the [original repository](https://github.com/ibnaleem/instatracker) on GitHub and go to the [\"Pull requests\"](https://github.com/ibnaleem/instatracker/pulls) tab.\n1. Click on the \"New pull request\" button.\n2. Select your forked repository and the branch containing your changes.\n3. Provide a clear and informative title for your pull request, and use the description box to explain the modifications you have made. **_Your pull request will be closed if you do not specify the changes you've made._**\n4. Finally, click on the \"Create pull request\" button to submit your changes.\n\n## [PGP Fingerprint](https://github.com/ibnaleem/ibnaleem/blob/main/public_key.asc)\n```\n2024 7EC0 23F2 769E 6618  1C0F 581B 4A2A 862B BADE\n```\n![GitHub Opensource](https://img.shields.io/badge/open%20source-yes-orange) ![GitHub Maintained](https://img.shields.io/badge/maintained-yes-yellow) ![Last Commit](https://img.shields.io/github/last-commit/ibnaleem/instatracker) ![Commit Activity](https://img.shields.io/github/commit-activity/w/ibnaleem/instatracker) ![Issues](https://img.shields.io/github/issues/ibnaleem/instatracker) ![Forks](https://img.shields.io/github/forks/ibnaleem/instatracker)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fibnaleem%2Finstatracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fibnaleem%2Finstatracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fibnaleem%2Finstatracker/lists"}