# Instagram Lead Finder (`brilliant_gum/instagram-lead-finder`) Actor Find Instagram leads by hashtag or username. Extract verified emails and phones from bios and websites, score every profile 0-100, classify influencer tiers, and detect niches. Export enriched leads ready for outreach. - **URL**: https://apify.com/brilliant\_gum/instagram-lead-finder.md - **Developed by:** [Yuliia Kulakova](https://apify.com/brilliant_gum) (community) - **Categories:** Lead generation, Social media, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $30.00 / 1,000 leads 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 Lead Finder [![Instagram Lead Finder](https://i.imgur.com/rqblNRI.png)](https://apify.com/store) Turn any Instagram hashtag or username list into a scored, enriched lead database with verified emails, phone numbers, and cross-platform social links — ready for outreach in minutes. --- ### What you get for every profile - **Email address** — extracted from bio text and by crawling the profile's linked website (homepage + /contact page). Website crawl finds 3-5x more emails than bio alone - **Email verification** — every email is checked via DNS MX record lookup. You see `valid`, `invalid`, or `uncertain` — no guessing - **Phone number** — extracted from bio (international and domestic formats) - **LinkedIn & Twitter links** — cross-referenced from bio text, so you can reach leads on multiple platforms - **Lead score 0-100** — transparent, honest scoring based on 7 signals. You see exactly why each profile scored the way it did - **Influencer tier** — rising, nano, micro, macro, or mega — based on follower count - **Niche category** — 15 categories auto-detected from bio keywords (fitness, business, marketing, tech, beauty, and more) - **Full profile data** — followers, following, posts count, verified badge, business account flag, bio text, profile picture, website URL --- ### Quick start **Option 1 — Enrich specific accounts (no login needed):** ```json { "usernames": ["natgeo", "nasa", "nike"] } ```` **Option 2 — Find leads by hashtag (requires session cookie):** ```json { "hashtags": ["fitnesscoach", "digitalmarketing"], "maxResultsPerHashtag": 50, "sessionCookie": "YOUR_SESSIONID_HERE" } ``` That's it. The actor handles everything else — extraction, enrichment, verification, scoring, and filtering. *** ### Use cases #### Find micro-influencers for brand deals Search hashtags like `#fitnesscoach` or `#beautyblogger`, filter by 10K-100K followers and minimum engagement rate. Get a list of creators who actually have contact info and are reachable. ```json { "hashtags": ["fitnesscoach", "personaltrainer"], "minFollowers": 10000, "maxFollowers": 100000, "minEngagementRate": 1.0, "minLeadScore": 30, "sessionCookie": "YOUR_SESSIONID_HERE" } ``` #### Build a B2B prospect list Target founders, consultants, and agency owners by filtering bios for business keywords. The lead score prioritizes profiles that have email, website, and phone — the contacts most likely to convert. ```json { "hashtags": ["socialmediamarketing", "digitalagency"], "bioKeywords": ["founder", "CEO", "agency", "consultant"], "minLeadScore": 35, "sessionCookie": "YOUR_SESSIONID_HERE" } ``` #### Enrich a competitor's follower list Already have a list of Instagram handles? Drop them in and get full enrichment — emails, phones, scores, tiers, niches — without needing a session cookie. ```json { "usernames": ["account1", "account2", "account3"], "crawlWebsites": true, "verifyEmails": true } ``` #### Find UGC creators open to collabs Search for creators who mention collaboration availability in their bio. Filter for those with real contact info. ```json { "hashtags": ["ugccreator", "contentcreator"], "bioKeywords": ["collabs", "available for", "DM for", "partnerships"], "minLeadScore": 20, "sessionCookie": "YOUR_SESSIONID_HERE" } ``` *** ### Lead score explained Every profile gets a transparent score from 0 to 100. Here's how it works: | Signal | Points | What it means | |--------|--------|---------------| | Email in bio | 25 | Direct contact found in profile text | | Email on website | 20 | Contact found by crawling linked website | | Phone in bio | 15 | Phone number found in profile text | | Has website | 10 | Profile links to an external website | | Engagement rate | 15 | Higher engagement = more points (capped at 10%) | | Follower reach | 10 | Log scale — bigger audience = more points | | Business account | 5 | Business or creator account type | **Score guide:** - **60-100** — High-value lead. Has email, website, strong engagement - **30-59** — Warm lead. Partial contact data, worth reaching out - **0-29** — Low priority. Limited contact info available Every score comes with a full breakdown so you can see exactly where the points came from. *** ### Output example ```json { "username": "nasa", "fullName": "NASA", "profileUrl": "https://www.instagram.com/nasa/", "bio": "Making the seemingly impossible, possible.", "website": "https://www.nasa.gov", "category": "Government Agencies", "followersCount": 104352106, "followingCount": 91, "postsCount": 4792, "isVerified": true, "isBusinessAccount": true, "bioEmail": null, "websiteEmail": "hqnews-join@newsletters.nasa.gov", "primaryEmail": "hqnews-join@newsletters.nasa.gov", "emailVerification": "valid", "bioPhone": null, "linkedinUrl": null, "twitterUrl": null, "influencerTier": "mega", "niche": "Government Agencies", "engagementRate": 0.2754, "leadScore": 45, "leadScoreBreakdown": { "hasEmail": 0, "hasWebsiteEmail": 20, "hasPhone": 0, "hasWebsite": 10, "followersLog": 10, "engagementRate": 0, "isBusinessAccount": 5 } } ``` *** ### Influencer tiers | Tier | Follower range | |------|---------------| | Rising | Under 1K | | Nano | 1K - 9.9K | | Micro | 10K - 99K | | Macro | 100K - 999K | | Mega | 1M+ | *** ### Niche categories The actor detects 15 niche categories from bio keywords: Fitness, Health, Beauty, Fashion, Food, Travel, Business, Marketing, Tech, Photography, Real Estate, Finance, Education, Parenting, Lifestyle If the profile has an official Instagram category set, that takes priority. *** ### Filters | Filter | What it does | |--------|-------------| | Min/Max Followers | Target a specific audience size range | | Bio Keywords | Only include profiles mentioning specific terms | | Min Engagement Rate | Filter out low-engagement accounts | | Min Lead Score | Only export leads above your quality threshold | All filters stack — set as many as you need to get exactly the leads you want. *** ### Session cookie Hashtag search requires an Instagram session cookie. Direct username mode works without one. **How to get it:** 1. Log in to Instagram in your browser 2. Open DevTools (F12) → Application → Cookies → instagram.com 3. Copy the value of `sessionid` 4. Paste it into the Session Cookie input field Your cookie is stored securely and never logged. *** ### Pricing This actor uses **pay-per-event** pricing: - **$0.03 per lead** saved to the dataset - You only pay for results that pass all your filters - No monthly fees, no subscriptions - Platform fees (compute + proxy) are billed separately by Apify at cost **Example:** 100 leads = $3.00 + platform fees *** ### FAQ **Do I need a session cookie?** Only for hashtag search. If you're enriching a list of usernames, no cookie is needed. **Can I scrape private accounts?** No. Private accounts are detected and marked as `isPrivate: true`, but their data is not accessible. **Why is engagement rate null for some profiles?** Instagram doesn't always include post engagement data in the API response. When this happens, the actor reports `null` rather than guessing. **Why is the email null even with website crawl enabled?** Some websites don't have a publicly visible email address, or use contact forms instead. The actor checks the homepage and common contact pages (/contact, /contact-us, /about, /about-us). **Is this safe to use?** The actor uses Instagram's own web API endpoint — the same one your browser calls when you visit a profile. It runs through residential proxies and respects rate limits. # Actor input Schema ## `hashtags` (type: `array`): Instagram hashtags to search for leads (without the # symbol). The actor will visit the hashtag explore page and collect profiles from top posts. Example: \['fitnesscoach', 'socialmediamarketer'] ## `usernames` (type: `array`): Instagram usernames or profile URLs to scrape directly (bypasses hashtag search). Example: \['natgeo', 'https://www.instagram.com/nasa/'] ## `maxResultsPerHashtag` (type: `integer`): Maximum number of profiles to collect per hashtag. Profiles come from the top posts on the hashtag explore page. ## `minFollowers` (type: `integer`): Only include profiles with at least this many followers. Set to 0 to include all. ## `maxFollowers` (type: `integer`): Only include profiles with at most this many followers. Set to 0 for no upper limit. Useful for finding micro-influencers. ## `minEngagementRate` (type: `number`): Only include profiles with an engagement rate above this threshold. Engagement rate = (avg likes + avg comments) / followers \* 100. Set to 0 to disable. ## `bioKeywords` (type: `array`): Only include profiles whose bio contains at least one of these keywords (case-insensitive). Leave empty to include all profiles. ## `crawlWebsites` (type: `boolean`): If enabled, the actor will visit each profile's linked website and extract email addresses from the homepage and /contact page. This increases emails found by 3-5x compared to bio-only extraction. ## `verifyEmails` (type: `boolean`): If enabled, performs DNS MX record lookup to verify that the email domain can receive mail. Results: 'valid', 'invalid', or 'uncertain'. ## `minLeadScore` (type: `integer`): Only output profiles that score at or above this threshold. Score is based on: has email (25pts), website email (20pts), has phone (15pts), has website (10pts), engagement rate (15pts), followers (10pts), is business (5pts). ## `sessionCookie` (type: `string`): Your Instagram 'sessionid' cookie value. Required for hashtag explore pages. Without this, hashtag crawling will fail with a login redirect. Get it from your browser: DevTools → Application → Cookies → instagram.com → sessionid. ## `proxyConfiguration` (type: `object`): Built-in residential proxy is included. Override only if needed. ## Actor input object example ```json { "hashtags": [ "fitnesscoach", "socialmediamarketer" ], "usernames": [ "natgeo", "nasa" ], "maxResultsPerHashtag": 50, "minFollowers": 1000, "maxFollowers": 100000, "minEngagementRate": 2.5, "bioKeywords": [ "coach", "consultant", "founder", "CEO" ], "crawlWebsites": true, "verifyEmails": true, "minLeadScore": 25, "sessionCookie": "12345678%3AabcdefghijklmnOP%3A12%3A..." } ``` # Actor output Schema ## `results` (type: `string`): No description # 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 = { "usernames": [ "natgeo" ] }; // Run the Actor and wait for it to finish const run = await client.actor("brilliant_gum/instagram-lead-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 = { "usernames": ["natgeo"] } # Run the Actor and wait for it to finish run = client.actor("brilliant_gum/instagram-lead-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 '{ "usernames": [ "natgeo" ] }' | apify call brilliant_gum/instagram-lead-finder --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=brilliant_gum/instagram-lead-finder", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Instagram Lead Finder", "description": "Find Instagram leads by hashtag or username. Extract verified emails and phones from bios and websites, score every profile 0-100, classify influencer tiers, and detect niches. Export enriched leads ready for outreach.", "version": "1.0", "x-build-id": "siZDjEyDB4C82BR0W" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/brilliant_gum~instagram-lead-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-brilliant_gum-instagram-lead-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/brilliant_gum~instagram-lead-finder/runs": { "post": { "operationId": "runs-sync-brilliant_gum-instagram-lead-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/brilliant_gum~instagram-lead-finder/run-sync": { "post": { "operationId": "run-sync-brilliant_gum-instagram-lead-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", "properties": { "hashtags": { "title": "Hashtags to Search", "type": "array", "description": "Instagram hashtags to search for leads (without the # symbol). The actor will visit the hashtag explore page and collect profiles from top posts. Example: ['fitnesscoach', 'socialmediamarketer']", "items": { "type": "string" } }, "usernames": { "title": "Direct Usernames", "type": "array", "description": "Instagram usernames or profile URLs to scrape directly (bypasses hashtag search). Example: ['natgeo', 'https://www.instagram.com/nasa/']", "items": { "type": "string" } }, "maxResultsPerHashtag": { "title": "Max Results Per Hashtag", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of profiles to collect per hashtag. Profiles come from the top posts on the hashtag explore page.", "default": 50 }, "minFollowers": { "title": "Min Followers", "minimum": 0, "type": "integer", "description": "Only include profiles with at least this many followers. Set to 0 to include all.", "default": 0 }, "maxFollowers": { "title": "Max Followers", "minimum": 0, "type": "integer", "description": "Only include profiles with at most this many followers. Set to 0 for no upper limit. Useful for finding micro-influencers.", "default": 0 }, "minEngagementRate": { "title": "Min Engagement Rate (%)", "minimum": 0, "type": "number", "description": "Only include profiles with an engagement rate above this threshold. Engagement rate = (avg likes + avg comments) / followers * 100. Set to 0 to disable.", "default": 0 }, "bioKeywords": { "title": "Bio Keywords Filter", "type": "array", "description": "Only include profiles whose bio contains at least one of these keywords (case-insensitive). Leave empty to include all profiles.", "items": { "type": "string" } }, "crawlWebsites": { "title": "Crawl Profile Websites for Emails", "type": "boolean", "description": "If enabled, the actor will visit each profile's linked website and extract email addresses from the homepage and /contact page. This increases emails found by 3-5x compared to bio-only extraction.", "default": true }, "verifyEmails": { "title": "Verify Emails via MX Check", "type": "boolean", "description": "If enabled, performs DNS MX record lookup to verify that the email domain can receive mail. Results: 'valid', 'invalid', or 'uncertain'.", "default": true }, "minLeadScore": { "title": "Min Lead Score (0-100)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Only output profiles that score at or above this threshold. Score is based on: has email (25pts), website email (20pts), has phone (15pts), has website (10pts), engagement rate (15pts), followers (10pts), is business (5pts).", "default": 0 }, "sessionCookie": { "title": "Instagram Session Cookie (sessionid)", "type": "string", "description": "Your Instagram 'sessionid' cookie value. Required for hashtag explore pages. Without this, hashtag crawling will fail with a login redirect. Get it from your browser: DevTools → Application → Cookies → instagram.com → sessionid." }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Built-in residential proxy is included. Override only if needed." } } }, "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 } } } } } } } } } } ```