# Threads Profiles & Recent Posts Scraper (`dami_studio/threads-scraper`) Actor Collect public Threads profiles and recent posts through a direct keyless HTTP path. Supports account-scoped keyword filtering, no login required. - **URL**: https://apify.com/dami\_studio/threads-scraper.md - **Developed by:** [Dami's Studio](https://apify.com/dami_studio) (community) - **Categories:** Social media, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $0.40 / 1,000 threads profile or posts This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 Profiles & Recent Posts Scraper Collect public Threads profiles and their latest public posts without a Threads login. It uses an HTTP-only direct path: Threads' crawler-facing profile metadata resolves the public profile, then the public profile-posts query returns recent posts. ### What it returns - `profile` rows: username, display name, public bio, approximate follower count, avatar URL, and public profile URL. - `post` rows: public text, likes, timestamp, canonical post URL, media URLs, and reply flag. - `diagnostic` rows: deterministic free rows for invalid input, blocking, rate limits, target errors, no matching posts, or no results. Only validated public `profile` and `post` rows are charged. Samples and diagnostics are never charged. ### Input ```json { "profiles": ["zuck", "https://www.threads.com/@instagram"], "maxPostsPerProfile": 10, "includeProfile": true, "query": "AI", "fallbackToResidential": false } ```` `query` filters posts from the supplied profiles. It is intentionally account-scoped: Threads does not provide a reliable anonymous global search path, so this Actor does not claim one. Leave `profiles` empty to receive one clearly labelled, uncharged sample profile row. ### Proxy behavior The Actor always tries direct HTTP first. When `fallbackToResidential` is enabled and a direct request is blocked, rate-limited, or has a transient network failure, it makes one bounded retry using the supplied Apify proxy configuration. It does not retry successful requests and does not use a proxy for media downloads. ### Pricing The Store event is `$0.0004` per genuine profile or post row, with no start fee. This is below the current observed Store floor of `$0.0005` per result. The post-pricing six-row cloud run `ppnrsMkFECXjL3PCR` cost `$0.00148904`; after Apify's 20% share, creator proceeds were `$0.00192`, leaving approximately `$0.00043096` profit and a 22.45% margin. Residential traffic was not used. ### Limits - Public profiles and public posts only. - `maxPostsPerProfile` is capped at 30 to keep costs and target load bounded. - Profile follower counts are approximate when Threads abbreviates them in public metadata. - Threads can change anonymous endpoints. A diagnostic row means no result was charged. Use public data in accordance with applicable law and Threads' terms. # Actor input Schema ## `profiles` (type: `array`): Public Threads handles or profile URLs. Leave empty for an uncharged sample row. ## `maxPostsPerProfile` (type: `integer`): Maximum genuine public posts saved for each supplied public profile. ## `query` (type: `string`): Optional case-insensitive text filter applied to posts from the supplied profiles. This is not a global Threads search. ## `includeProfile` (type: `boolean`): Save one public profile row for every successfully resolved handle. ## `fallbackToResidential` (type: `boolean`): Direct HTTP is always attempted first. When enabled, one blocked or transient request is retried through the supplied Apify proxy settings. ## `proxyConfiguration` (type: `object`): Used only for the one bounded fallback when fallbackToResidential is enabled. ## Actor input object example ```json { "profiles": [ "zuck", "instagram" ], "maxPostsPerProfile": 10, "includeProfile": true, "fallbackToResidential": false, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `dataset` (type: `string`): No description # 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 = { "profiles": [ "zuck" ] }; // Run the Actor and wait for it to finish const run = await client.actor("dami_studio/threads-scraper").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 = { "profiles": ["zuck"] } # Run the Actor and wait for it to finish run = client.actor("dami_studio/threads-scraper").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 '{ "profiles": [ "zuck" ] }' | apify call dami_studio/threads-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=dami_studio/threads-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Threads Profiles & Recent Posts Scraper", "description": "Collect public Threads profiles and recent posts through a direct keyless HTTP path. Supports account-scoped keyword filtering, no login required.", "version": "0.1", "x-build-id": "vxaB3Km7HzFCVJDdO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dami_studio~threads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dami_studio-threads-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/dami_studio~threads-scraper/runs": { "post": { "operationId": "runs-sync-dami_studio-threads-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/dami_studio~threads-scraper/run-sync": { "post": { "operationId": "run-sync-dami_studio-threads-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "profiles": { "title": "Threads profiles", "type": "array", "description": "Public Threads handles or profile URLs. Leave empty for an uncharged sample row.", "items": { "type": "string" } }, "maxPostsPerProfile": { "title": "Maximum recent posts per profile", "minimum": 1, "maximum": 30, "type": "integer", "description": "Maximum genuine public posts saved for each supplied public profile.", "default": 10 }, "query": { "title": "Optional account-scoped keyword filter", "type": "string", "description": "Optional case-insensitive text filter applied to posts from the supplied profiles. This is not a global Threads search." }, "includeProfile": { "title": "Include profile rows", "type": "boolean", "description": "Save one public profile row for every successfully resolved handle.", "default": true }, "fallbackToResidential": { "title": "Retry blocked requests with residential proxy", "type": "boolean", "description": "Direct HTTP is always attempted first. When enabled, one blocked or transient request is retried through the supplied Apify proxy settings.", "default": false }, "proxyConfiguration": { "title": "Optional Apify proxy configuration", "type": "object", "description": "Used only for the one bounded fallback when fallbackToResidential is enabled.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } } ```