# Threads Profiles, Posts & Insights Scraper (`brilliant_gum/threads-insights-scraper`) Actor Scrape Threads profiles, posts and engagement metrics with input-time filters (verified, min likes, follower threshold, language, keywords). Extract emails, phones and contact links from bios. Track follower growth across scheduled runs. Lead-gen ready. - **URL**: https://apify.com/brilliant\_gum/threads-insights-scraper.md - **Developed by:** [Yuliia Kulakova](https://apify.com/brilliant_gum) (community) - **Categories:** Lead generation, Social media, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $15.00 / 1,000 entity scrapeds 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 Profiles, Posts & Insights Scraper The complete Threads (Meta) data extractor for marketers, recruiters, lead-gen teams, content creators and analysts. Pull **profile metadata**, **recent posts**, **engagement metrics**, **contact info from bios**, and **historical follower growth** — with input-time filters so you only pay for entities that match. A drop-in upgrade over the existing Threads scrapers on Apify Store: same inputs work, plus everything competitors don't ship. ![banner](https://i.imgur.com/pwRB3YY.png) --- ### What you get | | | |---|---| | **Profile metadata** | Username, full name, bio, verified status, follower count, profile picture (HD), external links | | **Recent posts** | Up to 15 most-recent posts per profile with text, media (images + videos), likes, replies, reposts, quote count, timestamp | | **Carousel media** | Multi-image and multi-video carousels surfaced as flat media arrays | | **Lead-gen contact info** | Emails, phone numbers, payment links (PayPal, Cash App, Venmo), aggregators (Linktree, Beacons), website, and 20+ social platforms categorised (Instagram, TikTok, YouTube, Substack, etc.) | | **Engagement filters at input** | Verified-only, min likes / replies / reposts, min author followers, has-media, has-links, language, date range, include/exclude keywords. **No other Threads scraper on Apify offers these — you only pay for matching entities.** | | **Analytics block** | Per-profile engagement rate, virality index, average likes/replies/reposts, top-post likes — auto-computed | | **Historical trend tracking** | Persisted snapshots + automatic deltas (followers change, follower growth per day, trend up/down/flat) across scheduled runs | | **Multi-format export** | JSON, CSV, Excel, XML, HTML straight from Apify dataset | Works out of the box — proxies included, no configuration required. --- ### Use cases - **Lead-gen / SDR** — pull contact info (emails, socials, websites) from creator bios for cold outreach - **Recruiters** — find verified creators in a niche, with follower thresholds and engagement filters - **Music / A&R / brand marketers** — track artist or influencer follower growth daily, spot momentum early - **Agencies** — scout competitor accounts, monitor posting cadence, track engagement benchmarks - **Content strategists** — find top-performing posts in a niche by likes/replies, reverse-engineer hooks - **Analysts / journalists** — exact public engagement numbers with provenance, ready for dashboards - **Brand monitoring** — keyword-trigger filter for mentions of your brand across Threads creators --- ### Quick start Paste a Threads URL and run — that's the minimum input: ```json { "urls": ["https://www.threads.net/@zuck"] } ```` You get one profile record (Mark Zuckerberg: 5.5M followers, full bio, verified, external links, contact info, analytics) plus the most recent 8-15 posts with full engagement metrics. *** ### Common inputs **Multiple profiles in one run:** ```json { "urls": [ "https://www.threads.net/@zuck", "https://www.threads.net/@mosseri", "https://www.threads.net/@garyvee" ], "maxPostsPerProfile": 10 } ``` **Lead-gen sweep — verified profiles with 1M+ followers + contact info:** ```json { "urls": [ "https://www.threads.net/@garyvee", "https://www.threads.net/@mosseri" ], "verifiedOnly": true, "minAuthorFollowers": 1000000, "includeContactInfo": true, "includePosts": false } ``` **Find viral content in a niche (≥1000 likes, AI keywords):** ```json { "urls": ["https://www.threads.net/@zuck"], "minLikes": 1000, "keywordsInclude": ["ai", "superintelligence"], "maxPostsPerProfile": 50 } ``` **Historical trend tracking — schedule daily:** ```json { "urls": ["https://www.threads.net/@zuck"], "enableHistory": true, "historyDatasetName": "my-threads-tracking" } ``` From the second scheduled run onwards every record carries a `history.delta` block with `followersChange`, `followerGrowthPerDay`, and a `trend` (`up` / `down` / `flat`). **Bare usernames (CSV-friendly):** ```json { "usernames": ["zuck", "mosseri", "garyvee"] } ``` *** ### Inputs reference #### Targeting | Field | Type | Default | Description | |---|---|---|---| | `urls` | array | — | Threads URLs (`threads.net/@user`) or `@username` form | | `usernames` | array | — | Bare usernames (convenient for CSV lists) | | `postUrls` | array | — | Specific post URLs | | `includePosts` | boolean | true | Include the profile's recent posts | | `maxPostsPerProfile` | int | 50 | Cap on posts per profile (initial feed returns 5-15) | #### Engagement filters (paid only if matched) | Field | Type | Default | Description | |---|---|---|---| | `verifiedOnly` | boolean | false | Skip non-verified authors | | `minAuthorFollowers` | int | 0 | Skip authors below this follower count | | `excludePrivate` | boolean | true | Skip private accounts | | `minLikes` | int | 0 | Skip posts below this like count | | `minReplies` | int | 0 | Skip posts below this reply count | | `minReposts` | int | 0 | Skip posts below this repost count | | `hasMedia` | enum | any | `any` / `yes` / `no` | | `hasLinks` | enum | any | `any` / `yes` / `no` | | `language` | array | — | Two-letter language codes (e.g. `en`, `es`) | | `dateFrom` / `dateTo` | string | — | ISO date or YYYY-MM-DD | | `keywordsInclude` | array | — | Must contain at least one keyword (case-insensitive) | | `keywordsExclude` | array | — | Must NOT contain any keyword | | `excludeReplies` | boolean | false | Drop reply posts, keep originals | #### Enrichment | Field | Type | Default | Description | |---|---|---|---| | `includeContactInfo` | boolean | **true** | Emails / phones / socials / website from bios | | `includeAnalytics` | boolean | **true** | Engagement rate, virality, top-post stats | | `enableHistory` | boolean | false | Persist snapshots + compute deltas | | `historyDatasetName` | string | `threads-history` | Named store reused across scheduled runs | #### Performance | Field | Type | Default | Description | |---|---|---|---| | `proxyConfiguration` | object | auto | Optional. Proxies are included by default — leave empty unless overriding | | `maxConcurrency` | int | 3 | Parallel workers | | `minDelayMs` | int | 1000 | Throttle between requests | *** ### Output Every record carries `type`, `id`, `url`, `username`, `scrapedAt`, plus type-specific fields. **Profile record:** `fullName`, `bio`, `verified`, `followers`, `profilePicUrl`, `profilePicUrlHd`, `externalLinks[]`, `topPosts[]` (top 5 by likes), plus `contactInfo`, `analytics`, `history` blocks when enabled. **Post record:** `text`, `createdAt`, `likeCount`, `replyCount`, `repostCount`, `quoteCount`, `media[]` (images + videos with dimensions), `hashtags[]`, `mentions[]`, `urls[]`, `language`, plus a lightweight `author` (id, username, verified). #### Analytics block ```json { "engagementRate": 0.00087, "viralityIndex": 2.48, "avgLikesPerPost": 1326, "avgRepliesPerPost": 589, "avgRepostsPerPost": 86, "totalLikes": 10605, "topPostLikes": 3289, "momentum": { "followerGrowthPerDay": 72, "trend": "up" } } ``` #### Contact info block ```json { "emails": ["hello@example.com"], "phones": ["+15551234567"], "website": "https://garyvee.com/attention", "socials": { "instagram": "https://instagram.com/...", "tiktok": "https://tiktok.com/@...", "youtube": "https://youtube.com/..." }, "paymentLinks": { "paypal": "https://paypal.me/...", "cashapp": "https://cash.app/..." }, "aggregator": "https://linktr.ee/..." } ``` #### History block (with `enableHistory`) ```json { "firstSeen": "2026-06-01T00:00:00Z", "snapshotCount": 14, "previous": { "at": "...", "followers": 5524475 }, "delta": { "daysElapsed": 1.0, "followersChange": 1250, "followerGrowthPerDay": 1250, "trend": "up" }, "series": [ { "at": "...", "followers": 5523225 } ] } ``` *** ### Pricing Simple pay-per-event: | Event | Cost | |---|---| | Actor start | $0.01 | | Each scraped entity (profile or post) | $0.015 | **Example runs:** | What you scrape | Calculation | Cost | |---|---|---| | 1 profile + posts (~10 entities) | $0.01 + 10 × $0.015 | **$0.16** | | 10 profiles + posts (~110 entities) | $0.01 + 110 × $0.015 | **$1.66** | | 100 lead-gen profiles, no posts | $0.01 + 100 × $0.015 | **$1.51** | | 500 daily monitoring profiles | $7.51 / run × 30 days | **~$225 / month** | | 1,000 entities (bulk profile sweep) | $0.01 + 1,000 × $0.015 | **$15.01** | Compare: Phantom Buster charges $0.15-0.20 per LinkedIn profile (~10× more). Cognism is $1,000+/mo subscription. We're per-use, no commitment. *** ### FAQ **Does this work without configuration?** Yes. Paste a Threads URL and run. Proxies are included. **How many posts do I get per profile?** The initial feed returns 5-15 most-recent posts per profile, which covers the typical "what's this creator posting" use case. Deep historical pagination (hundreds of posts) is not currently supported — Meta restricts this for anonymous access. **Can I get followers / following lists?** Not currently. These lists are behind a Meta login wall. They're on the roadmap for v2 with optional cookie support. **Do contact details come from every profile?** Only when they're publicly listed in the bio or external links. The actor extracts what's there — it doesn't make guesses. About 30-50% of creator accounts publicly expose at least one contact channel. **What happens with profiles I can't access?** A small share of very large or geo-restricted accounts (~10-20%) return a login wall when accessed from any non-cookied session. The actor logs them and moves on — you only pay for entities successfully scraped. **Will repeated runs over-charge me for the same profile?** Each run is metered independently — daily scheduled runs of the same 100 profiles is 100 billable entities per run. The history store deduplicates time-series points so trend data stays clean. **Can I export to CSV / Excel?** Yes. Apify automatically offers CSV, JSON, Excel, XML and HTML on every dataset. **Are the engagement filters applied before billing?** Yes. If a post fails your `minLikes` / `verifiedOnly` / language / date filter, it's never written to the dataset and you don't pay for it. This is one of our headline features — no competitor on Apify Store offers input-time filtering. **How fresh is the data?** Real-time per request — the actor reads Threads' public feed at run time. **What's the difference vs other Threads scrapers on Apify?** Most competitors return raw post dumps; we add input-time engagement filters, bio contact extraction (lead-gen ready), per-profile analytics (engagement rate, virality, momentum) and historical follower-growth tracking. No other Threads scraper on Apify ships these. *** ### Legal This actor scrapes only publicly available Threads data. It is **not affiliated with, endorsed by, or sponsored by Meta or Threads**. Use responsibly and respect Meta's Terms of Service and applicable laws. *** Maintained by **brilliant\_gum** on Apify. # Actor input Schema ## `urls` (type: `array`): Profile or post URLs from threads.net / threads.com. Accepts both full URLs and @username form. Leave empty if you use 'Usernames' or 'Post URLs' instead. ## `usernames` (type: `array`): Bare usernames (without @) — convenient when you have a CSV list. ## `postUrls` (type: `array`): Specific post URLs whose replies you want to analyse. Same format as 'Threads URLs'. ## `includePosts` (type: `boolean`): For each profile, fetch their recent posts (paginated). Disable if you only need profile metadata. ## `maxPostsPerProfile` (type: `integer`): Hard limit on posts fetched per profile. ## `includeReplies` (type: `boolean`): For posts (single-post URLs or first posts of profiles), also fetch the nested reply tree. ## `maxReplyDepth` (type: `integer`): How deep to walk the reply tree. 0 = no replies, 1 = top-level only, 2 = nested. ## `verifiedOnly` (type: `boolean`): Drop posts whose authors are not verified. ## `minAuthorFollowers` (type: `integer`): Skip authors with fewer than this many followers. Killer filter for lead-gen — pay only for accounts above your threshold. ## `excludePrivate` (type: `boolean`): Private accounts return no posts anyway — set to true to skip them entirely. ## `minLikes` (type: `integer`): Skip posts with fewer likes than this. ## `minReplies` (type: `integer`): Skip posts with fewer replies than this. ## `minReposts` (type: `integer`): Skip posts with fewer reposts than this. ## `hasMedia` (type: `string`): Keep only posts with (or without) attached image/video. ## `hasLinks` (type: `string`): Keep only posts with (or without) outbound links in the text. ## `language` (type: `array`): Two-letter language codes to keep (e.g. en, es, pt). Empty = all languages. ## `dateFrom` (type: `string`): ISO date or YYYY-MM-DD. Drop posts older than this. ## `dateTo` (type: `string`): ISO date or YYYY-MM-DD. Drop posts newer than this. ## `keywordsInclude` (type: `array`): Drop posts whose text doesn't contain at least one of these keywords (case-insensitive). ## `keywordsExclude` (type: `array`): Drop posts whose text contains any of these keywords. ## `excludeReplies` (type: `boolean`): Drop posts that are replies to someone else (keep only originals). ## `includeContactInfo` (type: `boolean`): Parse emails, phones, payment links and categorize social/website links from bios. Lead-gen killer feature. ## `includeAnalytics` (type: `boolean`): Per-profile engagement rate, virality index, like-to-view ratio, and momentum (when history is on). ## `enableHistory` (type: `boolean`): Persist a timestamped snapshot every run into a named store, then compute deltas (follower growth, post velocity) vs the previous run. Schedule the actor daily/weekly to build the time-series. ## `historyDatasetName` (type: `string`): Named key-value store to persist snapshots into. Reused across scheduled runs to compute trends. ## `proxyConfiguration` (type: `object`): Optional. Proxies are included and configured automatically — leave empty unless overriding. ## `maxConcurrency` (type: `integer`): Parallel worker count. Threads is sensitive — keep low (2-4). ## `minDelayMs` (type: `integer`): Throttle to look human and avoid rate limits. ## Actor input object example ```json { "urls": [ "https://www.threads.net/@zuck", "https://threads.net/@zuck/post/Cu5VnIfNuq8", "@yulia" ], "usernames": [ "zuck", "mosseri", "yulia" ], "postUrls": [ "https://www.threads.net/@zuck/post/Cu5VnIfNuq8" ], "includePosts": true, "maxPostsPerProfile": 50, "includeReplies": false, "maxReplyDepth": 2, "verifiedOnly": false, "minAuthorFollowers": 0, "excludePrivate": true, "minLikes": 0, "minReplies": 0, "minReposts": 0, "hasMedia": "any", "hasLinks": "any", "language": [ "en", "es" ], "keywordsInclude": [ "ai", "startup" ], "keywordsExclude": [ "spam", "giveaway" ], "excludeReplies": false, "includeContactInfo": true, "includeAnalytics": true, "enableHistory": false, "historyDatasetName": "threads-history", "maxConcurrency": 3, "minDelayMs": 1000 } ``` # Actor output Schema ## `summary` (type: `string`): Counts of scraped entities and pointers to the dataset and history KV store. # 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/@zuck" ] }; // Run the Actor and wait for it to finish const run = await client.actor("brilliant_gum/threads-insights-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 = { "urls": ["https://www.threads.net/@zuck"] } # Run the Actor and wait for it to finish run = client.actor("brilliant_gum/threads-insights-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 '{ "urls": [ "https://www.threads.net/@zuck" ] }' | apify call brilliant_gum/threads-insights-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=brilliant_gum/threads-insights-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Threads Profiles, Posts & Insights Scraper", "description": "Scrape Threads profiles, posts and engagement metrics with input-time filters (verified, min likes, follower threshold, language, keywords). Extract emails, phones and contact links from bios. Track follower growth across scheduled runs. Lead-gen ready.", "version": "1.0", "x-build-id": "nx8FZptgeTsWScELr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/brilliant_gum~threads-insights-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-brilliant_gum-threads-insights-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/brilliant_gum~threads-insights-scraper/runs": { "post": { "operationId": "runs-sync-brilliant_gum-threads-insights-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/brilliant_gum~threads-insights-scraper/run-sync": { "post": { "operationId": "run-sync-brilliant_gum-threads-insights-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": { "urls": { "title": "Threads URLs", "type": "array", "description": "Profile or post URLs from threads.net / threads.com. Accepts both full URLs and @username form. Leave empty if you use 'Usernames' or 'Post URLs' instead.", "items": { "type": "string" } }, "usernames": { "title": "Usernames", "type": "array", "description": "Bare usernames (without @) — convenient when you have a CSV list.", "items": { "type": "string" } }, "postUrls": { "title": "Post URLs (replies focus)", "type": "array", "description": "Specific post URLs whose replies you want to analyse. Same format as 'Threads URLs'.", "items": { "type": "string" } }, "includePosts": { "title": "Include user posts", "type": "boolean", "description": "For each profile, fetch their recent posts (paginated). Disable if you only need profile metadata.", "default": true }, "maxPostsPerProfile": { "title": "Max posts per profile", "minimum": 1, "maximum": 500, "type": "integer", "description": "Hard limit on posts fetched per profile.", "default": 50 }, "includeReplies": { "title": "Include reply tree", "type": "boolean", "description": "For posts (single-post URLs or first posts of profiles), also fetch the nested reply tree.", "default": false }, "maxReplyDepth": { "title": "Max reply depth", "minimum": 0, "maximum": 5, "type": "integer", "description": "How deep to walk the reply tree. 0 = no replies, 1 = top-level only, 2 = nested.", "default": 2 }, "verifiedOnly": { "title": "Verified profiles only", "type": "boolean", "description": "Drop posts whose authors are not verified.", "default": false }, "minAuthorFollowers": { "title": "Min author followers", "minimum": 0, "type": "integer", "description": "Skip authors with fewer than this many followers. Killer filter for lead-gen — pay only for accounts above your threshold.", "default": 0 }, "excludePrivate": { "title": "Exclude private accounts", "type": "boolean", "description": "Private accounts return no posts anyway — set to true to skip them entirely.", "default": true }, "minLikes": { "title": "Min likes per post", "minimum": 0, "type": "integer", "description": "Skip posts with fewer likes than this.", "default": 0 }, "minReplies": { "title": "Min replies per post", "minimum": 0, "type": "integer", "description": "Skip posts with fewer replies than this.", "default": 0 }, "minReposts": { "title": "Min reposts per post", "minimum": 0, "type": "integer", "description": "Skip posts with fewer reposts than this.", "default": 0 }, "hasMedia": { "title": "Has media filter", "enum": [ "any", "yes", "no" ], "type": "string", "description": "Keep only posts with (or without) attached image/video.", "default": "any" }, "hasLinks": { "title": "Has links filter", "enum": [ "any", "yes", "no" ], "type": "string", "description": "Keep only posts with (or without) outbound links in the text.", "default": "any" }, "language": { "title": "Language allow-list", "type": "array", "description": "Two-letter language codes to keep (e.g. en, es, pt). Empty = all languages.", "items": { "type": "string" } }, "dateFrom": { "title": "Earliest post date", "type": "string", "description": "ISO date or YYYY-MM-DD. Drop posts older than this." }, "dateTo": { "title": "Latest post date", "type": "string", "description": "ISO date or YYYY-MM-DD. Drop posts newer than this." }, "keywordsInclude": { "title": "Must contain keywords", "type": "array", "description": "Drop posts whose text doesn't contain at least one of these keywords (case-insensitive).", "items": { "type": "string" } }, "keywordsExclude": { "title": "Must NOT contain keywords", "type": "array", "description": "Drop posts whose text contains any of these keywords.", "items": { "type": "string" } }, "excludeReplies": { "title": "Exclude reply posts", "type": "boolean", "description": "Drop posts that are replies to someone else (keep only originals).", "default": false }, "includeContactInfo": { "title": "Extract contact info (lead-gen)", "type": "boolean", "description": "Parse emails, phones, payment links and categorize social/website links from bios. Lead-gen killer feature.", "default": true }, "includeAnalytics": { "title": "Compute analytics block", "type": "boolean", "description": "Per-profile engagement rate, virality index, like-to-view ratio, and momentum (when history is on).", "default": true }, "enableHistory": { "title": "Enable historical tracking (trends & velocity)", "type": "boolean", "description": "Persist a timestamped snapshot every run into a named store, then compute deltas (follower growth, post velocity) vs the previous run. Schedule the actor daily/weekly to build the time-series.", "default": false }, "historyDatasetName": { "title": "History store name", "type": "string", "description": "Named key-value store to persist snapshots into. Reused across scheduled runs to compute trends.", "default": "threads-history" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Proxies are included and configured automatically — leave empty unless overriding." }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Parallel worker count. Threads is sensitive — keep low (2-4).", "default": 3 }, "minDelayMs": { "title": "Min delay between requests (ms)", "minimum": 200, "maximum": 10000, "type": "integer", "description": "Throttle to look human and avoid rate limits.", "default": 1000 } } }, "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 } } } } } } } } } } ```