# Twitter Video Downloader (`kingscraper/twitter-video-downloader`) Actor Get direct CDN download URLs, complete metadata (likes, comments, uploader), and multiple quality options up to 1080p. Each video returns merged audio+video, separate tracks, thumbnails, and engagement metrics in structured JSON format. - **URL**: https://apify.com/kingscraper/twitter-video-downloader.md - **Developed by:** [King Scraper](https://apify.com/kingscraper) (community) - **Categories:** Videos, Social media, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing $5.00/month + usage To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors ## 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 - Ultimate Media Extraction Tool **The most powerful **Instagram Video Downloader** on Apify! Download Instagram Reels, videos, and stories with complete metadata, multiple quality options, and direct CDN links. Perfect for content creators, marketers, and developers.** --- ### 🚀 Overview Need a reliable **Instagram Video Downloader** that delivers professional-grade results? This actor is your complete solution: - ✅ **Direct Downloads** – Get instant CDN URLs without quality loss - 🔇 **Audio/Video Split** – Separate audio tracks for remixing - 📊 **Rich Metadata** – Captions, likes, comments, uploader details - 🎬 **Multiple Formats** – Choose from 5+ quality options - 📦 **Batch Processing** – Download hundreds of videos per run - 🎨 **Thumbnail Extraction** – High-resolution cover images Perfect for social media managers 📱, video editors 🎞️, data analysts 📈, and app developers 💻! --- ### ✨ Key Features #### 🎯 **Intelligent Media Extraction** - **Smart Quality Selection** – Automatically picks highest available resolution (up to 1080x1920) - **Audio Extraction** – Separate M4A audio tracks for podcasts or remixes - **Bulk Mode** – Process unlimited URLs in a single run - **URL Cleanup** – Automatically removes tracking parameters for clean canonical URLs #### 📋 **Comprehensive Metadata** - **Creator Info** – Uploader name, username, channel, and user ID - **Engagement Metrics** – Like count, comment count, view count - **Content Details** – Title, description, duration, upload date - **Technical Specs** – Resolution, codec info, frame rate, file size #### 🔧 **Advanced Technical Features** - **Multiple Format Support** – Video-only, audio-only, and merged streams - **CDN Direct Links** – High-speed Instagram CDN URLs - **Proxy Integration** – Bypass geo-restrictions seamlessly - **Storage Options** – Save to Apify storage or get direct links --- ### 📝 Input Configuration Simply paste your Instagram video URLs in the input field. The **Instagram Video Downloader** accepts any public Instagram video content: ```json { "reel_urls": [ { "url": "https://www.instagram.com/reel/DS2pxhLCJTK/" }, { "url": "https://www.instagram.com/reel/DRPZ1xokeMN/" } ] } ```` #### 📊 Input Specifications | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `reel_urls` | Array | ✅ Yes | List of Instagram video URLs to process | | `url` | String | ✅ Yes | Valid Instagram video URL (reel/, p/, tv/ formats) | *** ### 📤 Output Structure Your **Instagram Video Downloader** produces rich, structured data for each video: ```json { "input_url": "https://www.instagram.com/reel/DS2pxhLCJTK/", "canonical_url": "https://www.instagram.com/reel/DS2pxhLCJTK/", "shortcode": "DS2pxhLCJTK", "metadata": { "download_url": "https://scontent.cdninstagram.com/.../video.mp4", "has_sound": true, "title": "Video by cristiano", "description": "Game-changers stop time. They are timeless.", "duration": 106.68, "like_count": 6678834, "comment_count": 76195, "upload_date": "20251229", "uploader": "Cristiano Ronaldo", "uploader_id": "173560420", "channel": "cristiano", "thumbnail": "https://scontent.cdninstagram.com/.../thumb.jpg", "width": 1080, "height": 1920, "ext": "mp4", "available_formats": [ { "format_id": "8", "ext": "mp4", "resolution": "1080x1917", "type": "video+audio", "has_sound": true, "url": "https://scontent.cdninstagram.com/.../merged.mp4" }, { "format_id": "dash-1847892476089801v", "ext": "mp4", "resolution": "1080x1920", "type": "video_only", "has_sound": false, "url": "https://scontent.cdninstagram.com/.../video.mp4" }, { "format_id": "dash-1927276001512276a", "ext": "m4a", "resolution": "?x?", "type": "audio_only", "has_sound": true, "url": "https://scontent.cdninstagram.com/.../audio.m4a" } ] } } ``` #### 📋 Output Field Documentation ##### **Core Video Information** | Field | Description | |-------|-------------| | `download_url` | Primary download URL (merged video+audio) | | `title` | Video title/caption | | `description` | Full video description text | | `duration` | Video length in seconds | | `thumbnail` | High-resolution cover image URL | | `has_sound` | Boolean indicating if audio is available | ##### **Creator & Engagement Metrics** | Field | Description | |-------|-------------| | `uploader` | Display name of content creator | | `uploader_id` | Unique Instagram user ID | | `channel` | Username/handle | | `upload_date` | Publication date in YYYYMMDD format | | `like_count` | Total number of likes | | `comment_count` | Total number of comments | ##### **Available Formats** | Field | Description | |-------|-------------| | `format_id` | Unique identifier for each quality option | | `resolution` | Video dimensions (width x height) | | `type` | Format type (video+audio, video\_only, audio\_only) | | `ext` | File extension (mp4, m4a) | | `url` | Direct CDN download link | *** ### 🎨 Quality Options Available The **Instagram Video Downloader** automatically detects and provides all available quality tiers: #### **🎬 Merged Formats (Video + Audio)** - **1080p** – Full HD with audio (1920x1080) - **720p** – High definition with audio (1280x720) - **640p** – Standard definition (1136x640) #### **📹 Video-Only Streams** - **Ultra HD** – 1080x1920 (highest quality) - **High Quality** – 720x1280 - **Standard** – 540x960 - **Mobile** – Lower resolutions for fast downloads #### **🔊 Audio-Only Streams** - **M4A Format** – High-quality audio for podcasts and music - **Separate Tracks** – Perfect for remixing and editing Each format includes complete technical specifications for professional workflows. *** ### 💼 Use Cases #### 🎥 **Content Creators** - Repurpose Instagram videos for TikTok, YouTube, or Twitter - Create compilation videos from multiple creators - Backup your own content before deletion #### 📊 **Social Media Managers** - Archive client campaigns and viral content - Analyze competitor engagement metrics - Create content libraries for scheduling tools #### 📱 **App Developers** - Integrate Instagram video data into your applications - Build video analytics dashboards - Create content recommendation engines #### 🎬 **Video Editors** - Download raw footage for editing - Extract audio for podcast production - Access multiple quality tiers for different output formats #### 📈 **Data Analysts & Researchers** - Study viral video patterns and engagement metrics - Track influencer performance over time - Analyze content trends across categories *** ### 🎯 Why Choose This Instagram Video Downloader? - ⚡ **Lightning Fast** – Direct CDN downloads with no buffering - 🔒 **Privacy Focused** – No login required for public content - 📦 **Batch Processing** – Handle thousands of URLs efficiently - 🛡️ **Reliable** – Built to handle Instagram's rate limits - 🔄 **Always Updated** – Maintained for Instagram API changes - 📊 **Rich Data** – Get 30+ metadata fields per video - 💰 **Cost Effective** – Optimized for minimal compute usage *** ### ⚠️ Limitations & Considerations - 📌 **Public Content Only** – Works with publicly accessible Instagram videos - 🚦 **Rate Limits** – May encounter Instagram restrictions with high-volume runs - 🌐 **Geographic Restrictions** – Some content may have regional availability limits - 📱 **Stories** – Currently optimized for Reels and regular video posts *** ### 🔗 Related Actors ### 🔗 Related Actors in Our Social Media Suite #### 🎥 **YouTube Tools** - [YouTube Video Downloader](https://apify.com/kingscraper/youtube-video-downloader) - [YouTube Shorts Downloader](https://apify.com/kingscraper/youtube-shorts-downloader) - [YouTube Mp3/Thumbnail & Audio Scraper](https://apify.com/kingscraper/youtube-mp3-thumbnail-audio-scraper) - [Youtube Video and MP3 Downloader](https://apify.com/kingscraper/youtube-video-and-mp3-downloader) #### 📘 **Snapchat Tools** - [Snapchat Story Downloader](https://apify.com/kingscraper/snapchat-story-downloader) - [Snapchat Spotlight Downloader](https://apify.com/kingscraper/snapchat-spotlight-downloader) #### 📘 **Facebook Scraper Tools** - [Facebook Post Scraper](https://apify.com/kingscraper/facebook-post-scraper) - [Facebook Reels Downloader](https://apify.com/kingscraper/facebook-reels-downloader) - [Facebook Video Post Downloader](https://apify.com/kingscraper/facebook-video-post-downloader) - [Facebook Reels And Thumbnail Downloader](https://apify.com/kingscraper/facebook-reels-and-thumbnail-downloader) #### 📘 **Instagram Scraper Tools** - [Instagram Reels Scraper](https://apify.com/kingscraper/instagram-reels-scraper) - [Instagram Photo Scraper](https://apify.com/kingscraper/instagram-photo-scraper) #### 📘 **Pinterest Scraper Tools** - [Pinterest Video and Image Downloader](https://apify.com/kingscraper/pinterest-video-and-image-downloader) #### 📘 **TikTok Scraper Tools** - [TikTok Thumbnail & Audio Scraper](https://apify.com/kingscraper/tiktok-thumbnail-audio-scraper) - [Tiktok Video And Thumbnail Downloader](https://apify.com/kingscraper/tiktok-video-and-thumbnail-downloader) *** ### 📧 Need Custom Features? Looking for **higher resolution downloads**, **batch automation**, or **custom metadata extraction**? ✉️ **Email**: for tailored solutions! *** ### 🌟 Pro Tips 1. **For Best Quality**: Use the merged format with `type: "video+audio"` and highest resolution 2. **For Remixing**: Download both video-only and audio-only streams separately 3. **For Analytics**: Extract like/comment counts to track engagement trends 4. **For Archiving**: Save metadata JSON alongside video files for complete records *** **Ready to download Instagram videos like a pro?** 🚀 Try our **Instagram Video Downloader** today and experience the most comprehensive media extraction tool on the market! # Actor input Schema ## `tweet_urls` (type: `array`): List of public Twitter/X tweet URLs to scrape. Supported formats: https://x.com/{user}/status/{id} https://twitter.com/{user}/status/{id} URLs with query params like ?s=20 are also accepted. ## Actor input object example ```json { "tweet_urls": [ { "url": "https://x.com/espn/status/2038356497353073061?s=20" }, { "url": "https://x.com/AvatarNetflix/status/2038602142961836439?s=20" }, { "url": "https://x.com/TheAcademy/status/2036867226154701285?s=20" } ] } ``` # 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 = { "tweet_urls": [ { "url": "https://x.com/espn/status/2038356497353073061?s=20" }, { "url": "https://x.com/AvatarNetflix/status/2038602142961836439?s=20" }, { "url": "https://x.com/TheAcademy/status/2036867226154701285?s=20" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("kingscraper/twitter-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 = { "tweet_urls": [ { "url": "https://x.com/espn/status/2038356497353073061?s=20" }, { "url": "https://x.com/AvatarNetflix/status/2038602142961836439?s=20" }, { "url": "https://x.com/TheAcademy/status/2036867226154701285?s=20" }, ] } # Run the Actor and wait for it to finish run = client.actor("kingscraper/twitter-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 '{ "tweet_urls": [ { "url": "https://x.com/espn/status/2038356497353073061?s=20" }, { "url": "https://x.com/AvatarNetflix/status/2038602142961836439?s=20" }, { "url": "https://x.com/TheAcademy/status/2036867226154701285?s=20" } ] }' | apify call kingscraper/twitter-video-downloader --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=kingscraper/twitter-video-downloader", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Twitter Video Downloader", "description": "Get direct CDN download URLs, complete metadata (likes, comments, uploader), and multiple quality options up to 1080p. Each video returns merged audio+video, separate tracks, thumbnails, and engagement metrics in structured JSON format.", "version": "0.0", "x-build-id": "tGmahaPCfGa8rRKSg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kingscraper~twitter-video-downloader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kingscraper-twitter-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/kingscraper~twitter-video-downloader/runs": { "post": { "operationId": "runs-sync-kingscraper-twitter-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/kingscraper~twitter-video-downloader/run-sync": { "post": { "operationId": "run-sync-kingscraper-twitter-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": [ "tweet_urls" ], "properties": { "tweet_urls": { "title": "Tweet URLs", "type": "array", "description": "List of public Twitter/X tweet URLs to scrape.\n Supported formats:\n https://x.com/{user}/status/{id}\n https://twitter.com/{user}/status/{id}\n URLs with query params like ?s=20 are also accepted.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } } } }, "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 } } } } } } } } } } ```