{ "openapi": "3.0.1", "info": { "title": "Instagram Post Scraper", "description": "Instagram Profile Post Scraper lets you collect structured post data from any public profile. Get captions, hashtags, media links, engagement stats, and publish times. Ideal for marketers, researchers, and developers needing fresh Instagram content insights in a usable format.", "version": "0.2", "x-build-id": "HHO3GcDQZ6UUd5kRl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraper-engine~instagram-post-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraper-engine-instagram-post-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/scraper-engine~instagram-post-scraper/runs": { "post": { "operationId": "runs-sync-scraper-engine-instagram-post-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/scraper-engine~instagram-post-scraper/run-sync": { "post": { "operationId": "run-sync-scraper-engine-instagram-post-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", "required": [ "username" ], "properties": { "username": { "title": "🏃 Instagram username, profile URL, or post URL", "type": "array", "description": "Add one or more Instagram usernames (natgeo), profile URLs (https://www.instagram.com/natgeo/), or single post / reel / tv URLs (https://www.instagram.com/p/SHORTCODE/). Story links, /explore/tags/ links and /share/ links are not supported and are rejected with a message instead of being scraped as if they were a handle.", "items": { "type": "string" } }, "resultsLimit": { "title": "💖 Maximum posts per profile", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum number of posts to return per profile. Ignored for single post URLs (one URL always returns one row). Instagram serves 12 posts per feed request and that page size cannot be raised, so a large limit means many requests: about 1 request per 12 posts plus a 1 second pause between pages.", "default": 10 }, "skipPinnedPosts": { "title": "📌 Skip pinned posts", "type": "boolean", "description": "Drop the posts pinned to the top of the profile grid being scraped. Collaboration posts that are pinned on somebody else's grid are kept.", "default": false }, "onlyPostsNewerThan": { "title": "🗓️ Only posts newer than", "type": "string", "description": "Only return posts newer than this cutoff (UTC). Use the Absolute tab for a YYYY-MM-DD date or a full ISO timestamp, or the Relative tab for values such as '6 hours', '3 days', '1 week', '2 months', '1 year'. A value that cannot be understood stops the run instead of being silently ignored. Leave empty for no cutoff.", "default": null }, "dataDetailLevel": { "title": "Data detail level", "enum": [ "detailedData", "basicData" ], "type": "string", "description": "Detailed adds alt text, a sample of the latest comments, first comment, music info, the paid-partnership flag, real carousel child shortcodes and video play count, at the cost of one extra page request per post (measured 6.2 s vs 2.8 s per 12 posts). Both levels save one row per post and cost exactly the same per saved row.", "default": "detailedData" }, "proxyConfiguration": { "title": "🌐 Proxy configuration", "type": "object", "description": "Proxy used for every Instagram request. The default is Apify Proxy with the RESIDENTIAL group. Datacenter groups do return posts, but the profile page used to read Instagram's page tokens is more likely to be rate-limited from a datacenter exit.", "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 } } }, "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 } } } } } } } } } }