{ "openapi": "3.0.1", "info": { "title": "Instagram Reels Scraper & Collab Partner Accounts", "description": "Instagram Reels Scraper & Collab Partner Accounts Extract reel captions, views, likes, comments, audio info, publish dates, and video links from public profiles. Perfect for trend discovery, competitor research, content analysis, and influencer tracking. Turn Reels data into insights fast 🚀", "version": "0.1", "x-build-id": "dV8FIrPWZGcGoSJ27" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapium~instagram-reels-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapium-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/scrapium~instagram-reels-scraper/runs": { "post": { "operationId": "runs-sync-scrapium-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/scrapium~instagram-reels-scraper/run-sync": { "post": { "operationId": "run-sync-scrapium-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." }, "onlyCollabReels": { "title": "🤝 Only Collab Reels", "type": "boolean", "description": "🎯 Keep only reels that were co-published with another account, so the run returns this creator's collaboration list instead of their whole reel feed. Turn it off to get every reel, each one annotated with its partners (or an empty list). Note that collab frequency varies enormously by account — around half of natgeo's reels are collabs, while some creators post one in twelve, so raise the Results Limit when scanning a creator who rarely collaborates.", "default": true }, "collabPartnerHandles": { "title": "👥 Only These Partner Handles", "type": "array", "description": "🔍 Keep only reels co-published with these accounts, e.g. [\"natgeotv\", \"disneyplus\"]. Use it to check whether a creator has already worked with a specific brand or creator before you make an offer. Matching ignores capitalisation and a leading @. Leave the list empty to return every partner.", "default": [], "items": { "type": "string" } }, "includeTaggedAccounts": { "title": "🏷️ Include Tagged Accounts", "type": "boolean", "description": "📍 Also return the accounts tagged inside the video itself, each with its position on the frame. This is a different and usually longer list than the @handles typed in the caption, which is all the base returns — on the reels measured, three out of four partner accounts were never written into the caption at all.", "default": true } } }, "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 } } } } } } } } } }