{ "openapi": "3.0.1", "info": { "title": "Instagram Scraper – Posts, Reels, Comments, Profiles & Places", "description": "Scrape public Instagram data without an account: profile details and latest posts, reels with plays, likes and comments, post comments, hashtag reels with related keywords, and places with coordinates. Pay only for successful results.", "version": "1.0", "x-build-id": "OTqThrpzN735BAhe5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/badr_xba~instagram-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-badr_xba-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/badr_xba~instagram-scraper/runs": { "post": { "operationId": "runs-sync-badr_xba-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/badr_xba~instagram-scraper/run-sync": { "post": { "operationId": "run-sync-badr_xba-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": { "directUrls": { "title": "🔗 Instagram URLs, usernames or #hashtags", "type": "array", "description": "One per line: profile (https://www.instagram.com/natgeo/, natgeo or @natgeo), profile reels tab (…/natgeo/reels/), post or reel (…/p/DLNsnpUTdVS/, …/reel/CigMSGeD4Hd/), hashtag (…/explore/tags/crossfit/ or #crossfit) or place (…/explore/locations/7538318/). Mobile links, instagr.am links, links with ?igsh=… tracking and whole lists pasted on one line (comma or space separated) are all understood; duplicates are read once.", "items": { "type": "string" } }, "resultsType": { "title": "📦 What to get", "enum": [ "posts", "reels", "comments", "details" ], "type": "string", "description": "Posts: the posts of a profile, hashtag or place, or the full post for a post URL. Reels: reels with likes, comments and plays. Comments: the comments shown on a post or reel URL. Details: one row describing the profile, hashtag, place or post itself.", "default": "posts" }, "resultsLimit": { "title": "💯 Results per URL", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum results for each URL. Instagram shows logged-out visitors up to 12 posts or 12 reels per profile, about 15 comments per post, the top 12 reels per hashtag and about 15 recent posts per place.", "default": 12 }, "onlyPostsNewerThan": { "title": "📅 Only posts newer than", "type": "string", "description": "Keeps only posts published after this date (UTC): 2026-09-01, 2026-09-01T13:00:00, or a period such as \"7 days\", \"2 months\". Rows Instagram shows without a date are kept." }, "includePostDetails": { "title": "Open each profile post for full details", "type": "boolean", "description": "A profile page lists its posts with caption, type and image only. Turn this on to open every post and add likes, comments count, date, location, tagged users and the latest comments. Slower: one page per post.", "default": false }, "maxItems": { "title": "Maximum results for the whole run", "minimum": 0, "type": "integer", "description": "Hard ceiling on rows saved (and billed) across all URLs. 0 = no ceiling. The run also stops cleanly when your maximum cost per run is reached.", "default": 0 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Instagram blocks datacenter addresses. Keep the residential group for reliable results.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }