# Instagram Profile Finder (`scraperoka/instagram-profile-finder`) Actor ๐Ÿ”Ž Instagram Profile Finder helps you discover and connect faster! Find relevant profiles with powerful search tools. Ideal for creators, marketers & businesses. Save time, boost outreach, and grow your network ๐Ÿš€ - **URL**: https://apify.com/scraperoka/instagram-profile-finder.md - **Developed by:** [Scraperoka](https://apify.com/scraperoka) (community) - **Categories:** Social media, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 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 Instagram profiles at scale by keywordโ€”without requiring a login. If youโ€™re using an **instagram profile finder** or trying to **find instagram profile** leads for outreach, this tool automates profile discovery from publicly available web data and saves you hours of manual searching. Whether youโ€™re a marketer, data analyst, or researcher, you can use **instagram account lookup** workflows to quickly build target lists by niche keyword and **target country**, enabling faster research and more efficient lead generation runs. --- ### Why choose Instagram Profile Finder? | Feature | Benefit | |---|---| | โœ… **Keyword-driven profile discovery** | Search by multiple niche **keywords** to find relevant Instagram profiles per run | | โœ… **Country targeting** | Filter results using the **Target Country** you select for more focused lead sourcing | | โœ… **Built-in reliability logic** | Includes retries and stops when it encounters several consecutive empty pages for a keyword | | โœ… **Structured dataset output** | Writes consistently structured profile records to the โ€œInstagram Profilesโ€ dataset | | โœ… **Proxy support for stable scraping** | Built-in proxy support helps keep collection reliable at scale | | โœ… **Scales to batches** | Uses a global max leads limit per run so you can control throughput and volume | --- ### Key features - ๐Ÿ”Ž **Instagram profile search by keyword**: Provide a list of niche keywords to discover matching Instagram profiles in one execution. - ๐ŸŒ **Country-targeted lead sourcing**: Choose a **Target Country** to guide result collection toward your desired geography. - ๐Ÿ›ก๏ธ **Resilient collection behavior**: Uses a retry mechanism and ends a keyword search after several consecutive empty pages. - ๐Ÿ“Š **Rich profile metadata**: Each output record includes profile fields like `full_name`, `biography`, `followers`, `following`, `post_count`, `external_url`, and more. - ๐Ÿ’พ **Dataset-first workflow**: Results are pushed to the Apify dataset as theyโ€™re collected, so you can analyze them immediately. - ๐Ÿ”„ **Deduped keyword workflow (within your inputs)**: Inputs support unique keywords only (`uniqueItems: true`), helping keep runs cleaner. - ๐ŸŒ **Valid profile URL filtering**: Filters for Instagram profile URLs (excluding non-profile paths and non-profile subdomains). --- ### 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 (for example: `"marketing"`, `"fitness"`). Must contain at least 1 item and all items must be unique. | | `country` | No | Select the target country for leads. Defaults to `"United States"`. | | `max_leads` | No | Maximum number of leads to collect. Default is `10`. Minimum is `1`. On Free tier runs, this is capped at 100 profiles per run. | *** ### Output The actor saves each profileโ€™s data to the **Instagram Profiles** dataset in JSON records. Example output record (dataset row): ```json { "keyword": "marketing", "full_name": "Example Name", "biography": "Example bio text", "followers": 12345, "following": 678, "post_count": 90, "external_url": "https://example.com", "profile_pic_url": "https://example.com/pic.jpg", "source": "Search Engine", "url": "https://www.instagram.com/exampleusername/" } ``` #### Output Fields | Field | Type | Description | |---|---|---| | `keyword` | string | The keyword that led to the profile discovery. | | `full_name` | string | Profile full name as provided by the enrichment step. | | `biography` | string | Profile biography text (bio). | | `followers` | number | Followers count. | | `following` | number | Following count. | | `post_count` | number | Number of posts. | | `external_url` | string | External link shown on the profile (if available). | | `profile_pic_url` | string | Profile picture URL. | | `source` | string | Where the profile was sourced from (set to `"Search Engine"`). | | `url` | string | The Instagram profile URL. | > Note: The actor also enriches additional fields during collection (e.g., `user_id`, `is_verified`, account type flags, and HD profile pic URL), and merges them into the pushed item. Dataset display is configured to show the fields listed above. You can export the dataset from the Apify UI (JSON/CSV options depend on the dataset export tools you choose). *** ### How to use Instagram Profile Finder (via Apify Console) 1. **Open Apify Console**\ Sign in at https://console.apify.com and go to the **Actors** page. 2. **Find Instagram Profile Finder**\ Search for **Instagram Profile Finder** and open the actor details page. 3. **Go to the INPUT tab**\ Paste or edit the input JSON in the console input editor. 4. **Set your lead discovery inputs**\ Enter: - `keywords` (required): an array like `["marketing","fitness"]` - `country` (optional): choose your target country (default: `"United States"`) - `max_leads` (optional): number of leads to collect (default: `10`, Free tier capped at 100) 5. **Check proxy behavior during the run**\ The actor includes built-in proxy support for reliable scraping and enrichment. If enrichment cannot be performed, that profile may be skipped. 6. **Start the run**\ Click **Run**. Watch the logs for progress such as keyword processing and how many profiles were found. 7. **Review results in the OUTPUT / DATASET tab**\ Open the **Instagram Profiles** dataset, preview the table, and export your results to your preferred format. No coding requiredโ€”get actionable Instagram profile discovery results in minutes with **Instagram Profile Finder**. ๐Ÿš€ *** ### Advanced features & SEO optimization - ๐Ÿง  **Engineered for keyword-based profile search**: Built to excel at **instagram profile finder** and **instagram profile search** style lead sourcing when you supply focused niche terms. - ๐Ÿ”ง **Country-aware lead targeting**: Helps your **instagram account search tool** results align with your desired geography by using your selected country input. - ๐Ÿ”„ **Resilient execution**: Includes retries and uses a consecutive-empty-page stopping condition so runs donโ€™t waste time indefinitely. - ๐Ÿ“ **Structured dataset for downstream workflows**: Pushes consistent fields to the dataset, making it easy to use in CRM uploads, spreadsheets, or analyst pipelines. - ๐ŸŒ **Automation-ready collection**: Works well when you need an **instagram profile lookup** step as part of a larger enrichment process. *** ### Best use cases - ๐Ÿ“ˆ **Marketing teams building targeted outreach lists**: Discover fresh **instagram profile finder** leads by niche keyword and country. - ๐Ÿ”ฌ **Market research analysts**: Rapidly sample **instagram user search** results to understand presence and positioning across geographies. - ๐Ÿ‘ฅ **Agency lead generation**: Use **instagram people finder** workflows to compile prospective client lists for outreach campaigns. - ๐Ÿ’ผ **Recruiters and talent sourcing researchers**: Build candidate pools by niche (e.g., fitness, marketing) using **instagram account lookup** results. - ๐Ÿงพ **Data analysts and enrichment pipelines**: Feed profile metadata into reporting tools as structured dataset rows. - ๐Ÿ› ๏ธ **Developer workflows**: Automate **instagram profile search engine** steps in scheduled jobs and export JSON/CSV outputs for processing. *** ### Technical specifications - **Supported Input Formats** - โœ… `keywords` as an array of strings - โœ… `country` as one of the supported country names in the schema - โœ… `max_leads` as an integer (minimum `1`) - **Proxy Support** - โœ… Built-in proxy support is used for stable scraping and enrichment. - **Retry Mechanism** - โœ… Retries are enabled for page scraping with exponential backoff behavior (controlled by `max_retries` in the actor code). - **Dataset Structure** - โœ… Dataset title: **Instagram Profiles** - โœ… Dataset transformation fields configured for display: `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` in code) to support more reliable execution. - **Limitations** - โŒ Collection may produce fewer than `max_leads` if enrichment fails for some profiles or if no additional profiles are found. - โŒ Private or restricted profiles are not expected to provide complete public profile metadata. *** ### FAQ #### Do I need an Instagram login to use Instagram Profile Finder? โœ… No. **Instagram Profile Finder** is designed to work without requiring you to log in, using publicly available sources to discover and enrich profile information. #### What does the `max_leads` setting control? `max_leads` sets the maximum number of leads the actor tries to collect per run. On Free tier runs, the actor caps collection at 100 profiles per run. #### Can I search for multiple niches in one run? โœ… Yes. You provide multiple items in the `keywords` array, and the actor processes each keyword until the global max limit is reached. #### What country filtering is supported? The `country` input supports a predefined set of country names from the schema. The actor uses that value to target results toward your selected region. #### What output do I get at the end? The actor pushes structured profile records to the **Instagram Profiles** dataset, including fields such as `keyword`, `full_name`, `biography`, follower counts, `external_url`, `profile_pic_url`, `source`, and `url`. #### Where do the results come from? The dataset records include `source: "Search Engine"` and are based on publicly available web data used for profile discovery, followed by an enrichment step for profile details. #### Is the actor compliant with privacy and platform rules? โœ… The actor is intended for scraping publicly available sources, but compliance with laws and platform terms (for example, GDPR/CCPA, spam regulations, and usage policies) is your responsibility. *** ### Support & feature requests Have questions about **Instagram Profile Finder** or want to suggest improvements for better instagram profile search results? ๐Ÿ’ก - ๐Ÿ’ก **Feature Requests**: For example, enhancements like additional dataset fields or improved export options are welcome. - ๐Ÿ“ง **Contact**: Email . Your feedback helps shape future upgrades to the **Instagram Profile Finder** experience. *** ### Closing CTA / Final thoughts *If youโ€™re looking for the most practical, SEO-optimized way to run an Instagram Profile Finder workflow at scale, youโ€™re in the right place.* โœ… *** ### Disclaimer **This tool only accesses publicly accessible sources.** It does not access private profiles, password-protected pages, or authenticated data behind logins. Legal compliance (including GDPR, CCPA, spam regulations, and Instagram platform terms) is your responsibility. For data-removal requests, contact . Please use **Instagram Profile Finder** responsibly, ethically, and for legitimate purposes only. # 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("scraperoka/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("scraperoka/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 scraperoka/instagram-profile-finder --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scraperoka/instagram-profile-finder", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Instagram Profile Finder", "description": "๐Ÿ”Ž Instagram Profile Finder helps you discover and connect faster! Find relevant profiles with powerful search tools. Ideal for creators, marketers & businesses. Save time, boost outreach, and grow your network ๐Ÿš€", "version": "1.0", "x-build-id": "2ortflFz53FiZhoum" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraperoka~instagram-profile-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraperoka-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/scraperoka~instagram-profile-finder/runs": { "post": { "operationId": "runs-sync-scraperoka-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/scraperoka~instagram-profile-finder/run-sync": { "post": { "operationId": "run-sync-scraperoka-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 } } } } } } } } } } ```