# Threads Post Media Downloader (`solid-scraper/threads-post-media-downloader`) Actor 🚀 Download media from Threads effortlessly with Threads Post Media Downloader. Save photos & videos in seconds, fast and reliable. 📥✨ Perfect for creators, marketers, and social media teams. Try it today! 🛠️ - **URL**: https://apify.com/solid-scraper/threads-post-media-downloader.md - **Developed by:** [SolidScraper](https://apify.com/solid-scraper) (community) - **Categories:** Social media, Automation, Videos - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.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 ### Threads Post Media Downloader 🧵 **Threads Post Media Downloader** extracts high-quality media details—like images, video URLs, and carousel content—from **Threads.net** posts. If you’re looking for a **Threads post media downloader**, a tool that helps you **download Threads photos**, **download Threads videos**, or quickly build a **Threads image downloader** / **Threads video downloader** workflow, this actor is built for that. Whether you’re a marketer, data analyst, or researcher, you can collect media metadata at scale from public Threads posts—saving you hours of manual copying and organizing. --- ### Why choose Threads Post Media Downloader? | Feature | Benefit | | --- | --- | | ✅ All-in-one media extraction | Extracts images and videos (including carousel posts) with consistent metadata | | ✅ Structured JSON output | Returns media details as a clean, ready-to-process JSON object per input URL | | ✅ Reliability-focused fetching | Includes resilience with built-in resilience behaviors for more dependable runs | | ✅ Built-in proxy support | Uses a configurable proxy setup for more consistent access across batches | | ✅ Works with multiple URLs | Processes a list of Threads post URLs in one execution | | ✅ Clear success/error results | Produces an `error` state in the output when media data can’t be found or fetching fails | --- ### Key features - 🔎 **Threads post media extraction**: Pulls media metadata (thumbnail, caption, resolution, type) from Threads posts - 🖼️ **Download Threads photos**: Returns the best available image candidate with width, height, resolution, and extension (`jpg`) - 🎬 **Download Threads videos**: Detects video media and returns the selected video media URL plus `quality` and timing info (`time_end`) - 🔄 **Carousel support**: Handles single media posts and carousel posts, returning a list of `medias` for each - 📊 **Quality and resolution details**: Outputs `quality`, `width`, `height`, and `resolution` for each media item - 💾 **Real-time dataset saving**: Each processed URL is pushed immediately to the dataset so results aren’t lost during long runs - 🛡️ **Proxy configuration option**: Lets you choose proxy behavior via the `proxyConfiguration` input --- ### Input Provide input via an `input.json` file. Example structure: ```json { "urls": [ "https://www.threads.net/@shams/post/DFntiSvSsNq" ], "proxyConfiguration": { "useApifyProxy": true } } ```` #### Input Fields | Field | Required | Description | | --- | --- | --- | | `urls` | No | A list of Threads post URLs to scrape (for example, `https://www.threads.net/@username/post/...`). | | `proxyConfiguration` | No | Proxy configuration for the crawler. If omitted, no proxy is used by default. | | `proxyConfiguration.proxy support` | No | When set to `true`, the actor uses Apify Proxy for your run. Default is `true`. | *** ### Output The actor pushes results to the dataset in **JSON format** under `charged_event_name="result"`. Sample output for one successful URL: ```json [ { "url": "https://www.threads.net/@shams/post/DFntiSvSsNq", "result": { "url": "https://www.threads.net/@shams/post/DFntiSvSsNq", "source": "threads", "pk": "12345", "id": "67890", "author": "", "title": "Post caption text here", "like_count": "123", "thumbnail": "https://example.com/thumbnail.jpg", "medias": [ { "url": "https://example.com/media.jpg", "thumbnail": "https://example.com/thumbnail.jpg", "pk": "12345", "id": "67890", "caption": "Post caption text here", "quality": "Image 1080x1350p", "accessibility_caption": null, "height": 1350, "width": 1080, "resolution": "1080x1350", "extension": "jpg", "type": "image" } ], "type": "single", "error": false, "time_end": 0 } } ] ``` Sample output when media data can’t be found: ```json [ { "url": "https://www.threads.net/@shams/post/DFntiSvSsNq", "result": { "error": true, "message": "Could not find media data" } } ] ``` #### Output Fields | Field | Type | Description | | --- | --- | --- | | `url` | string | The Threads post URL that was processed. | | `result` | object | The result payload for this URL. | | `result.url` | string | The same post URL, included inside the result. | | `result.source` | string | Always `threads` for successful media extractions. | | `result.pk` | string | The post’s `pk` extracted from the media payload (stringified). | | `result.id` | string | The post’s `id` extracted from the media payload (stringified). | | `result.author` | string | The actor includes an `author` field; in the current implementation it is an empty string (`""`). | | `result.title` | string | null | Caption text (from the post caption), or `null` if unavailable. | | `result.like_count` | string | Like count as a string (empty string if missing). | | `result.thumbnail` | string | The best thumbnail URL selected from available image candidates. | | `result.medias` | array | A list of media items (single post media or carousel items). | | `result.type` | string | Either `single` or `carousel`. | | `result.error` | boolean | `false` for successful extractions; errors use a different payload with a `message`. | | `result.time_end` | number | Video-related timing end value when available; otherwise `0`. | | `result.message` | string | Present only in failure outputs, e.g. `"Could not find media data"` or a status code message. | **Media item fields** inside `result.medias[]`: | Field | Type | Description | | --- | --- | --- | | `url` | string | The selected media URL (video URL for videos, otherwise the image URL). | | `thumbnail` | string | Thumbnail URL for the media item (best image candidate). | | `pk` | string | Media item `pk` (stringified). | | `id` | string | Media item `id` (stringified). | | `caption` | string | null | Caption text for the media item, or `null` if missing. | | `quality` | string | Human-readable quality label like `Video {width}x{height}p` or `Image {width}x{height}p`. | | `accessibility_caption` | string | null | Accessibility caption if present. | | `height` | number | Pixel height. | | `width` | number | Pixel width. | | `resolution` | string | Resolution formatted as `{width}x{height}`. | | `extension` | string | `mp4` for videos, otherwise `jpg`. | | `type` | string | Either `video` or `image`. | You can export the dataset results from Apify in common formats like **JSON** (and often CSV depending on the UI/export options), which makes this Threads media downloader online workflow easy to plug into analytics. *** ### How to use Threads Post Media Downloader (via Apify Console) 1. **Open Apify Console**\ Log in at https://console.apify.com and open the **Actors** section. 2. **Find the actor**\ Search for **Threads Post Media Downloader 🧵** and open the actor page to view inputs and outputs. 3. **Switch to the INPUT tab**\ Paste your **Threads post URLs** into the `urls` field. 4. **Add proxy settings (optional but recommended for batches)**\ In **Proxy configuration**, set `proxy support` to `true` (default) if you want Apify Proxy support. 5. **Run the actor**\ Click **Run** to start scraping. The actor will log progress and process your URL list one by one. 6. **Monitor logs**\ You’ll see status updates like “Scraping finished” and per-URL success/failure messages. If it can’t find media data, it records that as an error in the result payload. 7. **Open the dataset output**\ After completion, open the dataset and review each item’s `result` payload—including `medias`, `thumbnail`, `type` (`single`/`carousel`), and `time_end` for videos. 8. **Export your results**\ Export the dataset to your preferred format for downstream tools and reporting. No coding required—get accurate Threads media metadata in minutes. *** ### Advanced features & SEO optimization - 🌐 **Threads post media URL downloader workflow**: Feed multiple post links into `urls` to automate extracting media metadata for download Threads photos and download Threads videos use cases. - 🧩 **Carousel-first parsing**: Returns `result.type` as `carousel` when carousel media is detected, so you can handle Threads reel-like content consistently for a Threads reel downloader workflow. - 🛡️ **Proxy support for reliable scraping**: Uses your `proxyConfiguration` settings to help improve consistency across runs when traffic patterns vary. - 🧾 **Detailed result objects**: Successful runs return structured fields like `medias`, `resolution`, and `extension` (mp4/jpg), plus explicit failure messages when media data can’t be found. - 🕒 **Resilience-focused execution**: Includes delays between requests to keep runs stable during larger batches (helpful when you’re saving Threads video or Threads post images at scale). *** ### Best use cases - 🚀 **Content repurposing teams**: Download Threads photos or videos with resolution-aware metadata to speed up sourcing for creatives. - 🧑‍💼 **Influencer marketers**: Save Threads video details and thumbnails for campaign previews and asset tracking across many posts. - 📚 **Digital researchers**: Build datasets of Threads media quality, sizes, and captions from publicly available sources for analysis. - 📈 **Data analysts**: Use structured JSON fields like `like_count`, `width`, `height`, and `type` (image/video; single/carousel) for reporting. - 🗂️ **Media operations**: Automate saving Threads post media URL downloads into a database-backed pipeline for later retrieval. - 🧪 **Growth and A/B testing teams**: Quickly compare media quality characteristics (resolution/quality labels) across posts to inform strategy. - 💻 **Developer pipelines**: Integrate the actor into workflows that need a consistent `medias` array output for downstream processing. *** ### Technical specifications - **Supported Input Formats** - ✅ `urls`: array of Threads post URLs (Strings) - **Proxy Support** - ✅ Configurable via `proxyConfiguration` - ✅ `proxyConfiguration.proxy support` (default is `true`) - **Retry Mechanism** - ✅ Includes resilience-focused behaviors to handle real-world scraping issues - **Dataset Structure** - ✅ Each input URL produces a result object pushed to the dataset (`charged_event_name="result"`) - ✅ Success payload includes `result.medias`, `result.type`, `result.thumbnail`, and `result.time_end` - ✅ Failure payload includes `result.error: true` and a `result.message` - **Rate Limits & Performance** - ✅ Processes URLs with a built-in delay between requests to support stable batch runs - **Limitations** - ❌ If media data cannot be found, the actor returns `result.error: true` with `result.message` *** ### FAQ #### What does Threads Post Media Downloader return? ✅ It returns a JSON result per input Threads post URL. Successful outputs include a `result` object with fields like `source`, `pk`, `id`, `title`, `like_count`, `thumbnail`, `medias`, `type` (`single` or `carousel`), and `time_end` for video timing when available. #### Can it download Threads photos and videos? ✅ Yes. The actor selects the best available image candidate for image posts and the best selected video media for video posts. Each media item includes `type` (`image` or `video`) and the `extension` (`jpg` for images, `mp4` for videos). #### Does it handle carousel posts? ✅ Yes. If carousel media exists, the output uses `result.type` = `carousel` and returns multiple items inside `result.medias`. #### What should I put in the `urls` input? ✅ Add an array of Threads post URLs as Strings. The actor processes each URL from your list and pushes results to the dataset. #### How do proxies work in this actor? ✅ You can provide a `proxyConfiguration` object with `proxy support`. The default in the schema is `true`. If you don’t set it, proxy configuration is not applied. #### What happens if the actor can’t find media data? ❌ The actor pushes a failure payload where `result.error` is `true` and `result.message` explains what went wrong (for example: it can’t find media data). #### Is any authentication required? ❌ No. The actor is designed to extract publicly available media metadata from Threads.net posts based on the URLs you provide. *** ### Support & feature requests Want to improve this Threads post media downloader or make it even better for download Threads photos / download Threads videos workflows? 💡 - 💡 **Feature Requests**: Share ideas like better export mapping for `medias`, additional media fields, or enhanced dataset structure. - 📧 **Contact**: Email . Your feedback helps shape future updates to Threads Post Media Downloader 🧵. *** ### *Threads Post Media Downloader 🧵* — Final thoughts *This SEO-optimized Threads post media downloader is designed for practical, structured extraction of Threads media—so you can save Threads post images, video, and carousel media at scale with confidence.* # Actor input Schema ## `urls` (type: `array`): List of Threads post URLs to scrape. ## `proxyConfiguration` (type: `object`): Select proxies to be used by your crawler. ## Actor input object example ```json { "urls": [ "https://www.threads.net/@shams/post/DFntiSvSsNq" ], "proxyConfiguration": { "useApifyProxy": true } } ``` # 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 = { "urls": [ "https://www.threads.net/@shams/post/DFntiSvSsNq" ] }; // Run the Actor and wait for it to finish const run = await client.actor("solid-scraper/threads-post-media-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 = { "urls": ["https://www.threads.net/@shams/post/DFntiSvSsNq"] } # Run the Actor and wait for it to finish run = client.actor("solid-scraper/threads-post-media-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 '{ "urls": [ "https://www.threads.net/@shams/post/DFntiSvSsNq" ] }' | apify call solid-scraper/threads-post-media-downloader --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=solid-scraper/threads-post-media-downloader", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Threads Post Media Downloader", "description": "🚀 Download media from Threads effortlessly with Threads Post Media Downloader. Save photos & videos in seconds, fast and reliable. 📥✨ Perfect for creators, marketers, and social media teams. Try it today! 🛠️", "version": "0.1", "x-build-id": "O5hfOSeXvBRXCMYfJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solid-scraper~threads-post-media-downloader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solid-scraper-threads-post-media-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/solid-scraper~threads-post-media-downloader/runs": { "post": { "operationId": "runs-sync-solid-scraper-threads-post-media-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/solid-scraper~threads-post-media-downloader/run-sync": { "post": { "operationId": "run-sync-solid-scraper-threads-post-media-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", "properties": { "urls": { "title": "Threads Post URLs", "type": "array", "description": "List of Threads post URLs to scrape.", "items": { "type": "string" } }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Select proxies to be used by your crawler.", "default": { "useApifyProxy": 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 } } } } } } } } } } ```