{ "openapi": "3.0.1", "info": { "title": "Instagram Reels Scraper", "description": "Instagram Reels Scraper lets you extract reels data quickly and efficiently. Gather video URLs, captions, hashtags, likes, views, comments, and user profiles. Ideal for research, analytics, and trend tracking with fast, reliable, and easy automation.", "version": "0.1", "x-build-id": "FjltCTrFEFkX6EpC1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraper-engine~instagram-reels-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraper-engine-instagram-reels-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-reels-scraper/runs": { "post": { "operationId": "runs-sync-scraper-engine-instagram-reels-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-reels-scraper/run-sync": { "post": { "operationId": "run-sync-scraper-engine-instagram-reels-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 Usernames / Profiles", "type": "array", "description": "🎯 Add one or multiple usernames, @handles, or profile URLs to start scraping reels.", "items": { "type": "string" } }, "resultsLimit": { "title": "🎞️🔢 Results Limit", "minimum": 1, "maximum": 10000, "type": "integer", "description": "📦 Maximum number of reels/posts to collect per username.", "default": 10 }, "onlyPostsNewerThan": { "title": "📅⏱️ Only Posts Newer Than", "type": "string", "description": "🗓️ Fetch only recent posts after a specific date. Use date picker for absolute date (YYYY-MM-DD) or type relative time like 7 days, 2 weeks, or 1 month. Leave empty to fetch all.", "default": "" }, "skipPinnedPosts": { "title": "📌⏭️ Skip Pinned Posts", "type": "boolean", "description": "🙈 Turn on to ignore pinned posts and focus on regular timeline content.", "default": false }, "includeSharesCount": { "title": "🔁📊 Include Shares Count", "type": "boolean", "description": "📈 Include share count for each post when Instagram makes it available.", "default": false }, "includeTranscript": { "title": "📝🎙️ Include Transcript", "type": "boolean", "description": "🧠 Extract and include caption/transcript text in your output data.", "default": false }, "includeDownloadedVideo": { "title": "⬇️🎥 Include Downloaded Video", "type": "boolean", "description": "💾 Download reel videos to Key-Value Store and include downloadable links in output.", "default": false }, "proxyConfiguration": { "title": "🛡️🌐 Proxy Configuration", "type": "object", "description": "🔐 The actor always uses Apify's residential proxy (3 attempts) for reliability. If you provide your own custom proxy URLs here, the actor will try those first and automatically fall back to residential if they fail. Apify proxy group selections are ignored — residential is always the safety net." } } }, "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 } } } } } } } } } }