{ "openapi": "3.0.1", "info": { "title": "Instagram Profile & Posts Scraper", "description": "Scrape Instagram profiles and their recent posts. Get follower counts, engagement metrics, and detailed post data. Profile scraping (followers, following, bio, etc.). Recent posts with engagement metrics. Supports reels and regular posts. No login required (public profiles only).", "version": "1.1", "x-build-id": "K1pfuLdS7vqR96bur" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/alizarin_refrigerator-owner~instagram-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-alizarin_refrigerator-owner-instagram-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/alizarin_refrigerator-owner~instagram-scraper/runs": { "post": { "operationId": "runs-sync-alizarin_refrigerator-owner-instagram-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/alizarin_refrigerator-owner~instagram-scraper/run-sync": { "post": { "operationId": "run-sync-alizarin_refrigerator-owner-instagram-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": { "usernames": { "title": "Instagram Usernames", "type": "array", "description": "List of Instagram usernames to scrape (without @). Example: nike, adidas, puma", "items": { "type": "string" } }, "maxPosts": { "title": "Max Posts Per Profile", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum number of posts to scrape per profile (includes reels if enabled)", "default": 12 }, "includeReels": { "title": "Include Reels", "type": "boolean", "description": "Include reels in the scraped posts", "default": true }, "includeComments": { "title": "Include Comments", "type": "boolean", "description": "Scrape comments on each post (increases run time)", "default": false }, "maxCommentsPerPost": { "title": "Max Comments Per Post", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of comments to scrape per post", "default": 20 }, "includeReactions": { "title": "Include Reactions", "type": "boolean", "description": "Include detailed engagement metrics (likes, shares, saves)", "default": false }, "demoMode": { "title": "Demo Mode", "type": "boolean", "description": "Run with sample data for testing (no scraping, no charges). Set to FALSE for real scraping.", "default": true }, "sessionCookies": { "title": "Session Cookies (JSON)", "type": "string", "description": "JSON array of cookies from Cookie-Editor browser extension. Required for reliable scraping — Instagram gates most content behind login. Install Cookie-Editor, log into Instagram, export cookies as JSON, paste here. Not needed if using Cookie Manager." }, "cookieStorageKey": { "title": "Cookie Manager Storage Key", "type": "string", "description": "Key to load cookies from the Cookie Manager KV store (e.g. 'instagram-myaccount'). Use this instead of pasting cookies manually. Requires a prior run of the Cookie Manager actor to capture and store your session." }, "cookieKvStoreName": { "title": "Cookie Manager KV Store Name", "type": "string", "description": "Name of the Key-Value store where Cookie Manager saved the session. Defaults to 'cookie-sessions'.", "default": "cookie-sessions" }, "useFirecrawl": { "title": "Use Firecrawl", "type": "boolean", "description": "Use Firecrawl API for enhanced scraping reliability (requires API key)", "default": false }, "firecrawlApiKey": { "title": "Firecrawl API Key", "type": "string", "description": "Your Firecrawl API key from firecrawl.dev" }, "proxy": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings for avoiding blocks" }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "URL to POST results when scraping completes (Zapier, Make, n8n)" }, "enableSentimentAnalysis": { "title": "Enable AI Sentiment Analysis", "type": "boolean", "description": "Use AI to analyze sentiment of comments and captions", "default": false }, "aiProvider": { "title": "AI Provider", "enum": [ "none", "openai", "anthropic", "google", "mistral", "cohere" ], "type": "string", "description": "Which AI provider to use for sentiment analysis", "default": "none" }, "aiApiKey": { "title": "AI API Key", "type": "string", "description": "API key for your chosen AI provider" }, "aiModel": { "title": "AI Model (Optional)", "type": "string", "description": "Custom model name (leave empty for default). Examples: gpt-4o, claude-3-5-sonnet-20241022, gemini-1.5-pro" } } }, "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 } } } } } } } } } }