# Instagram Profile Finder (`scrapers-hub/instagram-profile-finder`) Actor 🔎 Instagram Profile Finder helps you quickly discover and verify Instagram profiles with confidence. 📸 Perfect for social research, outreach, and brand discovery. ⚡ Fast results, user-friendly search—find the right account in seconds! - **URL**: https://apify.com/scrapers-hub/instagram-profile-finder.md - **Developed by:** [Scrapers Hub](https://apify.com/scrapers-hub) (community) - **Categories:** Social media, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $0.01 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### Instagram Profile Finder 🔍 **Instagram Profile Finder** helps you discover relevant Instagram accounts at scale by searching with your niche keywords and optional country filtering. Whether you’re using an **Instagram profile finder** for outreach, building a lead list with an **Instagram account lookup**, or doing research with an **Instagram profile search tool**, this actor automates the profile discovery workflow and saves you hours of manual work—no login required. --- ### Why choose Instagram Profile Finder? | Feature | Benefit | |---|---| | ✅ **Keyword-based profile discovery** | Finds Instagram profiles using your provided `keywords` list | | ✅ **Country filtering** | Focuses results on your selected `country` to improve lead relevance | | ✅ **Proxy resilience + fallbacks** | Built-in proxy support helps keep scraping runs reliable | | ✅ **Retries for resilience** | Uses `max_retries` when scraping pages to reduce empty/failed attempts | | ✅ **Structured, enriched output** | Returns consistent profile fields (e.g. `full_name`, `biography`, `followers`, `profile_pic_url`) | | ✅ **Dataset-ready results** | Outputs directly into the **Instagram Profiles** dataset view for quick export | --- ### Key features - 🧠 **Niche-focused Instagram profile discovery**: Uses your `keywords` to find matching profiles for lead generation and research. - 🌍 **Target country filtering**: Lets you restrict discovery by the `country` you select, making it easier to build region-specific lists. - 🛡️ **Reliable scraping with proxy support**: Includes built-in proxy support to improve consistency for large batches. - 🔄 **Retry logic for stability**: Implements retry behavior (`max_retries`) when requesting pages to help recover from transient failures. - 📊 **Complete profile enrichment**: Enriches each discovered profile with fields like `full_name`, `biography`, `user_id`, follower/following counts, and profile picture URLs. - 💾 **Clean dataset output**: Pushes results to the dataset with clear fields such as `keyword`, `url`, and `source`. - ⚙️ **Run-time limits to control volume**: Uses a global maximum (`max_leads`) with free-tier capping behavior to prevent unexpectedly large runs. - ✂️ **Valid-profile filtering**: Only keeps URLs that match valid Instagram profile patterns (skipping posts/reels/other non-profile pages). --- ### Input Provide input via an `input.json` file. Example structure: ```json { "keywords": ["marketing", "fitness"], "country": "United States", "max_leads": 100 } ```` #### Input Fields | Field | Required | Description | |---|---|---| | `keywords` | Yes | List of niche keywords to search (example: `marketing`, `fitness`). The actor will process each keyword. | | `country` | No | Target country for leads. Used to filter discovery to a specific region (default: `United States`). | | `max_leads` | No | Maximum number of leads to collect. (Default: `10`, minimum: `1`). Free tier runs cap results at 100 profiles per run. | *** ### Output The actor saves each profile’s data into the **Instagram Profiles** dataset (table view), with one row per collected profile URL. Example output item (as stored in the dataset): ```json { "keyword": "marketing", "full_name": "Example Name", "biography": "Example bio text", "followers": 1234, "following": 56, "post_count": 789, "external_url": "https://example.com", "profile_pic_url": "https://example.com/pic.jpg", "source": "Search Engine", "url": "https://www.instagram.com/exampleusername/", "user_id": "1234567890", "is_verified": false, "is_business_account": false, "is_professional_account": false, "profile_pic_url_hd": "https://example.com/pic_hd.jpg" } ``` #### Output Fields | Field | Type | Description | |---|---|---| | `keyword` | string | The keyword that led to this profile being discovered | | `full_name` | string | Profile full name (if available) | | `biography` | string | Profile biography / bio text | | `followers` | number | Follower count | | `following` | number | Following count | | `post_count` | number | Number of posts | | `external_url` | string | External link shown on the profile (if any) | | `profile_pic_url` | string | Profile picture URL | | `profile_pic_url_hd` | string | High-definition profile picture URL | | `source` | string | Where the profile was found (set to `"Search Engine"`) | | `url` | string | Instagram profile URL | | `user_id` | string | Instagram user id | | `is_verified` | boolean | Whether the profile is verified | | `is_business_account` | boolean | Whether the profile is a business account | | `is_professional_account` | boolean | Whether the profile is a professional account | **Note:** Some enrichment fields may be empty if the profile does not provide them publicly. *** ### How to use Instagram Profile Finder (via Apify Console) 1. **Open Apify Console** 🔐\ Go to [console.apify.com](https://console.apify.com) and log in. 2. **Find the actor**\ Search for **Instagram Profile Finder** in the Actors marketplace. 3. **Go to the INPUT section**\ Paste your `input.json` values in the form or as raw JSON. 4. **Set `keywords`** ✍️\ Add one or more niche keywords (e.g. “marketing”, “fitness”). The actor will process each keyword. 5. **Pick a `country`** 🌍\ Choose a target country to improve lead relevance. Default is **United States**. 6. **Control volume with `max_leads`** 📊\ Enter the maximum number of leads you want. Free runs cap at 100 profiles per run. 7. **Run the actor** ▶️\ Start the run and watch the live logs for progress while it discovers and enriches profiles. 8. **Open the dataset results** 💾\ After completion, go to the **Instagram Profiles** dataset and export as JSON/CSV as needed. No coding required—get accurate results in minutes with **Instagram Profile Finder**. *** ### Advanced features & SEO optimization - 🔎 **Engineered for keyword-led Instagram profile search**: **Instagram Profile Finder** is designed to excel at “Instagram profile finder” and “find Instagram profile” workflows for outreach and discovery. - 🌐 **Better targeting with country filtering**: **Instagram username finder** and **Instagram account lookup** style use cases become more actionable when you narrow by region. - 🔄 **More reliability at scale**: Uses built-in retry behavior and proxy support to keep large runs moving even when some pages fail. - 🧩 **Clean enrichment fields for analysis**: Returns profile metadata you can directly analyze or push into your workflow (followers, following, post count, URLs, and more). - 🧱 **Consistency-first structured output**: The dataset schema is designed for straightforward export—ideal for CRM enrichment pipelines and data analysis projects. *** ### Best use cases - 📈 **Marketing lead generation**: Build a keyword-targeted list of Instagram accounts for outreach campaigns with higher relevance by country. - 🧠 **Market research & competitive landscaping**: Collect profile attributes (followers, following, biography) to compare niches by region. - 👥 **Influencer discovery**: Find accounts connected to specific niches using an **Instagram profile search tool** approach. - 🧾 **Data analyst workflows**: Export enriched profile fields for segmentation and reporting without manual scraping. - 🧑‍💻 **CRM enrichment automation**: Feed discovered profile metadata into your CRM pipeline using dataset exports. - 📌 **Brand partnership sourcing**: Locate Instagram profiles that match your keywords and build a shortlist for partnerships and collaborations. - 🔍 **“Instagram username checker” style QA**: Validate and enrich username-led findings into consistent structured records. *** ### Technical specifications **Supported Input Formats** - ✅ `keywords` (array of strings): minimum 1 item; unique items enforced by schema - ✅ `country` (string): one of the allowed country values in the input schema - ✅ `max_leads` (integer): minimum 1 (default: 10) **Proxy Support** - ✅ Built-in proxy support for reliable scraping and enrichment runs - ⚠️ If enrichment requests fail, some profiles may be skipped (the actor logs warnings and continues) **Retry Mechanism** - ✅ Uses `max_retries` (set internally to `3`) for page scraping requests **Dataset Structure** - ✅ Dataset: **Instagram Profiles** - ✅ Dataset table fields include: `keyword`, `full_name`, `biography`, `followers`, `following`, `post_count`, `external_url`, `profile_pic_url`, `source`, `url` **Rate Limits & Performance** - ✅ Includes a delay between page requests (`request_delay` is set internally) - ✅ Designed to collect profiles until reaching the global lead limit for the run **Limitations** - ❌ Private/restricted profiles may not be enrichable - ❌ Profiles without publicly available metadata may produce incomplete enrichment fields *** ### FAQ #### Does Instagram Profile Finder require any login? ✅ No. **Instagram Profile Finder** is designed to discover and enrich publicly available profile information without requiring you to log in. #### What data does Instagram Profile Finder return? ✅ It returns structured profile records including fields like `full_name`, `biography`, `followers`, `following`, `post_count`, `external_url`, `profile_pic_url`, plus the discovered `url`, `keyword`, and `source`. #### How many profiles can I collect in one run? ✅ You can set `max_leads`, but free tier runs cap results at 100 profiles per run. Paid runs remove the hard limit enforcement behavior. #### Can I search multiple niches at once? ✅ Yes. Provide multiple entries in `keywords` (e.g. “marketing”, “fitness”). The actor processes each keyword and keeps collecting until it hits the run limit. #### Can I filter results by country? ✅ Yes. Set the `country` input to focus your Instagram profile discovery on a specific region. #### What if enrichment fails for a profile? ❌ If enrichment returns no data, that profile is skipped and the actor continues with the next profile. #### Is the output already saved in an Apify dataset? ✅ Yes. The actor pushes results into the **Instagram Profiles** dataset, which you can export from the Apify Console. #### How do I remove data if needed? You can request data removal by emailing . *** ### Support & feature requests If you’re using **Instagram Profile Finder** and want improvements, we’d love to hear from you. - 💡 **Feature Requests:** For example, enhancements like additional export options or more dataset fields to better match your **Instagram account lookup** workflow. - 📧 **Contact:** Email us at . Your feedback helps shape the roadmap for future **Instagram profile finder** upgrades. *** ### Disclaimer **Instagram Profile Finder** accesses **publicly accessible sources**. It does not access private profiles, authenticated data, or password-protected pages. Compliance with applicable laws (including GDPR/CCPA), platform policies, and spam regulations is your responsibility. For data removal requests, contact . Please use this tool responsibly, ethically, and for legitimate purposes only. *Turn your keyword research into an actionable list with the most comprehensive, SEO-optimized **Instagram Profile Finder**.* # Actor input Schema ## `keywords` (type: `array`): List of niche keywords to search (e.g., 'marketing', 'fitness'). ## `country` (type: `string`): Select the target country for leads. ## `max_leads` (type: `integer`): Maximum number of leads to collect (Default: 100). ## Actor input object example ```json { "keywords": [ "marketing", "fitness" ], "country": "United States", "max_leads": 10 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "keywords": [ "marketing", "fitness" ], "country": "United States" }; // Run the Actor and wait for it to finish const run = await client.actor("scrapers-hub/instagram-profile-finder").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "keywords": [ "marketing", "fitness", ], "country": "United States", } # Run the Actor and wait for it to finish run = client.actor("scrapers-hub/instagram-profile-finder").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "keywords": [ "marketing", "fitness" ], "country": "United States" }' | apify call scrapers-hub/instagram-profile-finder --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapers-hub/instagram-profile-finder", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Instagram Profile Finder", "description": "🔎 Instagram Profile Finder helps you quickly discover and verify Instagram profiles with confidence. 📸 Perfect for social research, outreach, and brand discovery. ⚡ Fast results, user-friendly search—find the right account in seconds!", "version": "1.0", "x-build-id": "nNXCAarkv5Wh4MIXh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers-hub~instagram-profile-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers-hub-instagram-profile-finder", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/scrapers-hub~instagram-profile-finder/runs": { "post": { "operationId": "runs-sync-scrapers-hub-instagram-profile-finder", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/scrapers-hub~instagram-profile-finder/run-sync": { "post": { "operationId": "run-sync-scrapers-hub-instagram-profile-finder", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "keywords" ], "properties": { "keywords": { "title": "Search Keywords", "minItems": 1, "uniqueItems": true, "type": "array", "description": "List of niche keywords to search (e.g., 'marketing', 'fitness').", "items": { "type": "string" } }, "country": { "title": "Target Country", "enum": [ "United States", "United Kingdom", "Canada", "Australia", "Germany", "France", "India", "Japan", "Brazil", "Italy", "Spain", "Netherlands", "Sweden", "Norway", "Denmark", "Finland", "Poland", "Czech Republic", "Hungary", "Romania", "Bulgaria", "Croatia", "Slovenia", "Slovakia", "Estonia", "Latvia", "Lithuania", "Portugal", "Greece", "Cyprus", "Malta", "Luxembourg", "Ireland", "Belgium", "Austria", "Switzerland", "Liechtenstein", "Iceland", "South Korea", "China", "Mexico", "Argentina", "Chile", "Colombia", "Peru", "Venezuela", "Ecuador", "Uruguay", "Paraguay", "Bolivia", "Guyana", "Suriname", "French Guiana", "Falkland Islands (Malvinas)", "South Georgia and the South Sandwich Islands", "Bonaire, Sint Eustatius and Saba", "Curaçao", "Aruba", "Sint Maarten (Dutch part)", "Turks and Caicos Islands", "British Virgin Islands", "Anguilla", "Montserrat", "Antigua and Barbuda", "Barbados", "Dominica", "Grenada", "Saint Kitts and Nevis", "Saint Lucia", "Saint Vincent and the Grenadines", "Trinidad and Tobago", "Jamaica", "Bahamas", "Belize", "Costa Rica", "Guatemala", "Honduras", "Nicaragua", "Panama", "El Salvador", "Cuba", "Dominican Republic", "Haiti", "Puerto Rico", "U.S. Virgin Islands", "American Samoa", "Guam", "Northern Mariana Islands", "Saudi Arabia", "United Arab Emirates", "Bahrain", "Iraq", "Iran, Islamic Republic of", "Israel", "Jordan", "Kuwait", "Lebanon", "Oman", "Qatar", "Syrian Arab Republic", "Yemen", "Afghanistan", "Bangladesh", "Bhutan", "Maldives", "Nepal", "Pakistan", "Sri Lanka", "Myanmar", "Cambodia", "Lao People's Democratic Republic", "Thailand", "Viet Nam", "Malaysia", "Singapore", "Brunei Darussalam", "Philippines", "Indonesia", "Timor-Leste", "Papua New Guinea", "Fiji", "New Zealand", "Solomon Islands", "Vanuatu", "New Caledonia", "French Polynesia", "Wallis and Futuna", "Samoa", "Tonga", "Tuvalu", "Kiribati", "Nauru", "Federated States of Micronesia", "Marshall Islands", "Palau", "Cook Islands", "Niue", "Tokelau" ], "type": "string", "description": "Select the target country for leads.", "default": "United States" }, "max_leads": { "title": "Max Leads", "minimum": 1, "type": "integer", "description": "Maximum number of leads to collect (Default: 100).", "default": 10 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```