{ "openapi": "3.0.1", "info": { "title": "Instagram Post Scraper", "description": "Read public Instagram post, reel, TV, and legacy profile metadata. Returns available captions, author fields, structured metadata, and media URL references, or explicit access diagnostics when Instagram requires login. Media bytes are not downloaded.", "version": "1.0", "x-build-id": "lXg01lSCJ2elYsElb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/w3crawler~instagram-post-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-w3crawler-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/w3crawler~instagram-post-scraper/runs": { "post": { "operationId": "runs-sync-w3crawler-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/w3crawler~instagram-post-scraper/run-sync": { "post": { "operationId": "run-sync-w3crawler-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", "properties": { "post_urls": { "title": "Post URLs", "maxItems": 100, "type": "array", "description": "Public Instagram post, reel, TV, or profile URLs. Tracking parameters are removed and duplicates are deduplicated.", "items": { "type": "string", "pattern": "^https://(?:www\\.)?instagram\\.com/" } }, "postUrls": { "title": "Post URL alias", "maxItems": 100, "type": "array", "description": "Compatibility alias for post_urls.", "items": { "type": "string", "pattern": "^https://(?:www\\.)?instagram\\.com/" } }, "startUrls": { "title": "Start URL alias", "maxItems": 100, "type": "array", "description": "Compatibility request-list alias for public Instagram post or profile URLs.", "items": { "type": "object", "properties": { "url": { "type": "string", "title": "URL", "description": "HTTPS Instagram post, reel, TV, or profile URL.", "pattern": "^https://(?:www\\.)?instagram\\.com/" } }, "required": [ "url" ], "additionalProperties": false } }, "username": { "title": "Username alias", "pattern": "^@?[A-Za-z0-9._]{1,30}$", "type": "string", "description": "Public Instagram username; an optional leading @ is accepted." }, "usernames": { "title": "Usernames", "maxItems": 100, "type": "array", "description": "Public Instagram usernames to resolve to profile pages and bounded recent post discovery.", "items": { "type": "string", "pattern": "^@?[A-Za-z0-9._]{1,30}$" } }, "maxPostsPerUsername": { "title": "Posts per username", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum recent public post URLs discovered from each requested profile.", "default": 3 }, "maxItems": { "title": "Maximum output items", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of requested and discovered targets processed in one run.", "default": 100 }, "requestTimeoutSecs": { "title": "Request timeout (seconds)", "minimum": 5, "maximum": 60, "type": "integer", "description": "Per-request timeout for public page and oEmbed calls.", "default": 20 }, "maxRequestRetries": { "title": "Retries", "minimum": 0, "maximum": 3, "type": "integer", "description": "Additional attempts for transient HTTP failures.", "default": 2 }, "requestDelayMs": { "title": "Delay between targets (ms)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Optional delay between target requests.", "default": 0 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional Apify Proxy configuration. Direct access is the default.", "properties": { "useApifyProxy": { "type": "boolean", "title": "Use Apify Proxy", "description": "Route public Instagram requests through Apify Proxy." }, "apifyProxyGroups": { "type": "array", "title": "Proxy groups", "description": "Optional explicit Apify Proxy groups.", "items": { "type": "string" } }, "apifyProxyCountry": { "type": "string", "title": "Country", "description": "Optional two-letter Apify Proxy country code.", "pattern": "^[A-Za-z]{2}$" } }, "default": { "useApifyProxy": false }, "additionalProperties": false } } }, "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 } } } } } } } } } }