{ "openapi": "3.0.1", "info": { "title": "Instagram Scraper: Posts, Reels, Comments & Profiles", "description": "Instagram scraper for public posts, reels, comments and profiles. By username, post link or reels keyword. No login needed, exact limits, real date and engagement filters, and you pay only for real, unique rows.", "version": "0.1", "x-build-id": "J21EGC5Bwj5rx9vCJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/apisamurai~instagram-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-apisamurai-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/apisamurai~instagram-scraper/runs": { "post": { "operationId": "runs-sync-apisamurai-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/apisamurai~instagram-scraper/run-sync": { "post": { "operationId": "run-sync-apisamurai-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": { "profiles": { "title": "Profiles", "type": "array", "description": "Get the posts or reels of these public accounts. Usernames or profile links: natgeo, @natgeo or https://www.instagram.com/natgeo/. One per line.", "items": { "type": "string" } }, "contentType": { "title": "What to get from profiles", "enum": [ "posts", "reels", "both" ], "type": "string", "description": "Posts gives the profile's feed (photos, carousels and the reels shown in the grid). Reels gives the Reels tab. Both gives both; a reel found in both is saved once.", "default": "posts" }, "includeProfile": { "title": "Add a profile row per username", "type": "boolean", "description": "On: also save one row with each profile's details (bio, followers, following, posts count, category).", "default": false }, "postUrls": { "title": "Post or reel links", "type": "array", "description": "Fetch full details of these posts or reels, e.g. https://www.instagram.com/p/DH3tWudxIKB/ or just the shortcode DH3tWudxIKB. One per line.", "items": { "type": "string" } }, "searchReels": { "title": "Search reels by keyword", "type": "array", "description": "Find public reels matching these keywords, one per line. Up to 11 result pages per keyword.", "items": { "type": "string" } }, "includeComments": { "title": "Get comments", "type": "boolean", "description": "On: also save the comments of every post and reel in the results (one row per comment).", "default": false }, "maxCommentsPerPost": { "title": "Max comments per post", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum comments saved for each post or reel. Enforced exactly.", "default": 50 }, "maxItemsPerSource": { "title": "Max posts per input item", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum posts or reels for each profile (and content type) or search keyword. Enforced exactly: the last page is trimmed.", "default": 50 }, "maxTotalItems": { "title": "Max rows for the whole run", "minimum": 1, "maximum": 10000000, "type": "integer", "description": "Optional hard cap on all rows (posts, reels, comments and profiles) across the run. Leave empty for no total cap." }, "postedAfter": { "title": "Posted on or after", "type": "string", "description": "Only posts and reels published on or after this day (UTC). Posts outside the range are skipped and not charged." }, "postedBefore": { "title": "Posted on or before", "type": "string", "description": "Only posts and reels published on or before this day (UTC, the whole day is included)." }, "minLikes": { "title": "Min likes", "minimum": 0, "type": "integer", "description": "Skip posts and reels with fewer likes. Posts with hidden like counts are skipped when this is set." }, "minViews": { "title": "Min views", "minimum": 0, "type": "integer", "description": "Skip posts and reels with fewer views. Rows without a view count, such as photos, are skipped when this is set." } } }, "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 } } } } } } } } } }