{ "openapi": "3.0.1", "info": { "title": "Instagram Scraper ā€” Posts, Profiles, Followers & Hashtags", "description": "The all-in-one Instagram scraper: extract profiles, posts, reels, comments, likes, followers, following, tagged, stories, highlights, hashtags, locations, search and bio emails/contacts ā€” from one Actor. Clean structured data with full pagination, exported to JSON, CSV or Excel. Pay only per result.", "version": "1.0", "x-build-id": "2WHLf0wA0pmhkroLb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/pro100chok~instagram-scraper-all-in-one/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-pro100chok-instagram-scraper-all-in-one", "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/pro100chok~instagram-scraper-all-in-one/runs": { "post": { "operationId": "runs-sync-pro100chok-instagram-scraper-all-in-one", "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/pro100chok~instagram-scraper-all-in-one/run-sync": { "post": { "operationId": "run-sync-pro100chok-instagram-scraper-all-in-one", "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": [ "scrapeType" ], "properties": { "scrapeType": { "title": "šŸŽÆ What do you want to scrape?", "enum": [ "profile", "contacts", "posts", "reels", "post", "comments", "likes", "followers", "following", "tagged", "stories", "highlights", "hashtag", "location", "search" ], "type": "string", "description": "Choose a mode. Modes marked šŸ”‘ need an Instagram login cookie (see the Login section below). Everything else works without login.", "default": "posts" }, "directUrls": { "title": "šŸ”— Instagram URLs or usernames", "type": "array", "description": "One per line. Accepts what the chosen mode expects:\nā€¢ Profile modes (details, posts, reels, followers, following, tagged, stories, highlights) ā†’ `https://www.instagram.com/nasa/`, `@nasa` or just `nasa`\nā€¢ Post modes (post detail, comments, likes) ā†’ `https://www.instagram.com/p/SHORTCODE/` or `/reel/SHORTCODE/`\nā€¢ Hashtag mode ā†’ `https://www.instagram.com/explore/tags/nature/` or `#nature` or `nature`\nā€¢ Location mode ā†’ `https://www.instagram.com/explore/locations/212988663/` or the numeric id\nLeave empty when using Search mode.", "items": { "type": "string" } }, "search": { "title": "šŸ”Ž Search query", "type": "string", "description": "Used only in šŸ”Ž Search mode. Free text, e.g. `nasa`, `coffee`, `new york`." }, "searchType": { "title": "Search for", "enum": [ "all", "user", "hashtag", "place" ], "type": "string", "description": "Limit search results to one entity type, or return all.", "default": "all" }, "resultsLimit": { "title": "šŸ“Š Max results per input", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Upper bound of records collected for each URL/username/hashtag/location. Pagination stops automatically when the source is exhausted.", "default": 100 }, "sessionCookie": { "title": "šŸ”‘ Instagram login cookie", "type": "string", "description": "REQUIRED for: šŸ’¬ comments, ā¤ļø likes, šŸ‘„ followers, āž”ļø following, šŸ·ļø tagged, šŸ“ø stories, šŸŒŸ highlights, #ļøāƒ£ hashtag, šŸ“ location and šŸ”Ž search. Profile, contacts, posts, reels and post-detail modes do NOT need it.\n\nHow to get your cookies:\n1. Install the EditThisCookie v3 Chrome extension.\n2. Log into instagram.com in your browser.\n3. Click the EditThisCookie icon and export the cookies (the 5th button at the top of the cookie editor). This copies them as JSON.\n4. Paste the exported JSON into this field.\n\nThe field also accepts just your `sessionid` value or a full `name=value; name=value` cookie string. Stored encrypted.\n\nCookie expiry: Instagram cookies usually last a few days to a few weeks. If a previously working run reports invalid authentication, re-export fresh cookies and paste them again." }, "proxyConfiguration": { "title": "šŸŒ Proxy", "type": "object", "description": "Residential proxies are strongly recommended. To use your own proxy (e.g. for local testing) switch to the Custom proxies tab and paste your proxy URL.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }, "maxRetries": { "title": "Max retries per request", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many times to rotate IP and retry a request before giving up on it.", "default": 6 } } }, "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 } } } } } } } } } }