{"id":15033804,"url":"https://github.com/datalux/osintgram","last_synced_at":"2025-05-13T21:11:59.078Z","repository":{"id":37030333,"uuid":"190823163","full_name":"Datalux/Osintgram","owner":"Datalux","description":"Osintgram is a OSINT tool on Instagram. It offers an interactive shell to perform analysis on Instagram account of any users by its nickname","archived":false,"fork":false,"pushed_at":"2024-07-06T11:46:50.000Z","size":3478,"stargazers_count":10616,"open_issues_count":803,"forks_count":2354,"subscribers_count":211,"default_branch":"master","last_synced_at":"2025-04-28T17:05:46.725Z","etag":null,"topics":["analysis","hacking","information-gathering","instagram","instagram-account","instagram-api","nickname","osint","osint-python","penetration-testing","python","python3","tool"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Datalux.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":"2019-06-07T23:23:40.000Z","updated_at":"2025-04-28T13:11:57.000Z","dependencies_parsed_at":"2022-07-13T16:44:29.658Z","dependency_job_id":"9e792963-cd31-4fba-a829-426d2f36444c","html_url":"https://github.com/Datalux/Osintgram","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Datalux%2FOsintgram","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Datalux%2FOsintgram/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Datalux%2FOsintgram/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Datalux%2FOsintgram/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Datalux","download_url":"https://codeload.github.com/Datalux/Osintgram/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254029004,"owners_count":22002283,"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":["analysis","hacking","information-gathering","instagram","instagram-account","instagram-api","nickname","osint","osint-python","penetration-testing","python","python3","tool"],"created_at":"2024-09-24T20:22:49.314Z","updated_at":"2025-05-13T21:11:54.064Z","avatar_url":"https://github.com/Datalux.png","language":"Python","readme":"# Osintgram 🔎📸\n\n[![version-1.3](https://img.shields.io/badge/version-1.3-green)](https://github.com/Datalux/Osintgram/releases/tag/1.3)\n[![GPLv3](https://img.shields.io/badge/license-GPLv3-blue)](https://img.shields.io/badge/license-GPLv3-blue)\n[![Python3](https://img.shields.io/badge/language-Python3-red)](https://img.shields.io/badge/language-Python3-red)\n[![Telegram](https://img.shields.io/badge/Telegram-Channel-blue.svg)](https://t.me/osintgram)\n[![Docker](https://img.shields.io/badge/Docker-Supported-blue)](https://img.shields.io/badge/Docker-Supported-blue)\n\nOsintgram is an **OSINT** tool on Instagram to collect, analyze, and run reconnaissance.\n\n\u003cp align=\"center\"\u003e\n\u003cimg align=\"center\" src=\".img/carbon.png\" width=\"900\"\u003e\n\u003c/p\u003e\n\nDisclaimer: **FOR EDUCATIONAL PURPOSE ONLY! The contributors do not assume any responsibility for the use of this tool.**\n\nWarning: It is advisable to **not** use your own/primary account when using this tool.\n\n## Tools and Commands 🧰\n\nOsintgram offers an interactive shell to perform analysis on Instagram account of any users by its nickname. You can get:\n\n```text\n- addrs           Get all registered addressed by target photos\n- captions        Get user's photos captions\n- comments        Get total comments of target's posts\n- followers       Get target followers\n- followings      Get users followed by target\n- fwersemail      Get email of target followers\n- fwingsemail     Get email of users followed by target\n- fwersnumber     Get phone number of target followers\n- fwingsnumber    Get phone number of users followed by target\n- hashtags        Get hashtags used by target\n- info            Get target info\n- likes           Get total likes of target's posts\n- mediatype       Get user's posts type (photo or video)\n- photodes        Get description of target's photos\n- photos          Download user's photos in output folder\n- propic          Download user's profile picture\n- stories         Download user's stories  \n- tagged          Get list of users tagged by target\n- wcommented      Get a list of user who commented target's photos\n- wtagged         Get a list of user who tagged target\n```\n\nYou can find detailed commands usage [here](doc/COMMANDS.md).\n\n[**Latest version**](https://github.com/Datalux/Osintgram/releases/tag/1.3) |\n[Commands](doc/COMMANDS.md) |\n[CHANGELOG](doc/CHANGELOG.md)\n\n## FAQ\n1. **Can I access the contents of a private profile?** No, you cannot get information on private profiles. You can only get information from a public profile or a profile you follow. The tools that claim to be successful are scams!\n2. **What is and how I can bypass the `challenge_required` error?** The `challenge_required` error means that Instagram notice a suspicious behavior on your profile, so needs to check if you are a real person or a bot. To avoid this you should follow the suggested link and complete the required operation (insert a code, confirm email, etc)\n\n\n## Installation ⚙️\n\n1. Fork/Clone/Download this repo\n\n    `git clone https://github.com/Datalux/Osintgram.git`\n\n2. Navigate to the directory\n\n    `cd Osintgram`\n\n3. Create a virtual environment for this project\n\n    `python3 -m venv venv`\n\n4. Load the virtual environment\n   - On Windows Powershell: `.\\venv\\Scripts\\activate.ps1`\n   - On Linux and Git Bash: `source venv/bin/activate`\n  \n5. Run `pip install -r requirements.txt`\n\n6. Open the `credentials.ini` file in the `config` folder and write your Instagram account username and password in the corresponding fields\n    \n    Alternatively, you can run the `make setup` command to populate this file for you.\n\n7. Run the main.py script in one of two ways\n\n    * As an interactive prompt `python3 main.py \u003ctarget username\u003e`\n    * Or execute your command straight away `python3 main.py \u003ctarget username\u003e --command \u003ccommand\u003e`\n    \n### Use Osintgram v2 (beta)\nYou can use Osintgram2 beta just switching to `v2` [branch](https://github.com/Datalux/Osintgram/tree/v2).\nThe v2 has some improvements and is faster with a new command execution interface. Try it just running `git checkout v2`.\n\n## Docker Quick Start 🐳\n\nThis section will explain how you can quickly use this image with `Docker` or `Docker-compose`.\n\n### Prerequisites\n\nBefore you can use either `Docker` or `Docker-compose`, please ensure you do have the following prerequisites met.\n\n1. **Docker** installed - [link](https://docs.docker.com/get-docker/)\n2. **Docker-composed** installed (if using Docker-compose) - [link](https://docs.docker.com/compose/install/)\n3. **Credentials** configured - This can be done manually or by running the `make setup` command from the root of this repo\n\n**Important**: Your container will fail if you do not do step #3 and configure your credentials\n\n### Docker\n\nIf docker is installed you can build an image and run this as a container.\n\nBuild:\n\n```bash\ndocker build -t osintgram .\n```\n\nRun:\n\n```bash\ndocker run --rm -it -v \"$PWD/output:/home/osintgram/output\" osintgram \u003ctarget\u003e\n```\n\n- The `\u003ctarget\u003e` is the Instagram account you wish to use as your target for recon.\n- The required `-i` flag enables an interactive terminal to use commands within the container. [docs](https://docs.docker.com/engine/reference/commandline/run/#assign-name-and-allocate-pseudo-tty---name--it)\n- The required `-v` flag mounts a volume between your local filesystem and the container to save to the `./output/` folder. [docs](https://docs.docker.com/engine/reference/commandline/run/#mount-volume--v---read-only)\n- The optional `--rm` flag removes the container filesystem on completion to prevent cruft build-up. [docs](https://docs.docker.com/engine/reference/run/#clean-up---rm)\n- The optional `-t` flag allocates a pseudo-TTY which allows colored output. [docs](https://docs.docker.com/engine/reference/run/#foreground)\n\n### Using `docker-compose`\n\nYou can use the `docker-compose.yml` file this single command:\n\n```bash\ndocker-compose run osintgram \u003ctarget\u003e\n```\n\nWhere `target` is the Instagram target for recon.\n\nAlternatively, you may run `docker-compose` with the `Makefile`:\n\n`make run` - Builds and Runs with compose. Prompts for a `target` before running.\n\n### Makefile (easy mode)\n\nFor ease of use with Docker-compose, a `Makefile` has been provided.\n\nHere is a sample work flow to spin up a container and run `osintgram` with just two commands!\n\n1. `make setup`   - Sets up your Instagram credentials\n2. `make run`     - Builds and Runs a osintgram container and prompts for a target\n\nSample workflow for development:\n\n1. `make setup`          - Sets up your Instagram credentials\n2. `make build-run-testing`   - Builds an Runs a container without invoking the `main.py` script. Useful for an `it` Docker session for development\n3. `make cleanup-testing`     - Cleans up the testing container created from `build-run-testing`\n\n## Development version 💻\n\nTo use the development version with the latest feature and fixes just switch to `development` branch using Git:\n\n`git checkout development`\n\nand update to last version using:\n\n`git pull origin development`\n\n\n## Updating ⬇️\n\nTo update Osintgram with the stable release just pull the latest commit using Git.\n\n1. Make sure you are in the master branch running: `git checkout master`\n2. Download the latest version: `git pull origin master`\n\n\n## Contributing 💡\n\nYou can propose a feature request opening an issue or a pull request.\n\nHere is a list of Osintgram's contributors:\n\n\u003ca href=\"https://github.com/Datalux/Osintgram/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contributors-img.web.app/image?repo=Datalux/Osintgram\" /\u003e\n\u003c/a\u003e\n\n## External library 🔗\n\n[Instagram API](https://github.com/ping/instagram_private_api)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatalux%2Fosintgram","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdatalux%2Fosintgram","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatalux%2Fosintgram/lists"}