# Instagram Video Downloader (`scrapecraze/instagram-video-downloader`) Actor Instagram Video Downloader lets you download publicly available Instagram videos in high quality. Save videos from posts, reels, and other public content for research, content analysis, marketing insights, archiving, and offline viewing with a fast and reliable solution. - **URL**: https://apify.com/scrapecraze/instagram-video-downloader.md - **Developed by:** [ScrapeCraze](https://apify.com/scrapecraze) (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 $4.99 / 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 ⚡ Downloading an Instagram reel or video one by one is slow, and it’s easy to end up with the wrong quality. **Instagram Video Downloader Actor** processes your input URLs in bulk and gives you ready-to-use download links at the resolution you select—perfect when you’re moving from content saving to research, archiving, or creator workflows. It’s also a great fit for anyone looking for an Instagram video downloader actor for creators, or an actor Instagram reel download workflow. **Creators, marketers, and data researchers** use it to save time and standardize video quality in every run. You can process multiple Instagram video URLs in one execution and start getting structured results quickly. --- ### See the Data: Sample Output Here's a real 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/video-merged.mp4" }, "title": "Sample Reel Title", "author": "sample_author", "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": 4500, "FPS": 30, "MimeType": "video/mp4", "Quality": "1080p" }, "audio_format_details": { "formatId": "140", "Label": "M4A (AUDIO)", "Extension": "m4a", "AudioQuality": 192, "AudioSampleRate": 48000, "MimeType": "audio/mp4", "Duration": 42 } } ```` If something goes wrong, the actor also pushes a failure record to the dataset, for example: ```json { "original_url": "https://www.instagram.com/reel/invalid_url/", "error": "Invalid resolution: 999p. Allowed values: 1080p, 720p, 480p, 360p.", "status": "FAILED" } ``` | Field | Type | What It Tells You | |---|---|---| | `original_url` | string | The Instagram video URL that was processed, so you can map results back to your input list. | | `requested_resolution` | string | The resolution you selected for this run (e.g., `1080p`). | | `found_resolution` | string | The actual resolution that was available and selected for the video output. | | `download_links` | object | URLs you can use to download the video outputs (video without audio, audio, and sometimes a merged video). | | `title` | string | The content title, useful for organizing an Instagram reel downloader for creators workflow. | | `author` | string | The uploader/creator name to help with sorting, attribution, and QA. | | `thumbnail` | string | A thumbnail image URL you can use in dashboards, previews, or dataset thumbnails. | | `duration` | number | Video length in seconds, helpful for filtering and review queues. | | `video_type` | string | Indicates whether the content is treated as a `reel` or a `long video`. | | `note` | string | A human-readable message describing whether the requested resolution was found or a fallback was used. | | `video_format_details` | object | Video stream metadata (quality, container/extension, dimensions, bitrate, FPS, MIME type). | | `audio_format_details` | object | Audio stream metadata (audio quality, sample rate, MIME type, duration). | | `status` | string | Present on failure records; helps you quickly separate failed items from successful outputs. | | `error` | string | Present on failure records; contains the error message for debugging your inputs (like resolution selection or other issues). | Export your full dataset as JSON, CSV, or Excel from the Apify dashboard. *** ### Setting It Up Drop this into your `input.json` and you're ready to go: ```json { "video_urls": [ { "url": "https://www.instagram.com/reel/DHCcTryOTlc/?igsh=NWp1YXg1azE4bm11" }, { "url": "https://www.instagram.com/reel/ANOTHER_REEL_URL/" } ], "desired_resolution": "1080p", "proxy": { "someProxySetting": "your proxy configuration here" } } ``` > Note: `proxy` is configured using Apify’s proxy editor UI (Residential proxies are available). Your exact object shape depends on what you set in that UI. | Parameter | Required | What It Does | |---|---|---| | `video_urls` | ✅ | Provide one or more Instagram video URLs for the actor to process. | | `desired_resolution` | ✅ | Select the resolution for the downloaded output: `1080p`, `720p`, `480p`, or `360p`. | | `proxy` | ✅ | Configures proxies for the run using Residential proxies, improving reliability for bulk jobs. | ↳ `video_urls[].url` | ✅ | The Instagram URL to process (a reel or long video URL). | *** ### What It Does This actor processes each provided Instagram video URL and pushes structured results (including download links) into your dataset. #### Bulk downloads at a selected resolution You choose `desired_resolution` from `1080p`, `720p`, `480p`, or `360p`. For each URL, the actor also records the `found_resolution` and a `note` explaining whether the exact requested quality was available or a fallback was used—great for an Instagram video downloader HD actor workflow. #### Works cleanly across reels and long videos Each result includes `video_type` (either `reel` or `long video`) along with `title`, `author`, `thumbnail`, and `duration`. That makes it easy to build a repeatable actor Instagram reel download process without manual sorting. #### Download links you can use right away Successful records include a `download_links` object with links for `video_without_audio`, `audio`, and (when applicable) a `merged_video`. The `video_format_details` and `audio_format_details` fields help you validate formats and quality before you import anything into your pipeline. #### Clear success and failure records For problematic inputs or runtime issues, the actor still pushes a dataset entry that includes `original_url`, an `error`, and `status: "FAILED"`. This means your dataset stays consistent and you can retry only the items that need attention. #### Proxy support for more reliable runs The run supports proxy configuration via the `proxy` input (Residential proxies are available). This helps the Instagram video downloader actor behave more reliably when you process multiple URLs in one run—especially for Instagram video downloader celebrity or creator batch workflows. Overall, the Instagram Video Downloader Actor turns your URL list into structured, quality-controlled download outputs—fast enough for production-style bulk saves. *** ### Why Instagram Video Downloader Actor? There are plenty of ways to pull data from Instagram videos—here’s why Instagram Video Downloader Actor stands out. #### Output is standardized for downstream use Results include consistent dataset fields like `requested_resolution`, `found_resolution`, `download_links`, and detailed `video_format_details` / `audio_format_details`. That’s what makes this an “actor Instagram reel download” option that fits into research and automation workflows. #### Built for batch processing You pass an array of `video_urls`, and the actor processes each one, pushing results as it goes. If you’re building an Instagram profile video downloader actor workflow, this saves you from repeating the same steps URL-by-URL. #### Clear handling when the requested quality isn’t available If `desired_resolution` can’t be found, the actor records that outcome in `note` and still provides the best available selection. This reduces the guesswork you usually get from an Instagram video downloader no watermark actor-style experience where users assume a specific quality will always be available. *** ### Real-World Use Cases Here's how different teams put Instagram Video Downloader Actor to work: **Marketing Teams**\ A campaign manager collects a set of creator reels to create a review board. They run Instagram video downloader HD actor jobs with `desired_resolution` set once, then sort the dataset by `author`, `title`, and `found_resolution` to decide what to repurpose. **Influencer Researchers**\ A researcher building a creator shortlist needs consistent assets for manual review. They feed multiple reel URLs into an Instagram video downloader actor run and use `download_links` plus `thumbnail` to quickly preview and compare content quality. **Automation & Data Engineers**\ A developer wants repeatable ingestion for a content archive. They schedule actor Instagram reel download jobs, read the dataset fields (`original_url`, `download_links`, `video_format_details`), and feed the files into storage or processing jobs without custom parsing. **Creators & Community Managers**\ When a community manager curates content for a community library, they need fast saves and predictable output quality. They use the Instagram video downloader for creators workflow to download reels and long videos, then track `duration` and `video_type` to organize content by format. **Enterprise QA for Media Libraries**\ QA teams test that media pipelines handle different formats. With `video_format_details` and `audio_format_details` included per item, they can confirm extensions, MIME types, and stream qualities after each run. *** ### How to Run It No code required. Here's how to get your first results in under 5 minutes: 1. **Open the actor page on Apify** — go to [console.apify.com](https://console.apify.com) and open the Instagram Video Downloader Actor listing. 2. **Enter your inputs** — add your Instagram URLs in `video_urls`, pick a `desired_resolution` (`1080p`, `720p`, `480p`, or `360p`), and provide `proxy`. 3. **Configure proxy settings** — use the built-in proxy configuration UI for this run (Residential proxies are available). 4. **Start the run and watch the live log** — monitor progress as each URL is processed. 5. **Open the Dataset tab to see live results** — each item appears with download links and metadata, or with `status: "FAILED"` and an `error`. 6. **Export in your preferred format** — download from the Apify dashboard as JSON, CSV, or Excel. The whole setup takes under 5 minutes — results start appearing within seconds of launch. *** ### Export & Integration Options Once your data is collected, Instagram Video Downloader Actor fits directly into your existing workflow. You can export results from the Apify dataset tab as **JSON, CSV, or Excel**, which is convenient for analysts and spreadsheet-based review. If you’re building a media archive or testing pipelines, exporting structured fields like `download_links`, `video_format_details`, and `audio_format_details` keeps your integration clean. For automation and programmatic workflows, you can use **API access** to pull run results, connect tools using **Zapier / Make**, or trigger downstream steps with **webhooks** when the run completes. You can also set up **scheduled runs** for recurring Instagram reel downloader for actors tasks. *** ### Pricing Instagram Video Downloader Actor runs on Apify, which includes a **free tier** — no credit card needed to start. The free tier provides **$5 platform credits** on sign-up, which is enough for several real test runs. For heavier usage, Apify uses **pay-as-you-go** billing per Actor compute unit (CU), and you can switch to subscription plans for larger workloads. Start free at [apify.com](https://apify.com) — scale up when you need to. *** ### Reliability & Limitations | What We Handle | How | |---|---| | Rate-limit resilience | Built-in support for reliable scraping using your proxy configuration. | | Quality selection behavior | Records `found_resolution` and a `note` explaining whether the requested resolution was found or a fallback was used. | | Reusable dataset outputs | Pushes structured results per URL, including failure records with `status: "FAILED"` and `error`. | | Multiple URLs in one run | Processes each entry from `video_urls` and writes outputs into your dataset. | Limitations: the actor expects valid public Instagram video URLs. If a requested `desired_resolution` isn’t available, the actor selects the best available option and communicates it in `note`, but you won’t necessarily get an exact match for every URL. Private, login-gated content or inaccessible pages are out of scope. For enterprise-scale needs or custom configurations, reach out and we'll help. *** ### Frequently Asked Questions #### Is there a free plan? Yes. Apify offers a free tier with monthly usage credits. You can run small tests with Instagram Video Downloader Actor before scaling up. #### Do I need to log in or create an account on Instagram? No. This actor is designed to work from publicly accessible data provided via `video_urls`—no Instagram login is required for the run itself. #### How accurate is the extracted download data? The actor provides download links and format metadata based on the selected formats it finds for each URL. If the exact `desired_resolution` is not available, `found_resolution` and `note` explain what was selected instead. #### How many results can I get per run? You can pass multiple items in `video_urls`, and the actor processes each one and pushes a dataset record per URL. The practical limit depends on your run environment and input size. #### How fresh is the data? The data reflects what’s available at the time the actor processes your URLs. If an account changes its media availability after your run starts, the results won’t reflect future updates. #### Is this legal? Does it comply with GDPR or CCPA? The actor is intended to work with **publicly available data**. It’s your responsibility to use the results lawfully and in compliance with GDPR, CCPA, and applicable platform terms. #### Can I export to Google Sheets or Excel? Yes. You can export from Apify as JSON, CSV, or Excel, then import into your spreadsheet tool (including Google Sheets). This makes it practical for workflows like an Instagram video downloader actor for creators or archiving. #### Can I schedule this to run automatically? Yes. You can schedule actor runs in Apify, which is useful for recurring Instagram reel downloader online actor tasks where you periodically refresh a library. #### Can I access results via the API? Yes. You can retrieve run outputs programmatically via the Apify API, which is helpful if you’re building an automation pipeline around Instagram video downloader celebrity research or media ingestion. #### What happens when the actor encounters an error? The actor pushes a failure record to your dataset with `original_url`, `error`, and `status: "FAILED"`. This way you can keep successful results and retry only the items that failed. *** ### Get Help & Use Responsibly Got a question about Instagram Video Downloader Actor or a feature you'd like added? Reach out at . We’re happy to help with workflow questions, improvements, and dataset usability ideas like adding more resolution-friendly labeling or expanding metadata coverage. **Disclaimer (please read):** This actor works with **publicly available data**. It does not access private Instagram accounts, login-gated pages, or password-protected content. It’s your responsibility to comply with GDPR, CCPA, and platform Terms of Service when using the results. 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("scrapecraze/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("scrapecraze/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 scrapecraze/instagram-video-downloader --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapecraze/instagram-video-downloader", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Instagram Video Downloader", "description": "Instagram Video Downloader lets you download publicly available Instagram videos in high quality. Save videos from posts, reels, and other public content for research, content analysis, marketing insights, archiving, and offline viewing with a fast and reliable solution.", "version": "1.0", "x-build-id": "UmITHpoMrMwAhWMni" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapecraze~instagram-video-downloader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapecraze-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/scrapecraze~instagram-video-downloader/runs": { "post": { "operationId": "runs-sync-scrapecraze-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/scrapecraze~instagram-video-downloader/run-sync": { "post": { "operationId": "run-sync-scrapecraze-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 } } } } } } } } } } ```