📱 IG Profile Finder

A tool that allows you to find profiles of interest from a specific Instagram account, using custom filters.

⚠️ WARNING

This tool is for educational and research purposes only. Use it responsibly and at your own risk. The authors are not responsible for any actions taken against your account, including temporary blocks or bans.

This project is not affiliated, associated, authorized, endorsed by, or in any way officially connected with Meta Platforms, Inc., nor with any of its subsidiaries, brands, or products (including Instagram, Facebook, and others).

🖥️ Usage

We provide an Installation Page to easily copy the script.

1. Go to our Installation Page.
2. Click "Copy Code".
3. Go to Instagram.com and ensure you are logged in.
4. Open the Developer Console and paste the code:
   • Windows/Linux: F12 or Ctrl + Shift + I
   • macOS: ⌘ + ⌥ + I
5. Press Enter to launch the tool.

Note: The script has security checks. It will alert you if you execute it outside of Instagram or without an active session.

✨ Features

🔍 SEARCH FILTERS
Filter profiles with precision based on multiple criteria.

Followers & Following
Filter by minimum or maximum number of followers, how many people they follow, and their follower-to-following ratio.

Bio Keywords (Include/Exclude)
Search for specific words in their biography (like "Coach" or "Art") or automatically hide profiles that mention words you want to avoid.

Account Type & Privacy
Target only Business, Creator, or Personal accounts. Specifically filter results by Account Privacy (only Public or only Private profiles) and verified status (Blue check).

Account Age & Join Date
Find only new accounts or older, established ones by filtering by their join date or age in months.

Mutual Friends
Filter results based on how many followers you have in common, or require specific people to be mutual friends.

Location Tags
Filter users who mention specific cities, countries, or locations in their profile description.

Website & Link Filtering
Filter by the type of website they have in their bio (e.g., only show profiles with specific domains).

Deep Link Analysis (Beta)
When this feature is enabled, if a link aggregation service such as Linktree is detected, the system analyzes its content to check for links of interest to the user. This is especially useful when profiles do not list multiple links directly, but instead use these services to centralize them into a single link.

Profile Photo Check
Automatically filter out accounts that are using the default "no-photo" avatar.

Exclusion List (Blacklist)
Upload a text file or manually type usernames that you want the tool to always ignore.

Smart Skip
Automatically skip accounts you already follow, those with pending requests, or your own profile.

---

📊 SMART DASHBOARD
Everything you need to monitor your progress in real-time.

Live Activity Logs
Watch the process step-by-step with instant updates and progress tracking.

Interactive Results Table
Sort, filter, and inspect your findings in a clean, organized table.

Dark Mode
High-contrast dark theme available for the entire interface.

---

🛡️ SAFE & AUTOMATED
Built to be efficient while keeping your account secure.

Configurable Delays
Set your own wait times and safety pauses to control the process speed.

Easy Data Export
Save all your found profiles into a clean CSV file with one click.

Automatic Following
Optional feature to automatically follow people who match your filters.

And more...
Additional internal features and performance refinements.

🚀 Installation & Usage

1. Clone the repository

   git clone https://github.com/linkdev2/ig-profile-finder.git
   cd ig-profile-finder

2. Install dependencies

   npm install

3. Run in Development Mode

   npm run dev

   Starts a live watcher that automatically re-builds the project whenever you save changes.

4. Build for Production

   npm run build

   Generates the minified/bundled scripts in the dist folder.

🛠️ Development

• Core: Node.js, JavaScript (ES6+)
• Bundler: esbuild
• Styling: Vanilla CSS (No large frameworks)
• Formatting: Prettier

📖 About the Project

This project was born out of boredom. While browsing the internet, I came across the InstagramUnfollowers repository by @davidarroyo1234, which inspired me to develop a similar tool, also based on the use of Instagram’s APIs. At the same time, I wanted to experiment with Google’s new Antigravity IDE.

For this reason, a large portion of the code was generated using artificial intelligence, mainly with the Gemini 3 Pro model. As a result, you should not expect perfectly clean, optimized, or well-organized code.

Additionally, since English is not my native language, in some cases the AI generates code in Spanish and in others in English. For this reason, you may find comments or variable names in both languages.

Overall, the experience was very positive and enriching, as it allowed me to explore new tools and development approaches. There are certainly more elegant and efficient ways to implement this project, such as using JSX with Preact. However, it was never my intention to scale it too much.

Maybe in the future I will decide to revisit or improve it. In the meantime, if anyone would like to continue its development, contributions are welcome.

⚖️ Legal & License

Disclaimer: This tool is not affiliated, associated, authorized, endorsed by, or officially connected with Instagram or Meta Platforms, Inc.

⚠️ Use at your own risk!

📜 Licensed under the MIT License