# Instagram Keyword Profile Scraper (`vulnv/instagram-keyword-profile-scraper`) Actor Discover public Instagram profiles built from keywords, then return enriched profile details in bulk. - **URL**: https://apify.com/vulnv/instagram-keyword-profile-scraper.md - **Developed by:** [VulnV](https://apify.com/vulnv) (community) - **Categories:** Social media, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $0.005 / result 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 by Keyword Find Instagram profiles matching any keyword or niche and extract their public details — including bio, follower count, business category, and email address. Enter a keyword like **"vegan bakery London"** or **"fitness coach"** and the actor returns a list of matching Instagram profiles with their full public data. --- ### What you get Each result is one enriched Instagram profile: | Field | Description | |---|---| | `profile_url` | Full Instagram profile URL | | `full_name` | Display name | | `biography` | Bio text | | `followers` | Follower count | | `following` | Following count | | `posts_count` | Number of posts | | `email` | Email address extracted from bio or structured data | | `external_url` | Website link(s) from the profile | | `is_business_account` | Whether the account is a business/creator account | | `business_category_name` | Business category (e.g. "Travel", "Fitness", "Food") | --- ### Example output ```json { "profile_url": "https://www.instagram.com/veganbakerylondon", "full_name": "The Vegan Bakery London", "biography": "Plant-based cakes & pastries 🌱 London | Orders: hello@veganbakerylondon.co.uk", "followers": 18400, "following": 612, "posts_count": 304, "email": "hello@veganbakerylondon.co.uk", "external_url": ["https://veganbakerylondon.co.uk"], "is_business_account": true, "business_category_name": "Bakery" } ```` *** ### Input | Field | Required | Description | |---|---|---| | **Keyword** | ✅ | Any word, phrase, or niche (e.g. `fitness coach`, `london florist`) | | **Max Results** | — | How many profiles to return. Default: 100. Set to 0 for no limit. | *** ### Use cases - **Influencer outreach** — Find creators in any niche and reach out via their bio email - **Lead generation** — Build targeted lists of Instagram businesses by category - **Market research** — Discover who's active in a given space - **Agency prospecting** — Find potential clients by service type or location *** ### How it works 1. Searches Google for Instagram profiles matching your keyword 2. Filters results to profile pages only (no posts, reels, or explore pages) 3. Deduplicates matches across search pages 4. Enriches each profile with full public Instagram data 5. Stops as soon as your Max Results limit is reached *** ### Pricing This actor uses **pay-per-result** billing at **$0.005 per profile**. **Examples:** - 100 profiles: ~$0.50 - 500 profiles: ~$2.50 - 1,000 profiles: ~$5.00 *** ### Notes - Only public Instagram profiles are returned - Email addresses are extracted from bio text and structured profile data where available — not all profiles will have one - Results may vary by keyword specificity and region # Actor input Schema ## `keyword` (type: `string`): Keyword or bio phrase used to discover matching Instagram profiles through search results. ## `maxResults` (type: `integer`): Maximum number of unique Instagram profiles to enrich and return. Use 0 for no limit. ## `randomizeSearch` (type: `boolean`): When enabled, search result pages are picked randomly from across Google's index rather than starting from page 1. Each run returns a different set of profiles. Note: this may return fewer profiles than requested, since some randomly selected pages may contain fewer matching results. ## Actor input object example ```json { "keyword": "travel influencer", "maxResults": 10, "randomizeSearch": false } ``` # Actor output Schema ## `results` (type: `string`): Default dataset items containing enriched Instagram profile records discovered from keyword search. ## `runSummary` (type: `string`): Key-value store record with discovery counts, batch failures, and keyword-level summary details. # 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 = { "keyword": "travel influencer", "maxResults": 10, "randomizeSearch": false }; // Run the Actor and wait for it to finish const run = await client.actor("vulnv/instagram-keyword-profile-scraper").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 = { "keyword": "travel influencer", "maxResults": 10, "randomizeSearch": False, } # Run the Actor and wait for it to finish run = client.actor("vulnv/instagram-keyword-profile-scraper").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 '{ "keyword": "travel influencer", "maxResults": 10, "randomizeSearch": false }' | apify call vulnv/instagram-keyword-profile-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=vulnv/instagram-keyword-profile-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Instagram Keyword Profile Scraper", "description": "Discover public Instagram profiles built from keywords, then return enriched profile details in bulk.", "version": "1.0", "x-build-id": "cvlioI86JNG1deEMa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/vulnv~instagram-keyword-profile-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-vulnv-instagram-keyword-profile-scraper", "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/vulnv~instagram-keyword-profile-scraper/runs": { "post": { "operationId": "runs-sync-vulnv-instagram-keyword-profile-scraper", "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/vulnv~instagram-keyword-profile-scraper/run-sync": { "post": { "operationId": "run-sync-vulnv-instagram-keyword-profile-scraper", "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": [ "keyword" ], "properties": { "keyword": { "title": "Keyword", "type": "string", "description": "Keyword or bio phrase used to discover matching Instagram profiles through search results." }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum number of unique Instagram profiles to enrich and return. Use 0 for no limit.", "default": 100 }, "randomizeSearch": { "title": "Randomize Search Pages", "type": "boolean", "description": "When enabled, search result pages are picked randomly from across Google's index rather than starting from page 1. Each run returns a different set of profiles. Note: this may return fewer profiles than requested, since some randomly selected pages may contain fewer matching results.", "default": false } } }, "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 } } } } } } } } } } ```