{ "openapi": "3.0.1", "info": { "title": "Instagram Profile & Posts Scraper", "description": "Scrape public Instagram profiles and their recent posts with no login: followers, following, post count, bio, links, verified flag, and up to 12 recent posts with captions, media and dates. Likes and comments need your own session cookies. Pay per profile and per post.", "version": "1.2", "x-build-id": "cXMbgNCtKcb7FdFWO" }, "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": "Instagram usernames to read (with or without @, or profile URLs). Example: nike, adidas, puma. No login needed for public profiles.", "items": { "type": "string" } }, "maxPosts": { "title": "Max Posts Per Profile", "minimum": 0, "maximum": 50, "type": "integer", "description": "Maximum number of recent posts per profile (includes reels if enabled). Set 0 to get the profile only, with no posts and no Post Scraped charges. Without session cookies Instagram shows logged-out visitors up to 12 posts, so at most 12 are returned.", "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": "Return one labeled sample profile (free, no profile or post events) instead of reading Instagram. Set to false to read real profiles; no login is needed for public profiles.", "default": true }, "sessionCookies": { "title": "Session Cookies (JSON)", "type": "string", "description": "Optional. JSON array of cookies from the Cookie-Editor browser extension (log into Instagram with your own account, export the cookies as JSON, paste here). Not needed for public profile counts, bio and the latest 12 posts; with cookies the actor reads the logged-in page for more posts and like counts. 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 or ID of the key-value store where Cookie Manager saved your session (Cookie Manager's default is cookie-sessions). Enter it here so this run is allowed to read it." }, "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. Leave empty to read public profiles through Apify residential proxy (recommended: Instagram often refuses logged-out visits from data-center addresses). With session cookies, the logged-in page uses a proxy only when one is set here." }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }