# Instagram Profile MCP Server (`afanasenko/instagram-profile-scraper-mcp-server`) Actor MCP server exposing Instagram profile data as 5 agent tools — followers/following, specific list, network expansion, keyword & location discovery. Connect Claude Desktop, Cursor, ChatGPT to /mcp. Pay-per-profile pricing — $0.01 per analyzed profile. Same data + pricing as the parent scraper. - **URL**: https://apify.com/afanasenko/instagram-profile-scraper-mcp-server.md - **Developed by:** [Andrey Afanasenko](https://apify.com/afanasenko) (community) - **Categories:** MCP servers, Agents, Social media - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per event + usage This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Instagram Profile MCP Server [![Apify](https://apify.com/actor-badge?actor=afanasenko/instagram-profile-scraper-mcp-server)](https://apify.com/afanasenko/instagram-profile-scraper-mcp-server) Connect Claude Desktop, Cursor, or ChatGPT to live Instagram profile data via 5 narrow tools — followers/following extraction, specific-list enrichment, network expansion, keyword/hashtag discovery, and location discovery. **$0.01 per profile**, $0.10 per followers/following list. Same data and pricing as the parent [Instagram Profile Scraper](https://apify.com/afanasenko/instagram-profile-scraper) — but exposed as Model Context Protocol tools so your AI agent picks the right one by intent. Beyond what Instagram's official Graph API offers (which only returns your own business accounts): full bio, contacts, engagement rate, business category, language, Reels analytics, and 38 enrichment columns per row. ### What it does Given an Instagram handle (or list of handles, seed accounts, keywords, or location), returns enriched profile records — bio, contacts, engagement metrics, post captions, language detection, and Reels analytics — same 38-column shape as the parent scraper. Each tool is one Apify run; results land in the run's default dataset. ### Output sample (one row, 38 columns) ```json { "Account": "https://instagram.com/cristiano", "Source": "Direct Input", "Full Name": "Cristiano Ronaldo", "Followers Count": 615000000, "Following Count": 568, "Biography": "SIUUUbscribe to my YT channel", "Email": "press@example.com", "Email Source": "contact_button", "Phone": "+1 555 123 4567", "External URL": "https://www.cristianoronaldo.com", "Category": "Athlete", "Profile Picture": "https://instagram.fagx1-1.fna.fbcdn.net/...", "Address": "N/A", "Reels Count": 142, "Last Reel (Days Ago)": 7, "Median Views": 4200000, "Avg Likes": 1420000, "Avg Comments": 8400, "Views/Followers Ratio": "0.68%", "Posts per Month": 8.4, "Total Posts": 3654, "Detected Language": "English", "Last Post Within (Days)": 3, "Median ER": "1.42%", "Quality": "Good" } ```` ### ⚡ Quick start 1. **Connect from your AI client** (Standby `/mcp`) — see "Connect from Claude Desktop / Cursor / ChatGPT" below. The actor stays warm and answers in sub-second after the first call. 2. **Or click Run in the Apify Console** — pick `Mode 2: Analyze a Specific List of Accounts`, leave the demo input (`openai, claudeai`), and click Start. Output capped at 10 profiles for ~$0.10 trial cost. 3. **Or POST programmatically** to `apify.com/acts/.../runs` with `{"operationMode": "analyzeSpecificAccounts", "specificUsernamesList": ["claudeai"]}`. ### 🧭 How to use it (in one screen) - **Choose Operation Mode**: Followers/Following · Specific List · Network Expansion · Keyword Discovery · Location Discovery. - **Inside Selected Mode**: enter a handle (e.g. `claudeai`), seed list, keyword, or location → set the per-mode cap. - **Tuning**: ⚙️ Data Extraction (post fetch / contact deep search / language detection) + 🔬 Advanced Filtering (followers / engagement / contact info / recent activity). → [💡 Tips & Best Practices](#-tips--best-practices) for cost, performance, and data-quality patterns. ### 🤖 Connect from Claude Desktop / Cursor / ChatGPT The MCP server lives at `https://.apify.actor/mcp`. Auth via Apify token (query param or Bearer header). #### Claude Desktop Add to your `claude_desktop_config.json`: ```json { "mcpServers": { "instagram": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-fetch", "https://instagram-profile-scraper-mcp-server.apify.actor/mcp?token=" ] } } } ``` Restart Claude Desktop. Five tools appear: `instagram_analyze_followers_following`, `instagram_analyze_specific_accounts`, `instagram_network_expansion`, `instagram_keyword_discovery`, `instagram_location_discovery`. #### Cursor / ChatGPT / other MCP clients Point them at `https://.apify.actor/mcp` with `Authorization: Bearer `. Streamable HTTP transport requires the header `Accept: application/json, text/event-stream` on every POST. #### Curl smoke ```bash TOKEN= curl -sS -X POST "https://.apify.actor/mcp?token=$TOKEN" \ -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' ``` ### ▶ Run as a regular Apify actor The actor also accepts a normal INPUT\_SCHEMA via `apify call` / Console / API. Pick a mode + provide its required field(s): ```json { "operationMode": "analyzeSpecificAccounts", "specificUsernamesList": ["claudeai"], "extractEmail": true, "analyzeQuality": true } ``` All 5 modes are supported in regular-run as well as MCP. See `.actor/input_schema.json` for every field. ### 💰 Pay-per-event pricing Same as the parent scraper. Charged on event emission — pay only for what you get. | Event | Price (USD) | When charged | |---|---|---| | `PROFILE_ANALYZED` | $0.01 | per profile successfully retrieved + analyzed | | `USER_LIST_FETCHED` | $0.10 | per follower OR following list dump (Mode 1 only) | **Demo input cap**: when you leave the example seed (`natgeo` / `openai, claudeai` / `openai`) at default with no `maxCount`, the run is capped at 10 profiles — a $0.10 max trial on any plan. ### Free vs paid | | Free plan | Paid plan | |---|---|---| | Profiles / run | 50 | unlimited (50 per MCP call) | | Mode 1 targets | 3 | unlimited | | Modes 3/4/5 discovery | 5 | unlimited (50 per MCP call) | | Email | masked (`j***@a***.com`) | full address | | Reels analytics, view/follower ratio | not applied | applied | | `searchDepth=2` (Mode 3) | not available | available | ### 🔒 Storage records Every run writes the same 5 records as the parent scraper: | Key | Format | Purpose | |---|---|---| | `RUN_SUMMARY` | JSON | profiles found / enriched / skipped, email-resolution stats, plan, durationSeconds, MCP tool-call count | | `SKIPPED_ACCOUNTS` | JSON | per-username list of skips with reason + category (`filter` / `not_found` / `private` / `error`) | | `FREE_LIMITS_APPLIED` | JSON | which FREE-plan ceilings hit (profile cap, target cap, expansion cap) — empty on paid | | `USER_MESSAGE` | JSON | onboarding banner / test-run notice — optional | | `status.html` | HTML | live progress dashboard (Apify Console Output tab) | Standby instances aggregate counters across all tool calls in the same instance and flush every 10 calls + on `Actor.exit`. ### 🛠️ Programmatic API Trigger the actor as a regular run: ```bash curl -X POST "https://api.apify.com/v2/acts/instagram-profile-scraper-mcp-server/runs?token=$TOKEN" \ -H "Content-Type: application/json" \ -d '{"operationMode":"analyzeSpecificAccounts","specificUsernamesList":["claudeai"]}' ``` Read the dataset: ```bash curl "https://api.apify.com/v2/datasets//items?token=$TOKEN&format=json" ``` ### 💡 Tips & Best Practices #### Getting Maximum Results - Start with one handle per mode to validate filter shape — Mode 2 with a single username gives the cheapest first signal. - Layer filters in this order: follower range → contact info → category/keyword. Earlier filters cut profiles before expensive enrichment. - For Mode 4 keyword discovery, combine `searchQueries` (broader Instagram account search) with `searchHashtags` (top-post authors, biased toward larger accounts) to widen the funnel. - For Mode 5 location discovery, use `City, Country` format (e.g. `London, UK`) — the country hint disambiguates same-named cities. #### Cost Optimization - Use Apify's Run options panel (Maximum cost per run) to cap a run at any USD amount. Independent of the per-event pricing. - Set `maxCount` realistically per mode — most discovery sources return hundreds of candidates. Free plan ceiling (50 / 3 / 5 by mode) acts as a backstop. - Tri-state filters (`accountType`, `mustBeVerified`, `categoryFilter`) drop matches before paid analysis. - Skip `extractPosts` / `searchContactsInPosts` when you only need follower counts and bio — those toggles add a per-profile media fetch. #### Performance - The actor uses concurrency 16 against the upstream API by default; this matches the rate limit observed in production. - Mode 5 (Location Discovery) is the slowest mode because it resolves each seed via a place-name search before fetching tagged media. Pre-resolving to a numeric place ID (paste the integer instead of `City, Country`) skips the search step. - Standby instances stay warm across MCP tool calls — the second tool call in a session is faster than the first. #### Data Quality - The 38-column dataset has many nullable fields — check `Email` / `Reels Count` / `Median ER` aren't all "N/A" on a sample row before scaling. - "Mutual Follow" column appears only when Mode 1 has both `analyzeFollowers` AND `analyzeFollowing` enabled. - "Tagged Location" column appears only in Mode 5. - "Matched By" column appears when `categoryFilter` or `keywords` is active — values: `category`, `keyword`, `both`. - Free-plan emails are masked (`j***@a***.com`) — the underlying value is correct on the paid plan. ### ❓ FAQ **Why a separate actor instead of the parent's modes?** The MCP wrapper presents 5 narrow tools — agents can pick by intent. The parent actor uses one INPUT\_SCHEMA with a `mode` enum, which is fine for humans but unwieldy for AI clients reading a tool catalog. **Same dataset shape as parent?** Yes — 38 columns, same titles, same example values. **Same pricing as parent?** Yes — $0.01 per profile + $0.10 per list dump, mirroring the parent 1:1. **Does Standby cost extra?** Standby billing is per actor compute time, not per MCP tool call. Idle Standby instances stop after a few minutes of no traffic. **Will agents auto-discover this on `mcp.apify.com`?** Yes once the actor is public + categorized as `MCP_SERVERS`. Indexing happens within ~1 hour of publish. ### 🔗 Related actors | Actor | Description | |---|---| | [instagram-profile-scraper](https://apify.com/afanasenko/instagram-profile-scraper) | Parent scraper — same data + pricing, full INPUT\_SCHEMA flow | | [instagram-followers-scraper](https://apify.com/afanasenko/instagram-followers-scraper) | Lighter spinoff — followers/following only, single mode | | [instagram-related-profiles-scraper](https://apify.com/afanasenko/instagram-related-profiles-scraper) | Lighter spinoff — Network Expansion only, single mode | ### ⚠️ Disclaimer This actor scrapes only public Instagram profile data. Respect Instagram's Terms of Service and applicable data-protection regulations (GDPR, CCPA) when handling collected data. The MCP wrapper does not change what data is collected — same surface as the parent scraper. # Actor input Schema ## `operationMode` (type: `string`): Select the main function of the Actor. The fields you need to fill in bellow will depend on this choice. ## `targetUsernames` (type: `array`): Enter Instagram usernames or profile URLs (one per line). Works with 1 or multiple accounts. Free plan: up to 3 target accounts. ## `analyzeFollowers` (type: `boolean`): When true, extracts the followers list of each target account in Mode 1. At least one of analyzeFollowers / analyzeFollowing must be true; combine both to derive the Mutual Follow column. ## `analyzeFollowing` (type: `boolean`): When true, extracts the following list (accounts each target follows) in Mode 1. Combine with analyzeFollowers to derive the Mutual Follow column. ## `maxCount` (type: `integer`): Maximum number of profiles to analyze across all targets in Mode 1 — hard cost ceiling because each analyzed profile is one paid event ($0.01). Free plan ceiling: 50 profiles regardless of this value. 0 = unlimited. Default 0. ## `specificUsernamesList` (type: `array`): Enter usernames or profile URLs to analyze directly (one per line). ## `maxCountList` (type: `integer`): Maximum number of profiles from the list to analyze in Mode 2 — hard cost ceiling because each analyzed profile is one paid event ($0.01). Free plan ceiling: 50 profiles regardless of this value. 0 = unlimited. Default 0. ## `startUsernames` (type: `array`): Enter 1-5 usernames to start the network expansion from (one per line). ## `searchDepth` (type: `string`): How many layers deep to search for related profiles. Depth 2 can find thousands of profiles (not working on a free plan). ## `maxCountExpansion` (type: `integer`): Maximum number of unique profiles to discover and analyze in Mode 3 (Network Expansion) — hard cost ceiling because each analyzed profile is one paid event ($0.01). Free plan ceiling: 5 profiles. 0 = unlimited. Default 0. ## `searchQueries` (type: `array`): **Required for Mode 4** (provide either Search Queries or Search Hashtags). Enter one or more search terms (one per line). The actor will search Instagram accounts matching each term, then apply all your filters (language, followers, category, etc.) to the discovered candidates. Great for building a seed list from scratch in any language. Example: veterinario, clinica dental, cardiólogo. ## `searchHashtags` (type: `array`): **Required for Mode 4** (provide either Search Queries or Search Hashtags). Enter one or more Instagram hashtags (without the # symbol, one per line). For each hashtag the actor collects authors of top posts — these tend to be larger, already-popular accounts, so follower-based filters (e.g. >50k) keep a much higher share than plain keyword search. Combine with Search Queries to widen the top of the funnel. Example: veterinario, clinicaveterinaria, perros. ## `maxSearchPagesPerQuery` (type: `integer`): How many pages to fetch per search query and per hashtag. More pages = more candidates but slower discovery. Range 1–50. Default 5. ## `maxCountDiscovery` (type: `integer`): Maximum number of unique candidates from keyword/hashtag search to analyze in Mode 4 — hard cost ceiling because each analyzed profile is one paid event ($0.01). Free plan ceiling: 5 profiles. 0 = unlimited. Default 0. ## `locationSeeds` (type: `array`): Recommended format: 'City, Country' (e.g. 'London, UK', 'Bristol, UK'). The country hint disambiguates same-named cities — without it, 'Bristol' resolves to Bristol, Connecticut. You can also paste raw numeric Instagram place IDs for full control. Authors of recent + top-tagged media at each place become candidates. ## `maxCountLocation` (type: `integer`): Maximum number of unique candidates from location-tagged media to analyze in Mode 5 — hard cost ceiling because each analyzed profile is one paid event ($0.01). Free plan ceiling: 5 profiles. 0 = unlimited. Default 0. ## `extractEmail` (type: `boolean`): When true, extracts public email addresses from each profile (Instagram Contact button + bio parse). Set false to skip email extraction. Default true. Populates the Email + Email Source columns. ## `extractPhoneNumber` (type: `boolean`): When true, extracts public phone numbers from each profile (Instagram Contact button + bio parse). Set false to skip. Default false (most lead-gen workflows rely on email/website). Populates the Phone column when enabled. ## `extractWebsiteUrl` (type: `boolean`): When true, extracts the bio-link URL from each profile. Set false to skip. Default true. Populates the External URL column. ## `extractBusinessCategory` (type: `boolean`): When true, extracts the Instagram business category for business profiles (e.g. «Athlete», «Beauty, Cosmetic & Personal Care»). Set false to skip. Default true. Populates the Category column. ## `extractPhysicalAddress` (type: `boolean`): When true, extracts the public street address shown on a business profile when disclosed. Default false. Populates the Address column. ## `analyzeQuality` (type: `boolean`): When true, computes Median Engagement Rate and a coarse Quality score (Excellent/Good/Average/Poor) from recent posts. Requires an extra API call per profile. Default true. Free plan: ER + Quality available; Reels analytics (views, view/follower ratio) require a paid plan. Populates Median ER, Quality, Avg Likes, Avg Comments, Posts per Month columns. ## `minEngagementRate` (type: `integer`): Minimum median engagement rate (%) — profiles below this are skipped. 0 = no filter (default). Engagement rate is computed from likes+comments on recent posts vs follower count; requires analyzeQuality=true. ## `extractPosts` (type: `boolean`): When true, extracts caption text from the 8 most recent feed posts. Default false. Populates Post 1..Post 8 columns and is a prerequisite for searchContactsInPosts. ## `searchContactsInPosts` (type: `boolean`): When true, scans the extracted post captions for emails and phone numbers (e.g. booking@brand.com referenced in a Reel description). Requires extractPosts to also be true. Default false. Populates Email from Posts + Phone from Posts columns. ## `keywords` (type: `array`): Only process profiles containing **any** of these keywords. Not case-sensitive. ## `keywordLocation` (type: `string`): Where to search for keywords — `bio_or_name` (default), `bio` only, `name` only, `posts` (recent post captions, requires post data), or `anywhere`. Choose `posts` for high-intent niche matching beyond profile metadata. ## `locationKeywords` (type: `string`): Only process profiles whose public address or city contains any of these keywords. Separate with a comma (e.g., London, New York, UK). ## `profileLanguage` (type: `string`): Language filter — restrict results to profiles whose bio + post text was detected as this language. «any» (default) bypasses detection. Detection runs on bio + recent post captions via Google CLD3. ## `minFollowers` (type: `integer`): Minimum follower count — profiles below this are skipped. 0 = no minimum (default). 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 (default). Useful for excluding mega-accounts when targeting niche creators. ## `lastPostDays` (type: `integer`): Activity recency filter — only include profiles that posted any feed content within the last X days. 0 = disabled (default). Drops dormant accounts. Requires post data. ## `lastReelDays` (type: `integer`): Reel-activity recency filter — only include profiles that posted a Reel within the last X days. 0 = disabled (default). Useful for Reels-driven campaigns. Paid plan only. ## `minPostsInPeriod` (type: `integer`): Only process accounts with at least this many posts within the specified period. Set to 0 to disable. **Requires post data.** ## `postsCheckPeriodDays` (type: `string`): The time period (in days) to check for the minimum number of posts. ## `minMedianViews` (type: `integer`): Only process accounts where the median view count of their recent posts is greater than this number. Set to 0 to disable. Paid plan only. ## `viewFollowerRatioMin` (type: `integer`): Reject profiles whose median Reel views are below this % of their follower count. 0 = no minimum. For B2B targeting, 5 is a sensible floor. Paid plan only. ## `viewFollowerRatioMax` (type: `integer`): Reject profiles whose median Reel views are above this % of their follower count (filters out viral one-hit accounts). 0 = no maximum. For B2B targeting, 30 is a sensible ceiling. Paid plan only. ## `contactInfoType` (type: `string`): Contact-info filter — keep only profiles that have at least the requested contact data. «any» (default, no filter), «emailOrPhone», «emailOnly», «phoneOnly», «emailAndPhone». Runs independently of the extract-\* flags above. Combine with lead-gen workflows where you must have email or phone. ## `hasWebsite` (type: `boolean`): When true, only profiles with a website link in their bio pass the filter. Default false. Useful for B2B / lead-gen lists where the link is a qualified-traffic signal. ## `accountType` (type: `string`): Account-type filter — restrict to «business» profiles, «personal» profiles, or «any» (default, no filter). Most ecommerce / B2B targeting wants «business»; influencer discovery often wants «personal». ## `filterForInfluencers` (type: `boolean`): When true, only profiles whose category matches an influencer-leaning list (e.g. Blogger, Artist, Public Figure, Digital Creator) pass the filter — helps automatically exclude most brands and organizations. Default false. Requires profile data. ## `categoryFilter` (type: `string`): Business-category filter — restrict to profiles whose Instagram-set category matches this exact value (e.g. «Public Figure», «Beauty, Cosmetic & Personal Care», «Fitness Trainer»). «any» (default) = no filter. Independent of filterForInfluencers. MCP clients see only the first ~10 enum entries due to truncation; programmatic callers can pass any of the 1090+ exact values. ## `filterCombination` (type: `string`): How to combine the Business Category filter and the Keywords filter when BOTH are set. **AND** (default): a profile must match both filters (existing behavior). **OR**: a profile passes if it matches **either** the category **or** any of the keywords. The output dataset adds a **Matched By** column showing which filter(s) let each profile through (`category`, `keyword`, or `both`). ## `mustBeVerified` (type: `boolean`): When true, only verified (blue checkmark) accounts pass the filter. Default false. Useful for vetted-creator outreach lists; off by default since most creator audiences are unverified. ## Actor input object example ```json { "operationMode": "analyzeFollowersFollowing", "targetUsernames": [ "natgeo" ], "analyzeFollowers": true, "analyzeFollowing": false, "maxCount": 0, "specificUsernamesList": [ "openai", "claudeai" ], "maxCountList": 0, "startUsernames": [ "openai" ], "searchDepth": "1", "maxCountExpansion": 0, "searchQueries": [], "searchHashtags": [], "maxSearchPagesPerQuery": 5, "maxCountDiscovery": 0, "locationSeeds": [], "maxCountLocation": 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 } ``` # Actor output Schema ## `profiles` (type: `string`): All enriched Instagram profile records collected during this run, across MCP tool calls and the regular-run dispatcher. Same 38-column shape as the parent Instagram Profile Scraper. # 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 = { "operationMode": "analyzeFollowersFollowing" }; // Run the Actor and wait for it to finish const run = await client.actor("afanasenko/instagram-profile-scraper-mcp-server").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 = { "operationMode": "analyzeFollowersFollowing" } # Run the Actor and wait for it to finish run = client.actor("afanasenko/instagram-profile-scraper-mcp-server").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 '{ "operationMode": "analyzeFollowersFollowing" }' | apify call afanasenko/instagram-profile-scraper-mcp-server --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=afanasenko/instagram-profile-scraper-mcp-server", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Instagram Profile MCP Server", "description": "MCP server exposing Instagram profile data as 5 agent tools — followers/following, specific list, network expansion, keyword & location discovery. Connect Claude Desktop, Cursor, ChatGPT to /mcp. Pay-per-profile pricing — $0.01 per analyzed profile. Same data + pricing as the parent scraper.", "version": "0.0", "x-build-id": "Szq2lQcDx2onicDbw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/afanasenko~instagram-profile-scraper-mcp-server/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-afanasenko-instagram-profile-scraper-mcp-server", "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-profile-scraper-mcp-server/runs": { "post": { "operationId": "runs-sync-afanasenko-instagram-profile-scraper-mcp-server", "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-profile-scraper-mcp-server/run-sync": { "post": { "operationId": "run-sync-afanasenko-instagram-profile-scraper-mcp-server", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "operationMode" ], "properties": { "operationMode": { "title": "1. Choose Operation Mode", "enum": [ "analyzeFollowersFollowing", "analyzeSpecificAccounts", "networkExpansion", "keywordDiscovery", "locationDiscovery" ], "type": "string", "description": "Select the main function of the Actor. The fields you need to fill in bellow will depend on this choice." }, "targetUsernames": { "title": "Target Accounts", "type": "array", "description": "Enter Instagram usernames or profile URLs (one per line). Works with 1 or multiple accounts. Free plan: up to 3 target accounts.", "default": [ "natgeo" ], "items": { "type": "string" } }, "analyzeFollowers": { "title": "Scrape Followers", "type": "boolean", "description": "When true, extracts the followers list of each target account in Mode 1. At least one of analyzeFollowers / analyzeFollowing must be true; combine both to derive the Mutual Follow column.", "default": true }, "analyzeFollowing": { "title": "Scrape Following", "type": "boolean", "description": "When true, extracts the following list (accounts each target follows) in Mode 1. Combine with analyzeFollowers to derive the Mutual Follow column.", "default": false }, "maxCount": { "title": "Max profiles to process (cost control)", "minimum": 0, "type": "integer", "description": "Maximum number of profiles to analyze across all targets in Mode 1 — hard cost ceiling because each analyzed profile is one paid event ($0.01). Free plan ceiling: 50 profiles regardless of this value. 0 = unlimited. Default 0.", "default": 0 }, "specificUsernamesList": { "title": "List of Profiles to Analyze", "type": "array", "description": "Enter usernames or profile URLs to analyze directly (one per line).", "default": [ "openai", "claudeai" ], "items": { "type": "string" } }, "maxCountList": { "title": "Max profiles to process (cost control)", "minimum": 0, "type": "integer", "description": "Maximum number of profiles from the list to analyze in Mode 2 — hard cost ceiling because each analyzed profile is one paid event ($0.01). Free plan ceiling: 50 profiles regardless of this value. 0 = unlimited. Default 0.", "default": 0 }, "startUsernames": { "title": "Start Profiles", "type": "array", "description": "Enter 1-5 usernames to start the network expansion from (one per line).", "default": [ "openai" ], "items": { "type": "string" } }, "searchDepth": { "title": "Search Depth", "enum": [ "1", "2" ], "type": "string", "description": "How many layers deep to search for related profiles. Depth 2 can find thousands of profiles (not working on a free plan).", "default": "1" }, "maxCountExpansion": { "title": "Max profiles to process (cost control)", "minimum": 0, "type": "integer", "description": "Maximum number of unique profiles to discover and analyze in Mode 3 (Network Expansion) — hard cost ceiling because each analyzed profile is one paid event ($0.01). Free plan ceiling: 5 profiles. 0 = unlimited. Default 0.", "default": 0 }, "searchQueries": { "title": "Search Queries", "type": "array", "description": "**Required for Mode 4** (provide either Search Queries or Search Hashtags). Enter one or more search terms (one per line). The actor will search Instagram accounts matching each term, then apply all your filters (language, followers, category, etc.) to the discovered candidates. Great for building a seed list from scratch in any language. Example: veterinario, clinica dental, cardiólogo.", "default": [], "items": { "type": "string" } }, "searchHashtags": { "title": "Search Hashtags", "type": "array", "description": "**Required for Mode 4** (provide either Search Queries or Search Hashtags). Enter one or more Instagram hashtags (without the # symbol, one per line). For each hashtag the actor collects authors of top posts — these tend to be larger, already-popular accounts, so follower-based filters (e.g. >50k) keep a much higher share than plain keyword search. Combine with Search Queries to widen the top of the funnel. Example: veterinario, clinicaveterinaria, perros.", "default": [], "items": { "type": "string" } }, "maxSearchPagesPerQuery": { "title": "Max pages per query / hashtag", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many pages to fetch per search query and per hashtag. More pages = more candidates but slower discovery. Range 1–50. Default 5.", "default": 5 }, "maxCountDiscovery": { "title": "Max profiles to process (cost control)", "minimum": 0, "type": "integer", "description": "Maximum number of unique candidates from keyword/hashtag search to analyze in Mode 4 — hard cost ceiling because each analyzed profile is one paid event ($0.01). Free plan ceiling: 5 profiles. 0 = unlimited. Default 0.", "default": 0 }, "locationSeeds": { "title": "Location Seeds (City, Country • or numeric place ID)", "type": "array", "description": "Recommended format: 'City, Country' (e.g. 'London, UK', 'Bristol, UK'). The country hint disambiguates same-named cities — without it, 'Bristol' resolves to Bristol, Connecticut. You can also paste raw numeric Instagram place IDs for full control. Authors of recent + top-tagged media at each place become candidates.", "default": [], "items": { "type": "string" } }, "maxCountLocation": { "title": "Max profiles to process (cost control)", "minimum": 0, "type": "integer", "description": "Maximum number of unique candidates from location-tagged media to analyze in Mode 5 — hard cost ceiling because each analyzed profile is one paid event ($0.01). Free plan ceiling: 5 profiles. 0 = unlimited. Default 0.", "default": 0 }, "extractEmail": { "title": "Extract Email", "type": "boolean", "description": "When true, extracts public email addresses from each profile (Instagram Contact button + bio parse). Set false to skip email extraction. Default true. Populates the Email + Email Source columns.", "default": true }, "extractPhoneNumber": { "title": "Extract Phone Number", "type": "boolean", "description": "When true, extracts public phone numbers from each profile (Instagram Contact button + bio parse). Set false to skip. Default false (most lead-gen workflows rely on email/website). Populates the Phone column when enabled.", "default": false }, "extractWebsiteUrl": { "title": "Extract Website URL", "type": "boolean", "description": "When true, extracts the bio-link URL from each profile. Set false to skip. Default true. Populates the External URL column.", "default": true }, "extractBusinessCategory": { "title": "Extract Business Category", "type": "boolean", "description": "When true, extracts the Instagram business category for business profiles (e.g. «Athlete», «Beauty, Cosmetic & Personal Care»). Set false to skip. Default true. Populates the Category column.", "default": true }, "extractPhysicalAddress": { "title": "Extract Physical Address", "type": "boolean", "description": "When true, extracts the public street address shown on a business profile when disclosed. Default false. Populates the Address column.", "default": false }, "analyzeQuality": { "title": "Calculate Engagement Rate (ER)", "type": "boolean", "description": "When true, computes Median Engagement Rate and a coarse Quality score (Excellent/Good/Average/Poor) from recent posts. Requires an extra API call per profile. Default true. Free plan: ER + Quality available; Reels analytics (views, view/follower ratio) require a paid plan. Populates Median ER, Quality, Avg Likes, Avg Comments, Posts per Month columns.", "default": true }, "minEngagementRate": { "title": "Min Engagement Rate (%)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Minimum median engagement rate (%) — profiles below this are skipped. 0 = no filter (default). Engagement rate is computed from likes+comments on recent posts vs follower count; requires analyzeQuality=true.", "default": 0 }, "extractPosts": { "title": "Extract Latest Post Captions", "type": "boolean", "description": "When true, extracts caption text from the 8 most recent feed posts. Default false. Populates Post 1..Post 8 columns and is a prerequisite for searchContactsInPosts.", "default": false }, "searchContactsInPosts": { "title": "Deep Search for Contacts in Posts", "type": "boolean", "description": "When true, scans the extracted post captions for emails and phone numbers (e.g. booking@brand.com referenced in a Reel description). Requires extractPosts to also be true. Default false. Populates Email from Posts + Phone from Posts columns.", "default": false }, "keywords": { "title": "Filter by Keywords", "type": "array", "description": "Only process profiles containing **any** of these keywords. Not case-sensitive.", "default": [], "items": { "type": "string" } }, "keywordLocation": { "title": "Search Keywords In", "enum": [ "bio_or_name", "bio", "name", "posts", "anywhere" ], "type": "string", "description": "Where to search for keywords — `bio_or_name` (default), `bio` only, `name` only, `posts` (recent post captions, requires post data), or `anywhere`. Choose `posts` for high-intent niche matching beyond profile metadata.", "default": "bio_or_name" }, "locationKeywords": { "title": "Filter by Location Keywords", "type": "string", "description": "Only process profiles whose public address or city contains any of these keywords. Separate with a comma (e.g., London, New York, UK).", "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 — restrict results to profiles whose bio + post text was detected as this language. «any» (default) bypasses detection. Detection runs on bio + recent post captions via Google CLD3.", "default": "any" }, "minFollowers": { "title": "Follower Count Range: Min", "type": "integer", "description": "Minimum follower count — profiles below this are skipped. 0 = no minimum (default). 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 (default). Useful for excluding mega-accounts when targeting niche creators.", "default": 0 }, "lastPostDays": { "title": "Filter by Last Post Date", "type": "integer", "description": "Activity recency filter — only include profiles that posted any feed content within the last X days. 0 = disabled (default). Drops dormant accounts. Requires post data.", "default": 0 }, "lastReelDays": { "title": "Posted Reel Within (Days)", "minimum": 0, "type": "integer", "description": "Reel-activity recency filter — only include profiles that posted a Reel within the last X days. 0 = disabled (default). Useful for Reels-driven campaigns. Paid plan only.", "default": 0 }, "minPostsInPeriod": { "title": "Filter by Posting Frequency: Min Posts", "type": "integer", "description": "Only process accounts with at least this many posts within the specified period. Set to 0 to disable. **Requires post data.**", "default": 0 }, "postsCheckPeriodDays": { "title": "in the last (days)", "enum": [ "7", "14", "30" ], "type": "string", "description": "The time period (in days) to check for the minimum number of posts.", "default": "30" }, "minMedianViews": { "title": "Filter by Median Views", "type": "integer", "description": "Only process accounts where the median view count of their recent posts is greater than this number. Set to 0 to disable. Paid plan only.", "default": 0 }, "viewFollowerRatioMin": { "title": "Filter by Views/Followers Ratio: Min (%)", "minimum": 0, "type": "integer", "description": "Reject profiles whose median Reel views are below this % of their follower count. 0 = no minimum. For B2B targeting, 5 is a sensible floor. Paid plan only.", "default": 0 }, "viewFollowerRatioMax": { "title": "Filter by Views/Followers Ratio: Max (%)", "minimum": 0, "type": "integer", "description": "Reject profiles whose median Reel views are above this % of their follower count (filters out viral one-hit accounts). 0 = no maximum. For B2B targeting, 30 is a sensible ceiling. Paid plan only.", "default": 0 }, "contactInfoType": { "title": "Filter by Contact Info Presence", "enum": [ "any", "emailOrPhone", "emailOnly", "phoneOnly", "emailAndPhone" ], "type": "string", "description": "Contact-info filter — keep only profiles that have at least the requested contact data. «any» (default, no filter), «emailOrPhone», «emailOnly», «phoneOnly», «emailAndPhone». Runs independently of the extract-* flags above. Combine with lead-gen workflows where you must have email or phone.", "default": "any" }, "hasWebsite": { "title": "Filter by Website Presence", "type": "boolean", "description": "When true, only profiles with a website link in their bio pass the filter. Default false. Useful for B2B / lead-gen lists where the link is a qualified-traffic signal.", "default": false }, "accountType": { "title": "Filter by Account Type", "enum": [ "any", "business", "personal" ], "type": "string", "description": "Account-type filter — restrict to «business» profiles, «personal» profiles, or «any» (default, no filter). 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 profiles whose category matches an influencer-leaning list (e.g. Blogger, Artist, Public Figure, Digital Creator) pass the filter — helps automatically exclude most brands and organizations. Default false. Requires profile data.", "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": "Business-category filter — restrict to profiles whose Instagram-set category matches this exact value (e.g. «Public Figure», «Beauty, Cosmetic & Personal Care», «Fitness Trainer»). «any» (default) = no filter. Independent of filterForInfluencers. MCP clients see only the first ~10 enum entries due to truncation; programmatic callers can pass any of the 1090+ exact values.", "default": "any" }, "filterCombination": { "title": "Combine Category + Keyword Filters", "enum": [ "AND", "OR" ], "type": "string", "description": "How to combine the Business Category filter and the Keywords filter when BOTH are set.\n**AND** (default): a profile must match both filters (existing behavior).\n**OR**: a profile passes if it matches **either** the category **or** any of the keywords. The output dataset adds a **Matched By** column showing which filter(s) let each profile through (`category`, `keyword`, or `both`).", "default": "AND" }, "mustBeVerified": { "title": "Filter by Verification", "type": "boolean", "description": "When true, only verified (blue checkmark) accounts pass the filter. Default false. Useful for vetted-creator outreach lists; off by default since most creator audiences are unverified.", "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 } } } } } } } } } } ```