{ "openapi": "3.0.1", "info": { "title": "Instagram Profile Scraper – Advanced Data Extraction✨", "description": "Extract 200+ data fields per profile including followers, engagement, posts, reels, hashtags & influencer metricsπŸ”Input usernames, URLs, or discover profiles via keyword search⚑40+ filters for niche, location & fake follower riskπŸ’°Influencer scoring with CPM & post value✨Instagram Profile ScraperπŸ“Š", "version": "1.0", "x-build-id": "omSwGk0qiHBFs2sTK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapearchitect~ultimate-instagram-profile-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapearchitect-ultimate-instagram-profile-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/scrapearchitect~ultimate-instagram-profile-scraper/runs": { "post": { "operationId": "runs-sync-scrapearchitect-ultimate-instagram-profile-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/scrapearchitect~ultimate-instagram-profile-scraper/run-sync": { "post": { "operationId": "run-sync-scrapearchitect-ultimate-instagram-profile-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "runMode", "searchMode" ], "properties": { "runMode": { "title": "πŸš€ Run Mode", "enum": [ "scrape_profile_basic", "scrape_profile_standard", "scrape_profile_deep" ], "type": "string", "description": "Select the profile scrape depth", "default": "scrape_profile_deep" }, "searchMode": { "title": "πŸ” Search Mode", "enum": [ "usernames", "keyword", "both" ], "type": "string", "description": "Choose how to find profiles: by username/URL, keyword search, or both", "default": "usernames" }, "usernames": { "title": "πŸ‘€ Instagram Usernames", "type": "array", "description": "Enter Instagram usernames to scrape (e.g., 'instagram', 'nike', 'selenagomez')", "items": { "type": "string" } }, "startUrls": { "title": "πŸ”— Instagram Profile URLs", "type": "array", "description": "Enter full Instagram profile URLs to scrape", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searchKeyword": { "title": "πŸ”‘ Search Keyword", "type": "string", "description": "Keyword to search for Instagram profiles (e.g., 'fitness', 'travel blogger', 'chef')" }, "searchCountry": { "title": "🌍 Country Filter", "type": "string", "description": "Filter search results by country (e.g., 'USA', 'India', 'UK', 'Brazil')" }, "maxSearchResults": { "title": "πŸ“Š Max Search Results", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Maximum profiles to find via keyword search (0 = unlimited)", "default": 50 }, "minFollowers": { "title": "πŸ“ˆ Minimum Followers", "minimum": 0, "type": "integer", "description": "Only include profiles with at least this many followers" }, "maxFollowers": { "title": "πŸ“‰ Maximum Followers", "minimum": 0, "type": "integer", "description": "Only include profiles with at most this many followers" }, "followerTier": { "title": "🎯 Follower Tier", "enum": [ "any", "nano", "micro", "mid", "macro", "mega", "celebrity" ], "type": "string", "description": "Filter by influencer tier: nano (1K-10K), micro (10K-100K), mid (100K-500K), macro (500K-1M), mega (1M-10M), celebrity (10M+)", "default": "any" }, "minEngagementRate": { "title": "πŸ’― Min Engagement Rate (%)", "minimum": 0, "maximum": 100, "type": "number", "description": "Minimum engagement rate percentage (likes+comments/followers * 100)" }, "maxEngagementRate": { "title": "πŸ’― Max Engagement Rate (%)", "minimum": 0, "maximum": 100, "type": "number", "description": "Maximum engagement rate percentage" }, "minAvgLikes": { "title": "❀️ Min Average Likes per Post", "minimum": 0, "type": "integer", "description": "Minimum average likes per post" }, "minAvgComments": { "title": "πŸ’¬ Min Average Comments per Post", "minimum": 0, "type": "integer", "description": "Minimum average comments per post" }, "engagementTrend": { "title": "πŸ“ˆ Engagement Trend", "enum": [ "any", "increasing", "stable", "decreasing" ], "type": "string", "description": "Filter by engagement trend direction", "default": "any" }, "accountType": { "title": "πŸ“± Account Type", "enum": [ "any", "personal", "business", "creator" ], "type": "string", "description": "Filter by account type", "default": "any" }, "isVerified": { "title": "βœ… Verified Only", "type": "boolean", "description": "Only include verified accounts (blue checkmark)", "default": false }, "isPrivate": { "title": "πŸ”’ Include Private Accounts", "type": "boolean", "description": "Include private accounts in results (limited data available)", "default": true }, "isBusiness": { "title": "πŸ’Ό Business Accounts Only", "type": "boolean", "description": "Only include business accounts", "default": false }, "hasExternalUrl": { "title": "πŸ”— Has External URL", "type": "boolean", "description": "Only include profiles with external URL in bio", "default": false }, "hasContactInfo": { "title": "πŸ“§ Has Contact Info", "type": "boolean", "description": "Only include profiles with business email or phone number", "default": false }, "minPostsCount": { "title": "πŸ“ Minimum Posts Count", "minimum": 0, "type": "integer", "description": "Minimum number of posts" }, "maxPostsCount": { "title": "πŸ“ Maximum Posts Count", "minimum": 0, "type": "integer", "description": "Maximum number of posts" }, "hasReels": { "title": "🎬 Has Reels", "type": "boolean", "description": "Only include profiles that have Reels content", "default": false }, "hasStories": { "title": "πŸ“– Has Active Stories", "type": "boolean", "description": "Only include profiles with active stories", "default": false }, "hasHighlights": { "title": "✨ Has Highlights", "type": "boolean", "description": "Only include profiles with story highlights", "default": false }, "hasIGTV": { "title": "πŸ“Ί Has IGTV", "type": "boolean", "description": "Only include profiles with IGTV content", "default": false }, "hasShop": { "title": "πŸ›οΈ Has Instagram Shop", "type": "boolean", "description": "Only include profiles with Instagram shopping enabled", "default": false }, "minDaysSinceLastPost": { "title": "πŸ“… Min Days Since Last Post", "minimum": 0, "type": "integer", "description": "Minimum days since the profile's last post (find inactive accounts)" }, "maxDaysSinceLastPost": { "title": "πŸ“… Max Days Since Last Post", "minimum": 0, "type": "integer", "description": "Maximum days since the profile's last post (find active accounts)" }, "minPostFrequency": { "title": "πŸ“† Min Posts Per Week", "minimum": 0, "type": "number", "description": "Minimum average posts per week" }, "primaryLanguage": { "title": "🌐 Primary Language", "enum": [ "any", "English", "Spanish", "Portuguese", "French", "German", "Italian", "Japanese", "Korean", "Chinese", "Arabic", "Hindi", "Russian" ], "type": "string", "description": "Filter by detected primary content language", "default": "any" }, "categories": { "title": "πŸ“‚ Instagram Categories", "type": "array", "description": "Filter by Instagram business category (e.g., 'Athlete', 'Blogger', 'Musician')", "items": { "type": "string" } }, "contentNiches": { "title": "🎯 Content Niches", "uniqueItems": true, "type": "array", "description": "Filter by detected content niche: sports, fitness, travel, fashion, food, family, business, motivation, etc.", "items": { "type": "string", "enum": [ "sports", "fitness", "travel", "fashion", "food", "family", "business", "motivation", "music", "art", "beauty", "tech", "gaming", "education", "health", "lifestyle" ] } }, "bioKeywords": { "title": "πŸ“ Bio Keywords", "type": "array", "description": "Only include profiles with these keywords in their bio", "items": { "type": "string" } }, "bioHashtags": { "title": "#️⃣ Bio Hashtags", "type": "array", "description": "Only include profiles with these hashtags in their bio", "items": { "type": "string" } }, "locationCountry": { "title": "🌍 Country", "type": "string", "description": "Filter by detected country location" }, "locationCity": { "title": "πŸ™οΈ City", "type": "string", "description": "Filter by detected city location" }, "hasLocation": { "title": "πŸ“ Has Location Info", "type": "boolean", "description": "Only include profiles with location information", "default": false }, "collaborationPotential": { "title": "🀝 Collaboration Potential", "enum": [ "any", "premium", "high", "medium", "low" ], "type": "string", "description": "Filter by estimated collaboration potential", "default": "any" }, "minInfluencerScore": { "title": "⭐ Min Influencer Score", "minimum": 0, "maximum": 100, "type": "integer", "description": "Minimum influencer score (0-100 based on engagement, followers, authenticity)" }, "maxFakeFollowerRisk": { "title": "πŸ€– Max Fake Follower Risk", "enum": [ "any", "low", "medium" ], "type": "string", "description": "Maximum acceptable fake follower risk level", "default": "any" }, "minEstimatedPostValue": { "title": "πŸ’΅ Min Estimated Post Value ($)", "minimum": 0, "type": "number", "description": "Minimum estimated monetary value per sponsored post" }, "maxEstimatedPostValue": { "title": "πŸ’΅ Max Estimated Post Value ($)", "minimum": 0, "type": "number", "description": "Maximum estimated monetary value per sponsored post" }, "minEstimatedCPM": { "title": "πŸ“Š Min Estimated CPM ($)", "minimum": 0, "type": "number", "description": "Minimum estimated cost per 1000 impressions" }, "accountGrowthPhase": { "title": "πŸ“ˆ Account Growth Phase", "enum": [ "any", "growing", "stable", "declining" ], "type": "string", "description": "Filter by account growth phase", "default": "any" }, "engagementPodLikelihood": { "title": "🀝 Max Engagement Pod Likelihood", "enum": [ "any", "low", "medium" ], "type": "string", "description": "Maximum acceptable engagement pod likelihood", "default": "any" }, "minDataQualityScore": { "title": "πŸ“Š Min Data Quality Score", "minimum": 0, "maximum": 100, "type": "integer", "description": "Minimum data quality/completeness score (0-100)" }, "includeRecentPosts": { "title": "πŸ“· Include Recent Posts", "type": "boolean", "description": "Include up to 12 recent posts with full metadata, engagement, and content analysis", "default": true }, "includeReels": { "title": "🎬 Include Recent Reels", "type": "boolean", "description": "Include up to 6 recent Reels with engagement data", "default": true }, "includeHighlights": { "title": "✨ Include Highlights", "type": "boolean", "description": "Include story highlights metadata", "default": true }, "includeEngagementAnalysis": { "title": "πŸ“ˆ Include Engagement Analysis", "type": "boolean", "description": "Include detailed engagement metrics, trends, and performance analysis", "default": true }, "includeContentAnalysis": { "title": "πŸ”¬ Include Content Analysis", "type": "boolean", "description": "Include content analysis: themes, sentiment, hashtag analysis, posting patterns", "default": true }, "includeAudienceInsights": { "title": "πŸ‘₯ Include Audience Insights", "type": "boolean", "description": "Include estimated audience demographics and geographic distribution", "default": true }, "includeInfluencerMetrics": { "title": "πŸ’° Include Influencer Metrics", "type": "boolean", "description": "Include estimated CPM, post value, influencer score, and brand collaboration potential", "default": true }, "includeSimilarAccounts": { "title": "πŸ‘₯ Include Similar Accounts", "type": "boolean", "description": "Include list of related/similar Instagram accounts", "default": false }, "includeRiskIndicators": { "title": "⚠️ Include Risk Indicators", "type": "boolean", "description": "Include fake follower risk, engagement pod likelihood, and shadow ban indicators", "default": true }, "includeWordAnalysis": { "title": "πŸ“ Include Word/Language Analysis", "type": "boolean", "description": "Include most used words, word frequency, and language detection", "default": true }, "includePostingPatterns": { "title": "πŸ“… Include Posting Patterns", "type": "boolean", "description": "Include posting schedule analysis, optimal posting times, and content calendar", "default": true }, "includeMediaQualityStats": { "title": "πŸ–ΌοΈ Include Media Quality Stats", "type": "boolean", "description": "Include media dimensions, aspect ratios, video duration stats", "default": true }, "includeHashtagAnalysis": { "title": "#️⃣ Include Hashtag Analysis", "type": "boolean", "description": "Include detailed hashtag analysis, categories, and reach potential", "default": true }, "includeBioAnalysis": { "title": "πŸ“‹ Include Bio Analysis", "type": "boolean", "description": "Include bio links analysis, extracted emails, mentions, and hashtags from bio", "default": true }, "includeGrowthIndicators": { "title": "πŸ“ˆ Include Growth Indicators", "type": "boolean", "description": "Include estimated follower growth rates and virality scores", "default": true }, "outputFormat": { "title": "πŸ“„ Output Format", "enum": [ "full", "compact", "minimal" ], "type": "string", "description": "Choose output data format", "default": "full" }, "proxyCountry": { "title": "🌍 Proxy Country", "enum": [ "US", "GB", "DE", "FR", "JP", "KR", "BR", "IN", "AU", "CA", "ES", "IT", "MX", "NL", "SG" ], "type": "string", "description": "Select proxy country (some content may be geo-restricted)", "default": "US" } } }, "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 } } } } } } } } } }