# Instagram Related Profiles Scraper (`afanasenko/instagram-related-profiles-scraper`) Actor Discover related Instagram profiles via Instagram's Suggested for You algorithm. Expand from 1-5 seed accounts to find similar creators, qualify leads, and grow your network. Filter by engagement, contact info, language, business category, and more. - **URL**: https://apify.com/afanasenko/instagram-related-profiles-scraper.md - **Developed by:** [Andrey Afanasenko](https://apify.com/afanasenko) (community) - **Categories:** Lead generation, Social media, Automation - **Stats:** 13 total users, 8 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing $10.00 / 1,000 profile analyzeds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 Related Profiles Scraper [![Apify Actor](https://apify.com/actor-badge?actor=afanasenko/instagram-related-profiles-scraper)](https://apify.com/afanasenko/instagram-related-profiles-scraper) > **Discover similar Instagram profiles** via Instagram's own *Suggested for You* algorithm. > Expand from 1–5 seed accounts to find related creators, qualify leads, and map a niche — with 25+ built-in filters and full enrichment (bio, contacts, engagement, Reels analytics, language). ### 🎯 What it does You give the actor 1–5 Instagram usernames you already know are relevant (a customer, a competitor, a creator you like). For each seed it asks Instagram for the **«Suggested for You» list** — the same suggestions you'd see in the app's «Discover People» tray — and returns one row per discovered profile, fully enriched. At **depth 2** the actor recursively expands the suggestions of suggestions, surfacing a much wider network from a single seed. For every profile that comes back you get: - **Identity** — handle (Account URL), Full Name, Profile Picture, verified flag. - **Audience** — Followers Count, Following Count, Total Posts, Posts per Month, Posts in Last 30 Days, Last Post age in days. - **Reels analytics** — Reels Count, Last Reel age, Median Views, Views/Followers ratio. - **Engagement** — Avg Likes, Avg Comments, Median Engagement Rate, Quality flag (Good / Poor). - **Contact** — Email (from contact field or bio), Email Source, Phone, External URL, Physical Address. - **Classification** — Business Category, Detected Language, Tagged Location, Account Type. - **Optional post sample** — captions of the 8 most recent feed posts, plus contacts parsed from those captions. Then the actor applies **your filters** (followers band, engagement floor, language, business category, contact-channel presence, posting cadence, Reels view ratio, verification, and more) so only the profiles that match your target persona end up in the dataset. ### ⚡ Quick start A minimal input that works on the **free plan** (5 profiles, no extra setup): ```json { "startUsernames": ["openai"], "searchDepth": "1", "maxCountExpansion": 5 } ```` Run it once, open the **Storage → Dataset** tab, and you'll see 5 profiles similar to @openai with a full row of metrics each. From there, layer filters in the input form to narrow to your target. ### 📦 What you get — output sample Every analyzed profile is pushed to the dataset as one item. Here's a real row (truncated for readability): ```json { "Account": "https://instagram.com/brezscales", "Full Name": "Brez", "Source": "Network Expansion", "Followers Count": 1320754, "Following Count": 943, "Biography": "i scale brands and own cool cars\nbuilding… @brezmarketing", "Email": "N/A", "Email Source": "N/A", "Phone": "N/A", "External URL": "https://go.ai-advertiser.com/free-live-class", "Address": "N/A", "Category": "N/A", "Profile Picture": "https://…cdninstagram.com/…/profile.jpg", "Reels Count": 12, "Last Reel (Days Ago)": 0, "Median Views": 238321, "Avg Likes": 141178, "Avg Comments": 822, "Views/Followers Ratio": "18.04%", "Posts in Last 30 Days": 1, "Posts per Month": 1, "Total Posts": 24, "Detected Language": "English", "Last Post Within (Days)": 0, "Median ER": "10.39%", "Quality": "Good" } ``` Missing optional values come back as the string `"N/A"` (not `null`), so every key is always present and downstream code can rely on a stable shape. The full per-field schema (types, descriptions, examples) is published in [`.actor/dataset_schema.json`](.actor/dataset_schema.json) — that's also what AI agents see when they call the actor through Apify's MCP server. ### 🧭 When to use it - **Lead generation.** You found one ideal customer or partner on Instagram. Expand from them to reach a list of look-alike accounts to qualify and contact. - **Influencer marketing.** You like one creator's content / audience. Expand to discover comparable creators in the same niche, then filter by engagement rate, follower band, and posting cadence. - **Competitor research.** Map who Instagram thinks is adjacent to a competitor — surfaces both direct and tangential rivals. - **Niche audit.** From a single anchor account, build a seed list of 50–500 qualified profiles in a vertical you don't yet know. - **Audience expansion.** Generate a high-quality top-of-funnel list before reaching out, instead of hash-tag-scraping noise. ### 🛠 Input The input form is grouped into three sections: | Section | Purpose | |---|---| | **🎯 Profiles to Analyze** | Seed handles + how deep to expand. | | **⚙️ Data Extraction Options** | Which enrichments to run (email, phone, posts, engagement). Off = skip the API call → faster + cheaper. | | **🔬 Advanced Filtering (Optional)** | 20+ filters that drop non-matching profiles before they're billed. | | **▶️ Run & Storage Options** | Resume from checkpoint, offline re-filter mode. | Highlights of the most useful fields (full reference in the input form): - **`startUsernames`** — 1–5 seed handles (without `@`). Up to 5 seeds; depth-2 expansion can yield hundreds per seed. - **`searchDepth`** — `1` (related of seeds, recommended) or `2` (related of related — paid plan only). - **`maxCountExpansion`** — hard cost ceiling, in profiles. Set to your **spend budget × 100** (e.g. `1000` = $10). - **`analyzeQuality`** — turn on for Engagement Rate + Quality flag (default on). - **`extractPosts`** — turn on to fetch the 8 most recent post captions; required for `lastPostDays`, `minPostsInPeriod`, `keywordLocation=posts`, and `searchContactsInPosts`. - **`minFollowers` / `maxFollowers`** — the most-used filter, set as a band (e.g. 5 000–100 000 for nano/micro). - **`minEngagementRate`** — common B2B floor: 1–3 %. - **`viewFollowerRatioMin` / `Max`** — drop bot-inflated and one-hit-viral accounts. - **`contactInfoType`** — only keep profiles with the contact channel you'll actually use (`emailOrPhone`, `emailOnly`, etc.). - **`profileLanguage`** — restrict to one of 13 detected languages. ### 💰 Pricing The actor uses Apify's **Pay Per Event** model with **one single primary event**: | Event | Price | Triggered | |---|---|---| | **Profile Analyzed** | **$0.01** | Once per discovered profile that's successfully retrieved (live or from cache) and analyzed, regardless of whether it passes your filters. | You're billed per profile, not per API call. The cost ceiling `maxCountExpansion` translates directly to your maximum spend. #### Pricing math | You set `maxCountExpansion` | Plan | Approx cost | |---|---|---| | 5 | Free | $0.05 (free-plan ceiling) | | 100 | Paid | $1.00 | | 500 | Paid | $5.00 | | 1 000 | Paid | $10.00 | | 5 000 | Paid | $50.00 | Tighter filters mean more profiles are retrieved and analyzed before you find matches, so be conservative with `maxCountExpansion` if you stack many filters. ### 🆓 Free vs paid plan | | Free plan | Paid plan | |------------------------------------------------|-----------|-----------| | Profiles per run | 5 | unlimited | | Search depth | 1 only | 1 or 2 | | Filters (followers, language, engagement, etc.)| ✓ | ✓ | | Reels analytics (Median Views, Views/Followers) | blanked | full | | Resume from checkpoint | ✓ | ✓ | | Single PPE event ($0.01 / profile) | n/a (free-tier ceiling) | yes | Upgrade to a paid plan to remove the 5-profile cap, unlock depth-2 expansion, and see Reels view analytics. ### 🧪 Filter recipes Common stacks that work well together: **Nano-influencer outreach (B2C beauty / fitness)** ```json { "startUsernames": ["sephora"], "searchDepth": "2", "maxCountExpansion": 500, "minFollowers": 5000, "maxFollowers": 100000, "minEngagementRate": 2, "extractPosts": true, "lastPostDays": 30, "contactInfoType": "emailOrPhone", "filterForInfluencers": true } ``` **B2B partnership shortlist** ```json { "startUsernames": ["hubspot"], "searchDepth": "1", "maxCountExpansion": 200, "minFollowers": 10000, "viewFollowerRatioMin": 5, "viewFollowerRatioMax": 30, "accountType": "business", "hasWebsite": true, "profileLanguage": "English" } ``` **Local-market discovery (restaurants, services)** ```json { "startUsernames": ["londoneats"], "searchDepth": "2", "maxCountExpansion": 300, "extractPhysicalAddress": true, "locationKeywords": "London, UK", "categoryFilter": "Restaurant" } ``` ### 🔁 Resume / checkpoint Long runs can be interrupted (timeout, manual stop, abort). The actor writes a checkpoint to its key-value store after every batch. To resume, simply run the actor again with **`clearSavedData`** unchecked — already-analyzed profiles are not re-billed. ### 🧊 Offline mode Already paid for a profile cache and want to re-filter it with new criteria? Set `enableOfflineMode: true`. The run reads from the cached profile data, applies the current filters, and writes a fresh dataset — **with no Instagram API calls and no paid events**. Ideal for iterating on filter values cheaply. ### 📡 Live status & storage records While the run is in progress, the actor exposes: | Storage key | Type | What it holds | |---|---|---| | `status.html` | HTML page | Live progress, costs, ETA. Open it from the run's Storage tab. | | `RUN_SUMMARY` | JSON | Aggregate run statistics — counts, plan, pricing, timings. Available after the run finishes. | | `SKIPPED_ACCOUNTS` | JSON | Per-username list of profiles skipped during the run, with reason and category (filter / not\_found / private / error). Re-run the error cohort separately if you want. | | `USER_MESSAGE` | JSON | Onboarding banner shown on a paying user's 1st and 3rd paid run. Empty otherwise. | These are stable, machine-readable surfaces — pull them via the Apify API for dashboards or post-processing. ### 🤖 Programmatic / API use Run the actor from your own code or AI agent: **REST API (start a run, poll for completion):** ```bash curl -X POST "https://api.apify.com/v2/acts/afanasenko~instagram-related-profiles-scraper/runs?token=$APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "startUsernames": ["openai"], "searchDepth": "1", "maxCountExpansion": 100 }' ``` **MCP / agentic clients (Claude, ChatGPT, Cursor, LangGraph, OpenAI Agents SDK, Mastra, …):** The actor is automatically exposed as a tool through Apify's [MCP server](https://docs.apify.com/platform/integrations/mcp) at `mcp.apify.com`. Once your MCP-enabled client is connected to your Apify token, an LLM can search, inspect input + output schemas, and run the actor with natural-language instructions like *"Find 50 fitness creators in the UK with 10–50k followers and an engagement rate above 3%"*. ### ❓ FAQ **Q: How does the actor know which profiles are «similar»?** A: It uses Instagram's own «Suggested for You» recommendations — the same list users see in the «Discover People» tray. We don't infer similarity ourselves; the algorithm is whatever Instagram's recommender returns at run time. **Q: Can I run this on a private Instagram account?** A: No. The seed accounts must be public, and only public profile data is returned. **Q: How is engagement rate calculated?** A: For each of the most recent feed posts, `(likes + comments) / followers`, then median across the sample. The median is more robust to viral outliers than the mean. **Q: What does the Quality flag mean?** A: A heuristic combining engagement rate and audience signals. **Good** = recommend reaching out. **Poor** = likely low-engagement or inflated audience. Treat it as a quick filter, not a verdict. **Q: Why are my Reels metrics blank?** A: Reels analytics (`Median Views`, `Last Reel (Days Ago)`, `Views/Followers Ratio`) require a paid plan. On the free plan, those columns return `"N/A"`. **Q: Why do I see «N/A» instead of `null` for missing values?** A: It's a deliberate choice — every output key is always present so Google Sheets, Airtable, and CSV consumers don't have to special-case missing fields. If you need null, it's a one-line transform in your post-processing. **Q: Can the actor scrape stories, posts, or DMs?** A: This actor focuses on profile-level data and the 8 most recent post captions. For full post / Reel / story analytics, see the Instagram Profile Scraper linked below. **Q: Will I get the same profiles for the same seed across runs?** A: Mostly, but not deterministically. Instagram's recommender shifts day-to-day. Re-running the same seed a week later typically returns a 70–90 % overlap with the previous list. **Q: How fast is it?** A: Roughly **1 profile per second** on a single seed at depth 1, depending on which enrichments you turn on. A 100-profile run finishes in ~2 minutes; a 1 000-profile run in ~15–20 minutes. **Q: What if a profile errors out mid-run?** A: It lands in `SKIPPED_ACCOUNTS` with `category: "error"`. Most errors are transient (Instagram rate-limit, transient network); re-run the error cohort with `clearSavedData: false` to retry without re-billing. ### 🔗 Other Instagram scrapers (same author) This actor is part of a family of focused Instagram tools — pick the one that matches your discovery model: | You start with… | You want to find… | Use this actor | |---|---|---| | 1–5 seed handles you like | Similar / suggested profiles in the same niche | **This actor** — Network Expansion | | One known account | The full list of its **followers** or **following** (with filters & enrichment) | [Instagram Followers & Following Extractor](https://apify.com/afanasenko/instagram-followers-scraper) | | Anything else (handles, locations, hashtags, keywords) | All of the above + 4 other discovery modes in one tool | [Instagram Profile Scraper](https://apify.com/afanasenko/instagram-profile-scraper) — 5-mode all-in-one | The single-mode actors are simpler to configure and cheaper to run for one specific job; the all-in-one Profile Scraper is right when one project needs multiple discovery flows. ### 🛟 Support & feedback - **Open an issue** on the actor's [Issues tab in Apify Console](https://console.apify.com/actors/ABaRTNCVC8OINndno/issues) — fastest way to get a fix shipped. - **Feature requests** in the same tab; we read every one. - **Ratings & reviews** on the [Apify Store page](https://apify.com/afanasenko/instagram-related-profiles-scraper) help other users find the actor. ### ⚖️ Disclaimer This actor scrapes **publicly available** profile data from Instagram. It does not bypass authentication, scrape private profiles, or interact with content on your behalf. Use it in compliance with Instagram's Terms of Service and applicable privacy laws (GDPR, CCPA) — for outreach lists, ensure you have a legitimate interest and a clear unsubscribe path. The contact information returned (emails, phone numbers) is what the profile owner has chosen to make public on Instagram. # Actor input Schema ## `startUsernames` (type: `array`): Seed Instagram usernames (1–5, one per line) that the actor expands from. For each seed, fetches Instagram's Suggested-for-You suggestions; at depth 2 also recursively fetches suggestions of those suggestions. Provide handles without @ — e.g. natgeo, openai, nike. Maximum 5 seeds; depth-2 expansion can yield hundreds of profiles per seed. ## `searchDepth` (type: `string`): How deep to traverse Instagram's Suggested-for-You graph. 1 = related profiles of seed accounts only. 2 = also related-of-related (recursive — can yield hundreds to thousands of profiles per seed). Depth 2 requires a paid plan; free runs are silently capped at depth 1. ## `maxCountExpansion` (type: `integer`): Maximum number of unique profiles to discover and analyze this run — hard cost ceiling because each analyzed profile is one paid event ($0.01). 0 = no limit. Free plan ceiling: 5 profiles regardless of this value. Rule of thumb for paid plans: set to your spend budget × 100 (e.g. 1000 = $10). ## `extractEmail` (type: `boolean`): When true, extracts the profile's public email — first from the «Contact» button on business profiles, then by parsing the Biography text via regex. The Email Source column reports which path matched. Set false to skip email extraction; the Email column will then be N/A. ## `extractPhoneNumber` (type: `boolean`): When true, extracts the profile's public phone number from the «Contact» button (business accounts) or the Biography text. Default false (most lead-gen workflows rely on email/website). Set true if you need phones; the Phone column will then be populated. ## `extractWebsiteUrl` (type: `boolean`): When true, captures the website link set in the profile's bio link field (the single tappable URL Instagram allows). Set false to leave the External URL column as N/A. ## `extractBusinessCategory` (type: `boolean`): When true, captures the Instagram-assigned business category (e.g. «Magazine», «Public Figure», «Restaurant», «Photographer»). The Category column is N/A for personal accounts regardless of this setting. ## `extractPhysicalAddress` (type: `boolean`): When true, captures the public street address shown on a business profile (when the account discloses one). Off by default to keep runs fast — enable only if you need physical-location data or want to evaluate the locationKeywords filter against addresses. ## `analyzeQuality` (type: `boolean`): When true, computes Median Engagement Rate (likes+comments per follower per post) and assigns a Quality flag (Good / Poor). Required for the engagement-rate filter and for the views/followers ratio. Adds one extra API call per profile. On the free plan ER is computed but Reels-view analytics are blanked. ## `minEngagementRate` (type: `integer`): Minimum median engagement rate (%) — profiles below this threshold are skipped. Engagement rate = (likes + comments) / followers per post, then median across recent posts. 0 = disabled. Requires analyzeQuality=true. Typical influencer-discovery floor: 1–3%. ## `extractPosts` (type: `boolean`): When true, captures the caption text of the 8 most recent feed posts into Post 1 … Post 8 columns. Adds one extra API call per profile. Required for filters that scan post content (lastPostDays, minPostsInPeriod, keywordLocation=posts) and for the search-contacts-in-posts feature. ## `searchContactsInPosts` (type: `boolean`): When true, runs the same email/phone regex extraction over the recent post captions and surfaces any matches in the Email from Posts / Phone from Posts columns. Requires extractPosts=true. Useful when creators publish contact info in pinned posts rather than the bio. ## `keywords` (type: `array`): Keyword filter — only include profiles where the configured location (see «Search Keywords In») contains any of these terms. Case-insensitive, OR semantics across the list. Empty = no keyword filter. ## `keywordLocation` (type: `string`): Where to look for the Keywords filter terms. «posts» and «anywhere» scan post captions and therefore require extractPosts=true; the other options run against profile metadata only. ## `locationKeywords` (type: `string`): Location filter — only include profiles whose Tagged Location or public Address contains any of these comma-separated terms (case-insensitive, OR). Examples: «London, New York, UK». Empty = no location filter. Evaluating Address requires extractPhysicalAddress=true. ## `profileLanguage` (type: `string`): Language filter — only include profiles whose detected language (Biography + recent posts, via cld3) matches the selected option. «any» = no filter. Useful for restricting outreach to a single market. ## `minFollowers` (type: `integer`): Minimum follower count — profiles below this are skipped. 0 = no minimum. Combine with maxFollowers for a band (e.g. 5 000–100 000 for nano/micro-influencers). ## `maxFollowers` (type: `integer`): Maximum follower count — profiles above this are skipped. 0 = no maximum. Useful for excluding mega-accounts and brands when you target nano/micro-influencers. ## `lastPostDays` (type: `integer`): Recent-activity filter — only include profiles whose most recent feed post was published within the last N days. 0 = disabled. Requires extractPosts=true. Typical value: 30–90 to filter out dormant accounts. ## `lastReelDays` (type: `integer`): Recent-Reel filter — only include profiles that posted a Reel within the last N days. 0 = disabled. Useful for finding actively-publishing video creators. Paid plan only (Reels analytics). ## `minPostsInPeriod` (type: `integer`): Posting-frequency filter — only include profiles with at least this many feed posts in the last «postsCheckPeriodDays» days. 0 = disabled. Requires extractPosts=true. Use to filter out one-off-poster accounts. ## `postsCheckPeriodDays` (type: `string`): Window (in days) used by the minPostsInPeriod filter — measure posting frequency over the last 7, 14, or 30 days. Ignored when minPostsInPeriod=0. ## `minMedianViews` (type: `integer`): Minimum median Reel views — profiles below this are skipped. 0 = disabled. Useful for filtering out Reel-creators whose audience does not actually watch them. Paid plan only. ## `viewFollowerRatioMin` (type: `integer`): Minimum views/followers ratio (%) — profiles below this are skipped. Filters out creators with bot-inflated follower counts whose Reels rarely surface to their audience. 0 = disabled. B2B-targeting suggestion: 5%. Paid plan only. ## `viewFollowerRatioMax` (type: `integer`): Maximum views/followers ratio (%) — profiles above this are skipped. Filters out one-hit viral accounts that don't sustain audience attention. 0 = disabled. B2B-targeting suggestion: 30%. Paid plan only. ## `contactInfoType` (type: `string`): Contact-presence filter — only include profiles that publicly expose the chosen contact channel(s). Independent of the extract\* settings: a profile that has an email is kept even if extractEmail=false. Useful for outreach lists where every row needs a contact channel. ## `hasWebsite` (type: `boolean`): When true, only include profiles that have a website link in the bio (External URL is non-empty). Useful for filtering for monetized creators or brands with their own funnel. ## `accountType` (type: `string`): Account-type filter — restrict to business profiles (have a Category and may have a Contact button), personal profiles, or both. Most ecommerce / B2B targeting wants «business»; influencer discovery often wants «personal». ## `filterForInfluencers` (type: `boolean`): When true, only include profiles whose Category matches a curated list of influencer-style categories (Blogger, Artist, Public Figure, Digital Creator, Photographer, Athlete, Musician, etc.). Filters out brands, organizations, and most local businesses. Requires extractBusinessCategory=true. ## `categoryFilter` (type: `string`): Exact-match filter on Instagram's business category — only include profiles whose Category equals this. Examples: «Beauty Salon», «Photographer», «Restaurant», «Public Figure», «Coach», «Blogger», «Designer». Independent of filterForInfluencers. Full enum lists 700+ Instagram-supported categories; MCP clients see only the first ~10 due to truncation, so programmatic callers can pass any exact Instagram-supported category string. ## `filterCombination` (type: `string`): How to combine the categoryFilter and keywords filters when both are set. AND (default) = profile must match both. OR = profile passes if it matches either; in that case the output Matched By column reports which filter let each profile through (category, keyword, or both). ## `mustBeVerified` (type: `boolean`): When true, only include profiles with the verified blue checkmark. Excludes the vast majority of accounts. Useful for partnership outreach to known public figures. ## `clearSavedData` (type: `boolean`): When true (default), starts a fresh run and clears the previous run's profile cache + checkpoint. Set to false to resume an interrupted run from the checkpoint — already-analyzed profiles are not re-billed. ## `enableOfflineMode` (type: `boolean`): When true, runs entirely against the cached profile data from previous runs — no Instagram API calls, no paid events. Re-applies the current filter values to the already-scraped profiles for cheap re-filtering. Requires a non-empty profile cache from an earlier run. ## Actor input object example ```json { "startUsernames": [ "openai" ], "searchDepth": "1", "maxCountExpansion": 0, "extractEmail": true, "extractPhoneNumber": false, "extractWebsiteUrl": true, "extractBusinessCategory": true, "extractPhysicalAddress": false, "analyzeQuality": true, "minEngagementRate": 0, "extractPosts": false, "searchContactsInPosts": false, "keywords": [], "keywordLocation": "bio_or_name", "locationKeywords": "", "profileLanguage": "any", "minFollowers": 0, "maxFollowers": 0, "lastPostDays": 0, "lastReelDays": 0, "minPostsInPeriod": 0, "postsCheckPeriodDays": "30", "minMedianViews": 0, "viewFollowerRatioMin": 0, "viewFollowerRatioMax": 0, "contactInfoType": "any", "hasWebsite": false, "accountType": "any", "filterForInfluencers": false, "categoryFilter": "any", "filterCombination": "AND", "mustBeVerified": false, "clearSavedData": true, "enableOfflineMode": false } ``` # Actor output Schema ## `liveStatus` (type: `string`): No description ## `results` (type: `string`): No description ## `runSummary` (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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("afanasenko/instagram-related-profiles-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 = {} # Run the Actor and wait for it to finish run = client.actor("afanasenko/instagram-related-profiles-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 '{}' | apify call afanasenko/instagram-related-profiles-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=afanasenko/instagram-related-profiles-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Instagram Related Profiles Scraper", "description": "Discover related Instagram profiles via Instagram's Suggested for You algorithm. Expand from 1-5 seed accounts to find similar creators, qualify leads, and grow your network. Filter by engagement, contact info, language, business category, and more.", "version": "0.0", "x-build-id": "UmX5lXVexPrTiJlXQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/afanasenko~instagram-related-profiles-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-afanasenko-instagram-related-profiles-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/afanasenko~instagram-related-profiles-scraper/runs": { "post": { "operationId": "runs-sync-afanasenko-instagram-related-profiles-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/afanasenko~instagram-related-profiles-scraper/run-sync": { "post": { "operationId": "run-sync-afanasenko-instagram-related-profiles-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", "properties": { "startUsernames": { "title": "Start Profiles", "type": "array", "description": "Seed Instagram usernames (1–5, one per line) that the actor expands from. For each seed, fetches Instagram's Suggested-for-You suggestions; at depth 2 also recursively fetches suggestions of those suggestions. Provide handles without @ — e.g. natgeo, openai, nike. Maximum 5 seeds; depth-2 expansion can yield hundreds of profiles per seed.", "default": [ "openai" ], "items": { "type": "string" } }, "searchDepth": { "title": "Search Depth", "enum": [ "1", "2" ], "type": "string", "description": "How deep to traverse Instagram's Suggested-for-You graph. 1 = related profiles of seed accounts only. 2 = also related-of-related (recursive — can yield hundreds to thousands of profiles per seed). Depth 2 requires a paid plan; free runs are silently capped at depth 1.", "default": "1" }, "maxCountExpansion": { "title": "Max profiles to process (cost control)", "minimum": 0, "type": "integer", "description": "Maximum number of unique profiles to discover and analyze this run — hard cost ceiling because each analyzed profile is one paid event ($0.01). 0 = no limit. Free plan ceiling: 5 profiles regardless of this value. Rule of thumb for paid plans: set to your spend budget × 100 (e.g. 1000 = $10).", "default": 0 }, "extractEmail": { "title": "Extract Email", "type": "boolean", "description": "When true, extracts the profile's public email — first from the «Contact» button on business profiles, then by parsing the Biography text via regex. The Email Source column reports which path matched. Set false to skip email extraction; the Email column will then be N/A.", "default": true }, "extractPhoneNumber": { "title": "Extract Phone Number", "type": "boolean", "description": "When true, extracts the profile's public phone number from the «Contact» button (business accounts) or the Biography text. Default false (most lead-gen workflows rely on email/website). Set true if you need phones; the Phone column will then be populated.", "default": false }, "extractWebsiteUrl": { "title": "Extract Website URL", "type": "boolean", "description": "When true, captures the website link set in the profile's bio link field (the single tappable URL Instagram allows). Set false to leave the External URL column as N/A.", "default": true }, "extractBusinessCategory": { "title": "Extract Business Category", "type": "boolean", "description": "When true, captures the Instagram-assigned business category (e.g. «Magazine», «Public Figure», «Restaurant», «Photographer»). The Category column is N/A for personal accounts regardless of this setting.", "default": true }, "extractPhysicalAddress": { "title": "Extract Physical Address", "type": "boolean", "description": "When true, captures the public street address shown on a business profile (when the account discloses one). Off by default to keep runs fast — enable only if you need physical-location data or want to evaluate the locationKeywords filter against addresses.", "default": false }, "analyzeQuality": { "title": "Calculate Engagement Rate (ER)", "type": "boolean", "description": "When true, computes Median Engagement Rate (likes+comments per follower per post) and assigns a Quality flag (Good / Poor). Required for the engagement-rate filter and for the views/followers ratio. Adds one extra API call per profile. On the free plan ER is computed but Reels-view analytics are blanked.", "default": true }, "minEngagementRate": { "title": "Min Engagement Rate (%)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Minimum median engagement rate (%) — profiles below this threshold are skipped. Engagement rate = (likes + comments) / followers per post, then median across recent posts. 0 = disabled. Requires analyzeQuality=true. Typical influencer-discovery floor: 1–3%.", "default": 0 }, "extractPosts": { "title": "Extract Latest Post Captions", "type": "boolean", "description": "When true, captures the caption text of the 8 most recent feed posts into Post 1 … Post 8 columns. Adds one extra API call per profile. Required for filters that scan post content (lastPostDays, minPostsInPeriod, keywordLocation=posts) and for the search-contacts-in-posts feature.", "default": false }, "searchContactsInPosts": { "title": "Deep Search for Contacts in Posts", "type": "boolean", "description": "When true, runs the same email/phone regex extraction over the recent post captions and surfaces any matches in the Email from Posts / Phone from Posts columns. Requires extractPosts=true. Useful when creators publish contact info in pinned posts rather than the bio.", "default": false }, "keywords": { "title": "Filter by Keywords", "type": "array", "description": "Keyword filter — only include profiles where the configured location (see «Search Keywords In») contains any of these terms. Case-insensitive, OR semantics across the list. Empty = no keyword filter.", "default": [], "items": { "type": "string" } }, "keywordLocation": { "title": "Search Keywords In", "enum": [ "bio_or_name", "bio", "name", "posts", "anywhere" ], "type": "string", "description": "Where to look for the Keywords filter terms. «posts» and «anywhere» scan post captions and therefore require extractPosts=true; the other options run against profile metadata only.", "default": "bio_or_name" }, "locationKeywords": { "title": "Filter by Location Keywords", "type": "string", "description": "Location filter — only include profiles whose Tagged Location or public Address contains any of these comma-separated terms (case-insensitive, OR). Examples: «London, New York, UK». Empty = no location filter. Evaluating Address requires extractPhysicalAddress=true.", "default": "" }, "profileLanguage": { "title": "Filter by Profile Language", "enum": [ "any", "English", "Spanish", "German", "French", "Russian", "Italian", "Portuguese", "Chinese", "Japanese", "Arabic", "Hindi", "Indonesian", "Turkish" ], "type": "string", "description": "Language filter — only include profiles whose detected language (Biography + recent posts, via cld3) matches the selected option. «any» = no filter. Useful for restricting outreach to a single market.", "default": "any" }, "minFollowers": { "title": "Follower Count Range: Min", "type": "integer", "description": "Minimum follower count — profiles below this are skipped. 0 = no minimum. Combine with maxFollowers for a band (e.g. 5 000–100 000 for nano/micro-influencers).", "default": 0 }, "maxFollowers": { "title": "and Max", "type": "integer", "description": "Maximum follower count — profiles above this are skipped. 0 = no maximum. Useful for excluding mega-accounts and brands when you target nano/micro-influencers.", "default": 0 }, "lastPostDays": { "title": "Filter by Last Post Date", "type": "integer", "description": "Recent-activity filter — only include profiles whose most recent feed post was published within the last N days. 0 = disabled. Requires extractPosts=true. Typical value: 30–90 to filter out dormant accounts.", "default": 0 }, "lastReelDays": { "title": "Posted Reel Within (Days)", "minimum": 0, "type": "integer", "description": "Recent-Reel filter — only include profiles that posted a Reel within the last N days. 0 = disabled. Useful for finding actively-publishing video creators. Paid plan only (Reels analytics).", "default": 0 }, "minPostsInPeriod": { "title": "Filter by Posting Frequency: Min Posts", "type": "integer", "description": "Posting-frequency filter — only include profiles with at least this many feed posts in the last «postsCheckPeriodDays» days. 0 = disabled. Requires extractPosts=true. Use to filter out one-off-poster accounts.", "default": 0 }, "postsCheckPeriodDays": { "title": "in the last (days)", "enum": [ "7", "14", "30" ], "type": "string", "description": "Window (in days) used by the minPostsInPeriod filter — measure posting frequency over the last 7, 14, or 30 days. Ignored when minPostsInPeriod=0.", "default": "30" }, "minMedianViews": { "title": "Filter by Median Views", "type": "integer", "description": "Minimum median Reel views — profiles below this are skipped. 0 = disabled. Useful for filtering out Reel-creators whose audience does not actually watch them. Paid plan only.", "default": 0 }, "viewFollowerRatioMin": { "title": "Filter by Views/Followers Ratio: Min (%)", "minimum": 0, "type": "integer", "description": "Minimum views/followers ratio (%) — profiles below this are skipped. Filters out creators with bot-inflated follower counts whose Reels rarely surface to their audience. 0 = disabled. B2B-targeting suggestion: 5%. Paid plan only.", "default": 0 }, "viewFollowerRatioMax": { "title": "Filter by Views/Followers Ratio: Max (%)", "minimum": 0, "type": "integer", "description": "Maximum views/followers ratio (%) — profiles above this are skipped. Filters out one-hit viral accounts that don't sustain audience attention. 0 = disabled. B2B-targeting suggestion: 30%. Paid plan only.", "default": 0 }, "contactInfoType": { "title": "Filter by Contact Info Presence", "enum": [ "any", "emailOrPhone", "emailOnly", "phoneOnly", "emailAndPhone" ], "type": "string", "description": "Contact-presence filter — only include profiles that publicly expose the chosen contact channel(s). Independent of the extract* settings: a profile that has an email is kept even if extractEmail=false. Useful for outreach lists where every row needs a contact channel.", "default": "any" }, "hasWebsite": { "title": "Filter by Website Presence", "type": "boolean", "description": "When true, only include profiles that have a website link in the bio (External URL is non-empty). Useful for filtering for monetized creators or brands with their own funnel.", "default": false }, "accountType": { "title": "Filter by Account Type", "enum": [ "any", "business", "personal" ], "type": "string", "description": "Account-type filter — restrict to business profiles (have a Category and may have a Contact button), personal profiles, or both. Most ecommerce / B2B targeting wants «business»; influencer discovery often wants «personal».", "default": "any" }, "filterForInfluencers": { "title": "Filter for Influencers Only (by Category)", "type": "boolean", "description": "When true, only include profiles whose Category matches a curated list of influencer-style categories (Blogger, Artist, Public Figure, Digital Creator, Photographer, Athlete, Musician, etc.). Filters out brands, organizations, and most local businesses. Requires extractBusinessCategory=true.", "default": false }, "categoryFilter": { "title": "Filter by Specific Business Category", "enum": [ "any", "Academic Camp", "Accessories", "Accountant", "Actor", "Acupuncturist", "Addiction Resources Center", "Addiction Service", "Addiction Treatment Center", "Adult Entertainment Service", "Advertising Agency", "Advertising/Marketing", "Aerospace Company", "African Restaurant", "Agricultural Cooperative", "Agricultural Service", "Agriculture", "Airline Company", "Airline Industry Service", "Airport", "Airport Shuttle Service", "Album", "Allergist", "Alternative & Holistic Health Service", "Amateur Photographer", "Amateur Sports Team", "American Restaurant", "Amphitheater", "Amusement & Theme Park", "Animal Shelter", "Antique Store", "Apartment & Condo Building", "Apostolic Church", "App Page", "Apparel & Clothing", "Apparel Distributor", "Appliance Manufacturer", "Appliance Repair Service", "Appliances", "Aquarium", "Aquatic Pet Store", "Arabian Restaurant", "Arboretum", "Arcade", "Architect", "Architectural Designer", "Architectural Engineer", "Architectural Tour Agency", "Argentinian Restaurant", "Aromatherapy Service", "Art", "Art Gallery", "Art Museum", "Art Restoration Service", "Art School", "Art Tour Agency", "Artist", "Arts & Crafts Store", "Arts & Entertainment", "Arts & Humanities Website", "Asian Fusion Restaurant", "Asian Restaurant", "Assemblies Of God", "Astrologist", "Astrologist & Psychic", "Athlete", "Atv Recreation Park", "Auction House", "Audio Visual Equipment Store", "Audiologist", "Auditorium", "Australian Restaurant", "Author", "Auto Detailing Service", "Automated Teller Machine (Atm)", "Automation Service", "Automotive Body Shop", "Automotive Consultant", "Automotive Customization Shop", "Automotive Dealership", "Automotive Glass Service", "Automotive Leasing Service", "Automotive Manufacturer", "Automotive Parts Store", "Automotive Repair Shop", "Automotive Restoration Service", "Automotive Service", "Automotive Store", "Automotive Window Tinting Service", "Automotive, Aircraft & Boat", "Aviation School", "Awning Supplier", "Baby & Children's Clothing Store", "Baby Goods/Kids Goods", "Babysitter", "Bags & Luggage Company", "Bags & Luggage Store", "Bags/Luggage", "Bail Bondsmen", "Bakery", "Band", "Bank", "Bankruptcy Lawyer", "Bar", "Bar & Grill", "Barbecue Restaurant", "Barber Shop", "Bartending Service", "Beach", "Beach Resort", "Beauty Salon", "Beauty Store", "Beauty Supplier", "Beauty Supply Store", "Beauty, Cosmetic & Personal Care", "Bed And Breakfast", "Beer Bar", "Beer Garden", "Belgian Restaurant", "Bicycle Repair Service", "Bicycle Shop", "Big Box Retailer", "Bike Rental", "Biotechnology Company", "Blinds & Curtains Store", "Blogger", "Board Game", "Boat / Sailing Instructor", "Boat Dealership", "Boat Rental", "Boat Service", "Boat Tour Agency", "Boat/Ferry Company", "Book", "Book & Magazine Distributor", "Book Series", "Bookstore", "Borough", "Botanical Garden", "Bottled Water Company", "Bottled Water Supplier", "Boutique Store", "Bowling Alley", "Boxing Studio", "Brand", "Brand Agency", "Brazilian Restaurant", "Breakfast & Brunch Restaurant", "Brewery", "Bridal Shop", "Bridge", "British Restaurant", "Broadcasting & Media Production Company", "Brokerage Firm", "Bubble Tea Shop", "Buffet Restaurant", "Building Material Store", "Building Materials", "Burger Restaurant", "Bus Line", "Bus Tour Agency", "Business", "Business & Economy Website", "Business Center", "Business Consultant", "Business Service", "Business Supply Service", "Businesses", "Butcher Shop", "Cabin", "Cabinet & Countertop Store", "Cable & Satellite Company", "Cafe", "Cafeteria", "Camera Store", "Camera/Photo", "Campground", "Campus Building", "Canadian Restaurant", "Candy Store", "Canoe & Kayak Rental", "Cantonese Restaurant", "Car Dealership", "Car Rental", "Car Wash", "Cardiologist", "Career Counselor", "Cargo & Freight Company", "Caribbean Restaurant", "Carnival Supply Store", "Carpenter", "Carpet & Flooring Store", "Cars", "Cash Advance Service", "Casino", "Casino & Gaming", "Castle", "Caterer", "Cause", "Cave", "Cemetery", "Champagne Bar", "Charity Organization", "Charter Bus Service", "Cheese Shop", "Chef", "Chemical Company", "Chicken Joint", "Child Care Service", "Child Protective Service", "Chimney Sweeper", "Chinese Restaurant", "Chiropractor", "Chocolate Shop", "Choir", "Christian Church", "Church", "Church Of Christ", "Church Of God", "Church Of Jesus Christ Of Latter-Day Saints", "Circus", "City", "City Infrastructure", "Cleaning Service", "Clothing (Brand)", "Clothing Company", "Clothing Store", "Coach", "Cocktail Bar", "Coffee Shop", "Collectibles Store", "College & University", "Colombian Restaurant", "Comedian", "Comedy Club", "Comfort Food Restaurant", "Comic Bookstore", "Commercial & Industrial", "Commercial & Industrial Equipment Supplier", "Commercial Bank", "Commercial Equipment", "Commercial Real Estate Agency", "Community", "Community Center", "Community College", "Community Museum", "Community Organization", "Community Service", "Company", "Competition", "Computer Company", "Computer Repair Service", "Computer Store", "Computer Training School", "Computers & Internet Website", "Computers (Brand)", "Concert Tour", "Concrete Contractor", "Construction Company", "Consulate & Embassy", "Consulting Agency", "Contemporary Art Museum", "Continental Restaurant", "Contractor", "Convenience Store", "Convent & Monastery", "Convention Center", "Cooking School", "Copywriting Service", "Corporate Lawyer", "Corporate Office", "Cosmetic Dentist", "Cosmetics Store", "Cosmetology School", "Costume Shop", "Cottage", "Counselor", "Country", "Country Club / Clubhouse", "Credit Counseling Service", "Cricket Ground", "Criminal Lawyer", "Cruise Agency", "Cruise Line", "Cultural Center", "Cultural Gifts Store", "Cupcake Shop", "Currency Exchange", "Dairy Farm", "Damage Restoration Service", "Dance & Night Club", "Dance School", "Dance Studio", "Dancer", "Dating Service", "Day Care", "Day Spa", "Deck & Patio Builder", "Defense Company", "Deli", "Demolition & Excavation Company", "Dentist & Dental Office", "Department Store", "Dermatologist", "Design & Fashion", "Designer", "Dessert Shop", "Digital Creator", "Dim Sum Restaurant", "Diner", "Disc Golf Course", "Discount Store", "Distillery", "Dive Bar", "Diving Spot", "Divorce & Family Lawyer", "Dj", "Doctor", "Dog Day Care Center", "Dog Park", "Dog Trainer", "Dog Walker", "Dominican Restaurant", "Donut Shop", "Drafting Service", "Drink", "Drive-In Movie Theater", "Driving School", "Drug Addiction Treatment Center", "Dry Cleaner", "Dui Lawyer", "E-Cigarette Store", "Eco Tour Agency", "E-Commerce Website", "Editor", "Education", "Education Company", "Education Website", "Educational Consultant", "Educational Research Center", "Educational Supply Store", "Electrician", "Electronics", "Electronics Company", "Electronics Store", "Elementary School", "Elevator Service", "Emergency Rescue Service", "Endocrinologist", "Employment Agency", "Energy Company", "Engineering Service", "Entertainment Website", "Entrepreneur", "Environmental Conservation Organization", "Environmental Consultant", "Environmental Service", "Episode", "Equestrian Center", "Escape Game Room", "Esports League", "Estate Planning Lawyer", "Ethiopian Restaurant", "European Restaurant", "Evangelical Church", "Event", "Event Photographer", "Event Planner", "Event Videographer", "Exotic Car Rental", "Fabric Store", "Family Doctor", "Family Medicine Practice", "Family Style Restaurant", "Farm", "Farmers Market", "Fashion", "Fashion Company", "Fashion Designer", "Fashion Model", "Fast Food Restaurant", "Fence & Gate Contractor", "Fertility Doctor", "Festival", "Fictional Character", "Field Of Study", "Filipino Restaurant", "Film Director", "Finance", "Finance Company", "Financial Aid Service", "Financial Consultant", "Financial Planner", "Financial Service", "Fire Protection Service", "Fireplace Store", "Fish & Chips Restaurant", "Fish Farm", "Fish Market", "Fishing Spot", "Fishing Store", "Fitness Boot Camp", "Fitness Model", "Fitness Trainer", "Fjord/Loch", "Flea Market", "Flight School", "Florist", "Flyboarding Center", "Fondue Restaurant", "Food & Beverage", "Food & Beverage Company", "Food Consultant", "Food Delivery Service", "Food Stand", "Food Tour Agency", "Food Truck", "Food Wholesaler", "Foodservice Distributor", "Footwear Store", "Forestry & Logging", "Forestry Service", "Franchising Service", "French Restaurant", "Frozen Yogurt Shop", "Fruit & Vegetable Store", "Funeral Service & Cemetery", "Furniture", "Furniture Repair & Upholstery Service", "Furniture Store", "Gastroenterologist", "Gamer", "Games/Toys", "Gaming Video Creator", "Garage Door Service", "Garden Center", "Gardener", "Gas & Chemical Service", "Gas Station", "Gastropub", "Gay Bar", "Gelato Shop", "General Dentist", "German Restaurant", "Gift Shop", "Glass & Mirror Shop", "Glass Manufacturer", "Glass Service", "Gluten-Free Restaurant", "Go-Kart Track", "Golf Cart Dealership", "Golf Course & Country Club", "Government Building", "Government Official", "Government Organization", "Government Website", "Granite & Marble Supplier", "Graphic Designer", "Greek Restaurant", "Grocery Store", "Gun Store", "Gutter Cleaning Service", "Gym/Physical Fitness Center", "Hair Extensions Service", "Hair Removal Service", "Hair Replacement Service", "Hair Salon", "Halal Restaurant", "Hardware Store", "Hat Store", "Haunted House", "Hawaiian Restaurant", "Health & Wellness Website", "Health Food Restaurant", "Health Food Store", "Health Spa", "Health/Beauty", "Healthcare Administrator", "Heating, Ventilating & Air Conditioning Service", "High School", "Hiking Trail", "Hindu Temple", "Historical Tour Agency", "History Museum", "Home", "Home & Garden Store", "Home & Garden Website", "Home Decor", "Home Goods Store", "Home Health Care Service", "Home Improvement", "Home Improvement Service", "Home Inspector", "Home Mover", "Home Security Company", "Home Staging Service", "Home Theater Store", "Home Window Service", "Homebrew Supply Store", "Hong Kong Restaurant", "Hookah Lounge", "Horse Trainer", "Horseback Riding Center", "Hospital", "Hospitality Service", "Hostel", "Hot Air Balloon Tour Agency", "Hot Dog Joint", "Hotel", "Hotel & Lodging", "Hotel Bar", "Hotel Resort", "Hotel Services Company", "House Painting", "House Sitter", "Household Supplies", "Housing Assistance Service", "Hungarian Restaurant", "Ice Cream Shop", "Ice Skating Rink", "Image Consultant", "Immigration Lawyer", "Independent Bookstore", "Indian Chinese Restaurant", "Indian Restaurant", "Indo Chinese Restaurant", "Indonesian Restaurant", "Industrial Company", "Information Technology Company", "In-Home Service", "Inn", "Insurance Agent", "Insurance Broker", "Insurance Company", "Intellectual Property Lawyer", "Interest", "Interior Design Studio", "Internet Cafe", "Internet Company", "Internet Marketing Service", "Internet Service Provider", "Investing Service", "Investment Bank", "Investment Management Company", "Irish Restaurant", "Island", "Italian Restaurant", "Janitorial Service", "Japanese Restaurant", "Jazz & Blues Club", "Jet Ski Rental", "Jewelry & Watches Company", "Jewelry & Watches Store", "Jewelry Wholesaler", "Jewelry/Watches", "Journalist", "Just For Fun", "Karaoke", "Kennel", "Kids Entertainment Service", "Kitchen & Bath Contractor", "Kitchen/Cooking", "Kiteboarding Center", "Korean Restaurant", "Kosher Restaurant", "Labor Union", "Landmark & Historical Place", "Landscape Architect", "Landscape Company", "Landscape Designer", "Language School", "Laser Hair Removal Service", "Laser Tag Center", "Lasik/Laser Eye Surgeon", "Latin American Restaurant", "Laundromat", "Law Enforcement Agency", "Lawyer & Law Firm", "Lebanese Restaurant", "Legal", "Legal Service", "Library", "Lifestyle Service", "Lighthouse", "Lighting Store", "Ligurian Restaurant", "Limo Service", "Lingerie & Underwear Store", "Literary Arts", "Literary Editor", "Live Music Venue", "Livery Stable", "Livestock Farm", "Loan Service", "Lobbyist", "Local & Travel Website", "Local Business", "Local Service", "Locality", "Locksmith", "Lodge", "Lottery Retailer", "Lounge", "Luggage Service", "Lumber Yard", "Magazine", "Magician", "Makeup Artist", "Malaysian Restaurant", "Management Service", "Marina", "Marine", "Marine Supply Store", "Market", "Market Research Consultant", "Marketing Agency", "Marketing Consultant", "Marriage Therapist", "Martial Arts School", "Masonry Contractor", "Massage Service", "Massage Therapist", "Maternity & Nursing Clothing Store", "Mattress Manufacturer", "Mattress Store", "Mattress Wholesaler", "Meat Wholesaler", "Media", "Media Agency", "Media/News Company", "Medical & Health", "Medical Cannabis Dispensary", "Medical Center", "Medical Company", "Medical Equipment Manufacturer", "Medical Equipment Supplier", "Medical Lab", "Medical Procedure", "Medical School", "Medical Service", "Medical Spa", "Medical Supply Store", "Meditation Center", "Mediterranean Restaurant", "Meeting Room", "Men's Clothing Store", "Mental Health Service", "Merchandising Service", "Metal Fabricator", "Metal Supplier", "Methodist Church", "Mexican Restaurant", "Middle Eastern Restaurant", "Middle School", "Miniature Golf Course", "Mining Company", "Mission", "Mobile Home Park", "Mobile Phone Shop", "Modeling Agency", "Modern Art Museum", "Modern European Restaurant", "Monarch", "Monument", "Moroccan Restaurant", "Mortgage Brokers", "Mosque", "Motel", "Motivational Speaker", "Motor Vehicle Company", "Motorcycle Dealership", "Motorcycle Manufacturer", "Motorcycle Repair Shop", "Motorsports Store", "Mountain", "Mountain Biking Shop", "Movie", "Movie & Music Store", "Movie Character", "Movie Theater", "Movie/Television Studio", "Moving & Storage Service", "Museum", "Music", "Music Award", "Music Chart", "Music Lessons & Instruction School", "Music Production Studio", "Music Video", "Musical Genre", "Musical Instrument", "Musical Instrument Store", "Musician", "Musician/Band", "Nail Salon", "Nanny", "National Forest", "National Park", "Nature Preserve", "Naturopath", "Neapolitan Restaurant", "Neighborhood", "Neurologist", "New American Restaurant", "News & Media Website", "News Personality", "Newspaper", "Newsstand", "Night Market", "Nondenominational Church", "Non-Governmental Organization (Ngo)", "Nonprofit Organization", "Not A Business", "Notary Public", "Nurseries & Gardening Store", "Nursing Agency", "Nursing School", "Nutritionist", "Observatory", "Obstetrician-Gynecologist (Obgyn)", "Occupational Safety And Health Service", "Occupational Therapist", "Ocean", "Office Equipment Store", "Office Supplies", "Oncologist", "Opera House", "Ophthalmologist", "Optician", "Optometrist", "Oral Surgeon", "Orchestra", "Organic Grocery Store", "Organization", "Orthodontist", "Osteopathic Doctor", "Other", "Outdoor & Sporting Goods Company", "Outdoor Equipment Store", "Outdoor Recreation", "Outlet Store", "Paddleboarding Center", "Paintball Center", "Pakistani Restaurant", "Palace", "Park", "Party Entertainment Service", "Party Supply & Rental Shop", "Passport & Visa Service", "Patio/Garden", "Paving & Asphalt Service", "Pawn Shop", "Pediatrician", "Pentecostal Church", "Performance & Event Venue", "Performance Art", "Performance Art Theatre", "Performing Arts", "Performing Arts School", "Periodontist", "Personal Assistant", "Personal Blog", "Personal Chef", "Personal Coach", "Personal Injury Lawyer", "Personal Trainer", "Personal Website", "Peruvian Restaurant", "Pest Control Service", "Pet", "Pet Adoption Service", "Pet Breeder", "Pet Cafe", "Pet Groomer", "Pet Service", "Pet Sitter", "Pet Store", "Pet Supplies", "Petroleum Service", "Petting Zoo", "Pharmaceutical Company", "Pharmaceuticals", "Pharmacy / Drugstore", "Pho Restaurant", "Phone/Tablet", "Photographer", "Photography Museum", "Photography Videography", "Physical Therapist", "Pilates Studio", "Pizza Place", "Planetarium", "Plastic Company", "Plastic Manufacturer", "Plastic Surgeon", "Playground", "Plumbing Service", "Podcast", "Podiatrist", "Police Station", "Polish Restaurant", "Political Candidate", "Political Organization", "Political Party", "Politician", "Pop-Up Shop", "Port", "Portable Building Service", "Portuguese Restaurant", "Post Office", "Pregnancy Care Center", "Preschool", "Printing Service", "Private Investigator", "Private Members Club", "Private Plane Charter", "Private School", "Proctologist", "Producer", "Product/Service", "Professional Gamer", "Professional Service", "Professional Sports Team", "Promenade", "Property Lawyer", "Property Management Company", "Psychologist", "Psychotherapist", "Pub", "Public & Government Service", "Public Figure", "Public Relations Agency", "Public School", "Public Service", "Public Swimming Pool", "Public Utility Company", "Publisher", "Quay", "Race Track", "Radio Station", "Rafting/Kayaking Center", "Ramen Restaurant", "Real Estate", "Real Estate Agent", "Real Estate Appraiser", "Real Estate Company", "Real Estate Developer", "Real Estate Investment Firm", "Real Estate Lawyer", "Real Estate Service", "Real Estate Title & Development", "Record Label", "Recreation & Sports Website", "Recreation Center", "Recreation Spot", "Recruiter", "Recycling & Waste Management", "Recycling Center", "Reference Website", "Reflexologist", "Refrigeration Service", "Region", "Regional Website", "Religious Bookstore", "Religious Center", "Religious Organization", "Rental Shop", "Reproductive Service", "Residence", "Restaurant", "Restaurant Supply Store", "Restaurant Wholesaler", "Retail Bank", "Retail Company", "Retirement & Assisted Living Facility", "Rideshare Service", "Robotics Company", "Rock Climbing Gym", "Rodeo", "Roller Skating Rink", "Roofing Service", "Rose Garden", "Rugby Pitch", "Rv Park", "Rv Repair Shop", "Safety & First Aid Service", "Sake Bar", "Salsa Club", "Sandwich Shop", "School", "School Sports League", "School Sports Team", "School Transportation Service", "Science", "Science Museum", "Science Website", "Science, Technology & Engineering", "Scientist", "Scooter Rental", "Screen Printing & Embroidery", "Scuba Diving Center", "Scuba Instructor", "Sculpture Garden", "Seafood Restaurant", "Seasonal Store", "Secretarial Service", "Security Guard Service", "Self-Storage Facility", "Service Apartments", "Sewer Service", "Sewing & Alterations", "Sex Therapist", "Shaved Ice Shop", "Shipping Supply & Service", "Shop", "Shopping & Retail", "Shopping District", "Shopping Mall", "Shopping Service", "Show", "Sightseeing Tour Agency", "Signs & Banner Service", "Sikh Temple", "Skate Shop", "Skateboard Park", "Ski & Snowboard Shop", "Ski Resort", "Skin Care Service", "Skydiving Center", "Smoothie & Juice Bar", "Snorkeling Spot", "Soba Restaurant", "Soccer Field", "Social Club", "Social Media Agency", "Social Service", "Society & Culture Website", "Software", "Software Company", "Solar Energy Company", "Solar Energy Service", "Song", "Sorority & Fraternity", "Soul Food Restaurant", "Soup Restaurant", "South African Restaurant", "Southern Restaurant", "Souvenir Shop", "Spa", "Spanish Restaurant", "Specialty Grocery Store", "Specialty School", "Speech Pathologist", "Sport", "Sporting Goods Store", "Sports", "Sports & Fitness Instruction", "Sports & Recreation", "Sports & Recreation Venue", "Sports Bar", "Sports Club", "Sports Event", "Sports League", "Sports Promoter", "Sports Team", "Sportswear Store", "Stadium, Arena & Sports Venue", "State", "Stately Home", "Statue & Fountain", "Steakhouse", "Storage Facility", "Structural Engineer", "Subway Station", "Sunglasses & Eyewear Store", "Supermarket", "Surf Shop", "Surfing Spot", "Surveyor", "Sushi Restaurant", "Swimming Instructor", "Swimming Pool & Hot Tub Service", "Swimming Pool Cleaner", "Swimwear Store", "Symphony", "Talent Agent", "Tanning Salon", "Tapas Bar & Restaurant", "Tattoo & Piercing Shop", "Tax Preparation Service", "Taxi Service", "Taxidermist", "Tea Room", "Teacher", "Teens & Kids Website", "Teeth Whitening Service", "Telecommunication Company", "Telemarketing Service", "Tennis Court", "Test Preparation Center", "Tex-Mex Restaurant", "Textile Company", "Thai Restaurant", "Theater", "Theatrical Play", "Theatrical Productions", "Theme Restaurant", "Therapist", "Thrift & Consignment Store", "Ticket Sales", "Tiling Service", "Tire Dealer & Repair Shop", "Tobacco Company", "Tobacco Store", "Tools/Equipment", "Tour Agency", "Tour Guide", "Tourist Information Center", "Towing Service", "Toy Store", "Trade School", "Traffic School", "Train Station", "Transit Stop", "Transit System", "Translator", "Transportation Service", "Travel & Transportation", "Travel Agency", "Travel Company", "Travel Service", "Tree Cutting Service", "Trophies & Engraving Shop", "Tuscan Restaurant", "Tutor/Teacher", "Tv Channel", "Tv Network", "Tv Season", "Tv Show", "Tv/Movie Award", "Udon Restaurant", "Ukranian Restaurant", "Unagi Restaurant", "Uniform Supplier", "Urban Farm", "Urologist", "Vacation Home Rental", "Vegetarian/Vegan Restaurant", "Veterinarian", "Video", "Video Creator", "Video Game", "Video Game Store", "Vietnamese Restaurant", "Vintage Store", "Visual Arts", "Vitamin Supplement Shop", "Vitamins/Supplements", "Waste Management Company", "Water Heater Installation & Repair Service", "Water Park", "Water Treatment Service", "Water Utility Company", "Waxing Service", "Web Designer", "Website", "Wedding Planning Service", "Wedding Venue", "Weight Loss Center", "Well Water Drilling Service", "Whisky Bar", "Wholesale & Supply Store", "Wholesale Bakery", "Wholesale Grocer", "Wig Store", "Wildlife Sanctuary", "Window Installation Service", "Wine Bar", "Wine, Beer & Spirits Store", "Wine/Spirits", "Winery/Vineyard", "Women's Clothing Store", "Women's Health Clinic", "Work Position", "Workplace & Office", "Writer", "Writing Service", "Xinjiang", "Yakiniku Restaurant", "Yakitori Restaurant", "Yoga Studio", "Yoshoku Restaurant", "Youth Organization", "Zhejiang Restaurant", "Zoo" ], "type": "string", "description": "Exact-match filter on Instagram's business category — only include profiles whose Category equals this. Examples: «Beauty Salon», «Photographer», «Restaurant», «Public Figure», «Coach», «Blogger», «Designer». Independent of filterForInfluencers. Full enum lists 700+ Instagram-supported categories; MCP clients see only the first ~10 due to truncation, so programmatic callers can pass any exact Instagram-supported category string.", "default": "any" }, "filterCombination": { "title": "Combine Category + Keyword Filters", "enum": [ "AND", "OR" ], "type": "string", "description": "How to combine the categoryFilter and keywords filters when both are set. AND (default) = profile must match both. OR = profile passes if it matches either; in that case the output Matched By column reports which filter let each profile through (category, keyword, or both).", "default": "AND" }, "mustBeVerified": { "title": "Filter by Verification", "type": "boolean", "description": "When true, only include profiles with the verified blue checkmark. Excludes the vast majority of accounts. Useful for partnership outreach to known public figures.", "default": false }, "clearSavedData": { "title": "Start a Fresh Run", "type": "boolean", "description": "When true (default), starts a fresh run and clears the previous run's profile cache + checkpoint. Set to false to resume an interrupted run from the checkpoint — already-analyzed profiles are not re-billed.", "default": true }, "enableOfflineMode": { "title": "Enable Offline Mode", "type": "boolean", "description": "When true, runs entirely against the cached profile data from previous runs — no Instagram API calls, no paid events. Re-applies the current filter values to the already-scraped profiles for cheap re-filtering. Requires a non-empty profile cache from an earlier run.", "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 } } } } } } } } } } ```