# Instagram Video Downloader (`scraperoka/instagram-video-downloader`) Actor 📹 Instagram Video Downloader saves your favorite reels and videos in seconds! ⚡ Fast, easy & private—just copy the link and download. 🔒✨ Perfect for creators, fans & social media tools. #Instagram #VideoDownloader - **URL**: https://apify.com/scraperoka/instagram-video-downloader.md - **Developed by:** [Scraperoka](https://apify.com/scraperoka) (community) - **Categories:** Videos, Social media, Automation - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.01 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### Instagram Video Downloader Actor 🚀 Manually downloading Instagram videos one by one wastes hours you don’t have. **Instagram Video Downloader Actor** automates bulk downloads of Instagram reels and videos with your chosen quality—ideal for marketers, researchers, and growth teams that need content fast. This Instagram video downloader actor supports variations like instagram reels downloader actor, download Instagram reels actor, and instagram reel to mp4 actor for workflows that need consistent results at scale. In a single run, you can process multiple Instagram video URLs and collect structured metadata plus download links in minutes. --- ### What You Get: Sample Output Here’s a sample record from a single run: ```json { "original_url": "https://www.instagram.com/reel/DHCcTryOTlc/?igsh=NWp1YXg1azE4bm11", "requested_resolution": "1080p", "found_resolution": "1080p", "download_links": { "video_without_audio": "https://example.com/video-no-audio.mp4", "audio": "https://example.com/audio.m4a", "merged_video": "https://example.com/merged-1080p.mp4" }, "title": "Design Tips Reel", "author": "design.daily", "thumbnail": "https://example.com/thumbnail.jpg", "duration": 42, "video_type": "reel", "note": "Congrats, your requested resolution was found.", "video_format_details": { "formatId": "137", "Label": "1080p", "Extension": "mp4", "Width": 1080, "Height": 1920, "Bitrate": 3500, "FPS": 30, "MimeType": "video/mp4", "Quality": "1080p" }, "audio_format_details": { "formatId": "140", "Label": "m4a audio", "Extension": "m4a", "AudioQuality": 256, "AudioSampleRate": 44100, "MimeType": "audio/mp4", "Duration": 42 } } ```` | Field | Type | What It Tells You | |---|---|---| | `original_url` | string | The Instagram video URL that was processed | | `requested_resolution` | string | The resolution you asked for (e.g., `1080p`) | | `found_resolution` | string | The resolution actually selected from available formats | | `download_links` | object | Direct links for the downloaded content (video/audio/merged when available) | | `title` | string | The video title, if available | | `author` | string | The uploader/author name shown on the source content | | `thumbnail` | string | Thumbnail URL for quick previews | | `duration` | number | Length of the video in seconds | | `video_type` | string | Whether the item is treated as a `reel` or a `long video` | | `note` | string | Explains whether your requested resolution was found or a fallback was used | | `video_format_details` | object | Technical video characteristics (format, extension, dimensions, quality, etc.) | | `audio_format_details` | object | Technical audio characteristics (audio quality, sample rate, mime type, etc.) | Export your dataset as JSON, CSV, or Excel — straight from the Apify dashboard. *** ### Why Instagram Video Downloader Actor? There are a lot of ways to pull video data from Instagram—here’s what sets Instagram Video Downloader Actor apart. #### High-Quality Resolution Selection (1080p to 360p) You choose `desired_resolution` from `1080p`, `720p`, `480p`, or `360p`. The actor records both your request and the `found_resolution`, plus a clear `note` telling you whether the exact quality was available. #### Complete, Integration-Ready Download Links You get structured `download_links` for video and audio, plus `merged_video` when the selected video quality meets your requested threshold. This makes it easy to plug into an instagram video downloader tool actor workflow for content repurposing. #### Rich Media Metadata for Better Post-Processing Along with the links, you receive `title`, `author`, `thumbnail`, `duration`, `video_type`, and detailed `video_format_details` / `audio_format_details`. That’s useful if you’re building libraries of instagram downloader celebrity content or managing a catalog of reels and videos. #### Resilient Run Behavior with Clear Error Results If a URL fails, the actor pushes a failure record that includes `original_url`, `error`, and `status: "FAILED"`. For teams that need predictable outcomes, this is a big advantage versus a “best effort only” approach. *** ### Configuring Your Run Drop this into your `input.json` to get started: ```json { "video_urls": [ { "url": "https://www.instagram.com/reel/DHCcTryOTlc/?igsh=NWp1YXg1azE4bm11" } ], "desired_resolution": "1080p", "proxy": { "useApifyProxy": true } } ``` | Parameter | Required | What It Does | |---|---|---| | `video_urls` | ✅ | Provide one or more Instagram video URLs to process. | | `desired_resolution` | ✅ | Select the output quality you want: `1080p`, `720p`, `480p`, or `360p`. | | `proxy` | ✅ | Configure proxy settings for the run (only Residential proxies are available). | | ↳ `proxy.proxy support` | ⬜ | Enables Apify Proxy routing as part of your proxy configuration. | *** ### Core Capabilities #### Bulk Processing of Instagram Video URLs Feed an array of `video_urls` and the Instagram Video Downloader Actor processes each URL in the run. This is ideal for workflows like an instagram video downloader celebrity shortlist or downloading many instagram reels downloader actor targets in one go. #### Resolution Control with “Found vs Requested” Transparency The actor selects formats based on your `desired_resolution` and records `found_resolution` plus a `note` explaining whether your requested quality was found. This removes guesswork when you’re trying to download Instagram reels actor content at a specific quality level. #### Download Links for Video, Audio, and Merged Output For each item, you’ll get `download_links` containing the available video and audio URLs. When the selected video quality meets the requested threshold, `merged_video` is included as well—useful when you need a straightforward instagram reel to mp4 actor output. #### Detailed Media Format Information The actor outputs `video_format_details` and `audio_format_details` including fields like format identifiers, extension, dimensions (for video), quality, and sample rate (for audio). This is helpful for analysts comparing quality tiers, or for anyone doing consistent media pipelines. #### Clear Success and Failure Records in the Dataset Success results include the full metadata and links, while failures include `error` and `status: "FAILED"`. That keeps your dataset usable even when some URLs can’t be processed. *** ### Who Gets the Most Out of This Here’s how different teams put Instagram Video Downloader Actor to work: **Content repurposing and social media teams**—Download reels and videos at a consistent quality, capture metadata like `title` and `author`, and quickly build a reusable content library for ads and campaigns. **Influencer marketing teams**—Use the instagram video downloader actor workflow to quickly compile a media pack from creator reels, then standardize quality using `desired_resolution` while tracking what was actually `found_resolution`. **Researchers and analysts**—When building datasets for downstream analysis, the included `duration`, `video_type`, and format detail objects (`video_format_details`, `audio_format_details`) make it easier to compare media characteristics. **Developers and automation specialists**—Integrate results into pipelines via Apify dataset exports or API retrieval, using structured objects like `download_links` and `video_format_details` as reliable fields for automation. *** ### Step-by-Step: How to Use It No coding needed. Here's how to run Instagram Video Downloader Actor from start to finish: 1. **Open the actor on Apify** — visit [console.apify.com](https://console.apify.com) and find Instagram Video Downloader Actor. 2. **Enter your inputs** — add one or more items under `video_urls`, choose `desired_resolution`, and provide `proxy`. 3. **Configure proxy settings** — set your Residential proxy configuration in the `proxy` field. 4. **Hit Run and watch the live log** — follow progress as each URL is processed and results are pushed. 5. **View results in the dataset tab** — each URL produces a record with metadata and `download_links`. 6. **Export as JSON, CSV, or Excel** — download directly from the Apify dataset UI for sharing or analysis. The whole process takes under 5 minutes to set up. *** ### Integrations & Export Options Once your data is collected, Instagram Video Downloader Actor plugs directly into your existing workflow. You can download results from the Apify dataset tab in common formats like JSON, CSV, and Excel. This is useful when you want an instagram downloader tool actor output you can load into spreadsheets, BI tools, or media management systems. You can also connect your run to automation and retrieval flows using Apify’s API (see: [apify.com/docs/api](https://apify.com/docs/api)). If you’re using no-code tools like Zapier or Make, you can move results to CRMs and other destinations—perfect for an instagram video downloader online actor workflow where the “next step” should be automated. *** ### Pricing & Free Trial Instagram Video Downloader Actor runs on the Apify platform, which offers a **free tier** — no credit card required to get started. Free tier credits are typically enough for several test runs, so you can validate resolution quality and link output before scaling. For production usage, costs are determined by Apify platform compute units (CUs) and your run configuration. For exact pricing, refer to Apify’s pricing page and plan options. Start for free at [apify.com](https://apify.com) and scale when you're ready. *** ### Reliability & Performance | What We Handle | How | |---|---| | Proxy support | Built-in proxy configuration for more reliable scraping | | Output completeness | Includes `download_links` and rich metadata when available | | Requested vs actual quality | Returns both `requested_resolution` and `found_resolution` with a `note` | | Dataset usability on failures | Failure records include `original_url`, `error`, and `status: "FAILED"` | | Multi-URL runs | Processes each item from your `video_urls` list in one actor run | **Limitations:** Instagram content that isn’t publicly accessible may not be retrievable, and some items may not provide all link or metadata fields. If an item doesn’t offer the requested quality, the actor records the closest available `found_resolution`. For enterprise-scale runs, contact us to discuss custom configurations. *** ### Frequently Asked Questions #### Is there a free plan or trial for Instagram Video Downloader Actor? Yes. Apify provides a free tier so you can test Instagram Video Downloader Actor before scaling to larger batches. #### Do I need to log in to Instagram to use this? No. This Instagram video downloader actor is designed to work with publicly available content without requiring your Instagram login. #### How accurate is the resolution and format information? The actor reports `requested_resolution` (what you asked for) and `found_resolution` (what was actually selected). It also includes `note` plus `video_format_details` and `audio_format_details` so you can verify the chosen output. #### How many results can I get per run? Your results come from the number of items you provide in `video_urls`. There’s no fixed “result count” field in the actor input schema—your batch size is controlled by how many URLs you submit. #### How often is the data updated / how fresh is it? Freshness depends on when the run is executed, because the actor processes the URLs at runtime and outputs links and metadata from that moment. #### Is this legal? Does it comply with GDPR / CCPA? The actor works with **publicly available data**. You are responsible for complying with GDPR, CCPA, applicable regulations, and the platform’s Terms of Service for how you store and use the downloaded content. #### Can I export results to Google Sheets or Excel? Yes. Export your dataset from the Apify dashboard in formats like JSON, CSV, or Excel, and then import into your preferred spreadsheet or analytics workflow. #### Can I run this on a schedule automatically? Yes. You can schedule Apify actor runs using Apify’s scheduling features so your instagram reels downloader actor workflow runs automatically at set intervals. #### Can I access this via API? Yes. You can pull results programmatically via the Apify API after triggering runs from your own systems. See [apify.com/docs/api](https://apify.com/docs/api). #### What happens if the actor hits an error? For failures, the actor pushes a record containing `original_url`, `error`, and `status: "FAILED"`. That way, your dataset stays useful even if some URLs can’t be processed. *** ### Need Help or Have a Request? Got a question about Instagram Video Downloader Actor or want a new feature added? Reach out at . We actively maintain this actor and can help with practical workflow improvements like batch media handling and export-friendly output. If you have an automation idea for an instagram video downloader actor name workflow, tell us what you’re building. *** ### Disclaimer & Responsible Use *Instagram Video Downloader Actor is the fastest, most reliable way to download Instagram reels and videos with chosen quality — start your free run today.* This actor accesses **publicly available data** and does not access private profiles, login-gated content, or password-protected pages. You are responsible for ensuring your use complies with GDPR, CCPA, platform Terms of Service, and any applicable local regulations. For data removal requests, contact . Use responsibly, ethically, and only for lawful purposes. # Actor input Schema ## `video_urls` (type: `array`): List of Instagram video URLs to process. ## `desired_resolution` (type: `string`): Select the desired resolution: 1080p, 720p, 480p, or 360p. ## `proxy` (type: `object`): Configure proxies for this Actor. Only Residential proxies are available. ## Actor input object example ```json { "video_urls": [ { "url": "https://www.instagram.com/reel/DHCcTryOTlc/?igsh=NWp1YXg1azE4bm11" } ], "desired_resolution": "1080p" } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "video_urls": [ { "url": "https://www.instagram.com/reel/DHCcTryOTlc/?igsh=NWp1YXg1azE4bm11" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("scraperoka/instagram-video-downloader").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "video_urls": [{ "url": "https://www.instagram.com/reel/DHCcTryOTlc/?igsh=NWp1YXg1azE4bm11" }] } # Run the Actor and wait for it to finish run = client.actor("scraperoka/instagram-video-downloader").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "video_urls": [ { "url": "https://www.instagram.com/reel/DHCcTryOTlc/?igsh=NWp1YXg1azE4bm11" } ] }' | apify call scraperoka/instagram-video-downloader --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scraperoka/instagram-video-downloader", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Instagram Video Downloader", "description": "📹 Instagram Video Downloader saves your favorite reels and videos in seconds! ⚡ Fast, easy & private—just copy the link and download. 🔒✨ Perfect for creators, fans & social media tools. #Instagram #VideoDownloader", "version": "1.0", "x-build-id": "BsnU8DqRCFvnA7qVo" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraperoka~instagram-video-downloader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraperoka-instagram-video-downloader", "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/scraperoka~instagram-video-downloader/runs": { "post": { "operationId": "runs-sync-scraperoka-instagram-video-downloader", "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/scraperoka~instagram-video-downloader/run-sync": { "post": { "operationId": "run-sync-scraperoka-instagram-video-downloader", "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": [ "video_urls", "desired_resolution", "proxy" ], "properties": { "video_urls": { "title": "Instagram Video URLs", "type": "array", "description": "List of Instagram video URLs to process.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "desired_resolution": { "title": "Desired Resolution", "enum": [ "1080p", "720p", "480p", "360p" ], "type": "string", "description": "Select the desired resolution: 1080p, 720p, 480p, or 360p.", "default": "1080p" }, "proxy": { "title": "Proxy Configuration", "type": "object", "description": "Configure proxies for this Actor. Only Residential proxies are available." } } }, "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 } } } } } } } } } } ```