{
"openapi": "3.0.1",
"info": {
"title": "Instagram Reel Scraper",
"description": "Scrape or download Instagram reels. Just add Instagram profile or reel URL, and get caption, timestamp, transcript, hashtags, mentions, tagged users, comments, likes, shares, views, duration, and downloaded video. Export scraped data, schedule via API, and integrate with other tools or AI workflows.",
"version": "1.1",
"x-build-id": "kpSNgTIvDrmqLTxfo"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapeai~instagram-reel-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapeai-instagram-reel-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/scrapeai~instagram-reel-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapeai-instagram-reel-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/scrapeai~instagram-reel-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapeai-instagram-reel-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": {
"startUrls": {
"title": "Target Start URLs",
"type": "array",
"description": "Live public target URLs to request first. These can be replaced at run time.",
"items": {
"type": "object",
"properties": {
"url": {
"title": "URL",
"description": "Absolute live target URL.",
"type": "string"
}
},
"required": [
"url"
]
},
"default": [
{
"url": "https://www.instagram.com/reel/Dd9RyBWBVih/"
}
]
},
"endUrls": {
"title": "Target End URLs",
"type": "array",
"description": "Optional live target boundary URLs. They are fetched after start URLs and are kept separate in output.",
"items": {
"type": "object",
"properties": {
"url": {
"title": "URL",
"description": "Absolute live target URL.",
"type": "string"
}
},
"required": [
"url"
]
},
"default": []
},
"query": {
"title": "Search Query",
"type": "string",
"description": "Target query used by a derived source URL when the actor supports query search.",
"default": "Dd9RyBWBVih"
},
"maxItems": {
"title": "Max Items",
"minimum": 1,
"maximum": 50,
"type": "integer",
"description": "Maximum number of live records to return. Production default/prefill is 50; maximum is 50. Local input.json stays capped at 10.",
"default": 50
},
"maxRequestRetries": {
"title": "Max Request Retries",
"minimum": 0,
"maximum": 3,
"type": "integer",
"description": "Number of retries for a live target request.",
"default": 1
},
"requestTimeoutSecs": {
"title": "Request Timeout (seconds)",
"minimum": 5,
"maximum": 120,
"type": "integer",
"description": "Maximum time to wait for one live target request.",
"default": 25
},
"maxPages": {
"title": "Maximum Live Pages",
"minimum": 1,
"maximum": 10,
"type": "integer",
"description": "Maximum live listing/API pages to request, including discovered next pages.",
"default": 3
},
"crawlDetails": {
"title": "Fetch Detail Pages",
"type": "boolean",
"description": "When live rows expose same-site item URLs, fetch those detail pages in bulk and attach their fields.",
"default": false
},
"maxDetailPages": {
"title": "Maximum Detail Pages",
"minimum": 0,
"maximum": 10,
"type": "integer",
"description": "Maximum same-site detail URLs to fetch per run.",
"default": 0
},
"detailConcurrency": {
"title": "Detail Concurrency",
"minimum": 1,
"maximum": 5,
"type": "integer",
"description": "Maximum number of live detail requests in flight at once.",
"default": 4
},
"browserFallback": {
"title": "Browser DOM Fallback",
"type": "boolean",
"description": "If the direct live request is blocked or returns a JavaScript shell, render the same target in a local headless browser and parse the live DOM.",
"default": true
},
"proxyEnabled": {
"title": "Enable Apify Proxy",
"type": "boolean",
"description": "If the direct live request fails without a clear access challenge, retry once through the configured Apify datacenter proxy.",
"default": true
},
"targetInput": {
"title": "Original Target Input",
"type": "object",
"description": "Optional source-specific fields copied from this actor input schema. URL/query values are normalized by this actor.",
"properties": {
"username": {
"title": "🎞️ Instagram username, profile URL, ID, or reel URL",
"type": "array",
"description": "Add Instagram usernames, profile URLs, IDs, or direct reel URLs. Each item will be processed individually.",
"prefill": [
"https://www.instagram.com/reel/Dd9RyBWBVih/"
]
},
"resultsLimit": {
"title": "💯 Maximum reels per profile",
"type": "integer",
"description": "Set how many reels should be scraped per profile. For example, if set to 5, the scraper will extract up to 5 reels from each profile. This setting is ignored when scraping direct reel URLs.",
"prefill": 25
},
"onlyPostsNewerThan": {
"title": "📅 Scrape reels newer than",
"type": "string",
"description": "Scrape reels from the provided date up to the present. Supported formats include `YYYY-MM-DD`, full ISO timestamps (e.g. `2025-09-23T10:02:01`), or relative time such as `1 day`, `2 weeks`, or `3 months`. All times are evaluated in UTC."
},
"skipPinnedPosts": {
"title": "📌 Skip pinned reels",
"type": "boolean",
"description": "Enable this option if you want to exclude pinned reels from the overall results.",
"default": false
},
"skipTrialReels": {
"title": "🎬 Skip trial reels",
"type": "boolean",
"description": "If enabled, the feed will be scraped without trial reels: an Instagram feature creators use to test a video with non-followers before sharing it with their existing audience. Learn more.",
"default": false
},
"includeSharesCount": {
"title": "$$ Include shares count",
"type": "boolean",
"description": "Extract the number of shares for each reel. Available for paying users only. Upgrade to the Starter plan to unlock it.",
"default": false
},
"includeTranscript": {
"title": "$$ Include transcript",
"type": "boolean",
"description": "Extract a text transcript of the reel audio for content analysis. This add-on feature is charged per minute of audio.",
"default": false
},
"includeDownloadedVideo": {
"title": "$$ Include downloaded video",
"type": "boolean",
"description": "Download the reel video and store a local copy before Instagram links expire. This add-on feature is charged per 1 MB downloaded.",
"default": false
}
},
"default": {
"username": [
"https://www.instagram.com/reel/Dd9RyBWBVih/"
],
"resultsLimit": 1,
"includeTranscript": false,
"includeDownloadedVideo": false
},
"additionalProperties": 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
},
"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
}
}
}
}
}
}
}
}
}
}