# Threads Scraper — Bài viết, Hồ sơ, Hashtag & Tìm kiếm từ khóa (`claude_code_reviewer/threads-scraper-vi`) Actor Năm chế độ trích xuất Threads trong một actor: hồ sơ người dùng, hashtag, tìm kiếm từ khóa, bài viết đơn lẻ kèm phản hồi, và feed tùy chỉnh. Dán hàng loạt tối đa 100 username hoặc từ khóa, bộ lọc ngày tương đối, chỉ số tương tác, timestamp ISO. Không cần đăng nhập. $0.005 mỗi kết quả. - **URL**: https://apify.com/claude\_code\_reviewer/threads-scraper-vi.md - **Developed by:** [Reggie](https://apify.com/claude_code_reviewer) (community) - **Categories:** AI, SEO tools, Social media - **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing $5.00 / 1,000 results 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 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 Scraper — Lấy dữ liệu bài viết, hồ sơ, hashtag & tìm kiếm từ khóa 🔥 Thu thập dữ liệu Threads chỉ trong vài phút — **không cần đăng nhập / API key**. Một công cụ **all-in-one** giúp bạn thu thập dữ liệu Threads một cách nhanh chóng và dễ dàng:  * 👤 Hồ sơ người dùng * 🏷️ Hashtag / chủ đề * 🔎 Tìm kiếm từ khóa * 💬 Bài viết + phản hồi * 📰 Feed tùy chỉnh 👉 Hỗ trợ batch lên đến **100 username hoặc keyword mỗi lần** 👉 Trải nghiệm miễn phí 👉 Chỉ $0.005 / mỗi kết quả  Phù hợp cho: marketer, researcher, developer SaaS, team social listening và data analytics. --- ### 📦 Dữ liệu bạn nhận được #### 📝 Với mỗi bài viết * `postId`, `postUrl`, `content` * `publishedAt`, `publishedAtISO` * `mediaType` (`text`, `photo`, `video`, `carousel`) * `mediaUrls[]` * Chỉ số tương tác: * `likeCount` * `replyCount` * `repostCount` * `shareCount` * `viewCount` * `quoteCount` * `sourceType`, `sourceQuery` * `scrapedAt` * `threadParts[]` (tự động gộp thread nhiều phần) --- #### 👤 Với tác giả * `author` --- #### 💬 Với phản hồi (mode `post`) * `replies[]` — tối đa 20 phản hồi hàng đầu 👉 Tất cả field đều bằng tiếng Anh → dễ dàng tích hợp vào pipeline và các công cụ downstream --- ### ⚙️ 5 chế độ — 1 tool duy nhất | Mode | Mô tả | Input | | ----------- | ------------------------------ | --------------------------- | | 👤 User | Lấy bài từ hồ sơ user | `usernames[]` | | 🏷️ Hashtag | Lấy dữ liệu từ hashtag / topic | `keywords[]` | | 🔎 Search | Tìm bài theo keyword | `keywords[]` + `searchSort` | | 💬 Post | Lấy 1 bài + replies | `postUrls[]` | | 📰 Feed | Lấy từ feed bất kỳ | `feedUrls[]` | 👉 Không cần dùng nhiều công cụ scraper khác — tất cả trong một công cụ duy nhất. --- ### 📥 Input | Trường | Kiểu | Bắt buộc | Mặc định | Mô tả | | --------------- | -------- | -------------- | -------- | ---------------------------------------------- | | `mode` | enum | khuyến nghị | `user` | `user`, `hashtag`, `search`, `post`, `feed` | | `usernames` | string[] | user mode | — | Username (không cần `@`) | | `bulkUsernames` | string | optional | — | Dán danh sách username (mỗi dòng một username) | | `keywords` | string[] | hashtag/search | — | Từ khóa hoặc hashtag | | `bulkKeywords` | string | optional | — | Dán keyword hàng loạt | | `postUrls` | string[] | post mode | — | URL bài Threads | | `feedUrls` | string[] | feed mode | — | URL feed | | `searchSort` | enum | optional | `top` | `top` hoặc `recent` | | `dateFrom` | string | optional | — | `YYYY-MM-DD` hoặc `7 days`, `1 month` | | `dateTo` | string | optional | — | giống `dateFrom` | | `maxPosts` | number | optional | `50` | Số bài tối đa / nguồn | --- ### 🔥 Ví dụ sử dụng #### 👤 Scrape user ```json { "mode": "user", "usernames": ["zuck", "mosseri"], "maxPosts": 50 } ```` *** #### 🏷️ Scrape hashtag ```json { "mode": "hashtag", "keywords": ["#AI"], "dateFrom": "1 month", "maxPosts": 200 } ``` *** #### 🔎 Search keyword (recent) ```json { "mode": "search", "keywords": ["LLM agent"], "searchSort": "recent", "dateFrom": "7 days" } ``` *** #### 💬 Scrape 1 post + replies ```json { "mode": "post", "postUrls": ["https://www.threads.com/@zuck/post/ABC123"] } ``` *** ### ⚠️ Lưu ý - `maxPosts` là giới hạn tối đa — không đảm bảo đủ số lượng - Dữ liệu tương tác (like, view…) có thể là **ước lượng** - Chỉ trích xuất **dữ liệu công khai** (không cần đăng nhập / API key) - Mode `post` mới có replies (~20 phản hồi đầu) - Thread nhiều phần sẽ được **tự động gộp** *** ### 🤔 FAQ #### Có cần @ hoặc URL không? Không. Chỉ cần `zuck` là đủ. *** #### Tại sao không đủ số bài? Có thể do: - Account ít post - Hashtag nhỏ - Threads không còn hiển thị thêm kết quả mới *** #### Field bị null là lỗi? Không. Đây là giới hạn dữ liệu từ phía Threads, không phải lỗi của tool. *** ### 🆚 So với API Threads chính thức API Threads của Meta: - ❌ Chỉ dùng cho tài khoản của bạn - ❌ Không scrape đối thủ / hashtag - ❌ Cần OAuth + review app Với tool này: - ✅ Lấy dữ liệu công khai - ✅ Không cần đăng nhập / API key - ✅ Setup cực nhanh *** ### ⚖️ Disclaimer Công cụ chỉ thu thập dữ liệu công khai trên Threads. Không truy cập tài khoản private hoặc vượt qua authentication. Người dùng cần đảm bảo tuân thủ: - GDPR - CCPA - Điều khoản dịch vụ của Meta *** ### 🔑 Keywords Threads scraper · Threads API alternative · hashtag scraper · keyword search · social listening · influencer analytics · competitor tracking · marketing data # Actor input Schema ## `mode` (type: `string`): Bạn muốn scrape gì? Chọn một chế độ và điền vào phần tương ứng bên dưới. ## `usernames` (type: `array`): Username Threads thuần (không cần @, không cần URL). Ví dụ: zuck, mosseri. Dùng khi Chế độ = User. ## `bulkUsernames` (type: `string`): **Mỗi dòng một username**, nhấn Enter giữa các dòng. **Không dấu nháy, không dấu phẩy.** Ví dụ: ``` zuck mosseri finkd ``` Bạn có thể copy một cột từ Google Sheets / Excel và dán thẳng vào đây. Sẽ được gộp vào danh sách Username khi chạy. ## `keywords` (type: `array`): Từ khóa cho chế độ Tìm kiếm, hoặc hashtag cho chế độ Hashtag (dấu # ở đầu tùy chọn). Ví dụ: tin AI, #côngnghệ. ## `bulkKeywords` (type: `string`): **Mỗi dòng một từ khóa hoặc hashtag**, nhấn Enter giữa các dòng. **Không dấu nháy, không dấu phẩy.** Ví dụ: ``` LLM agent vibe coding #AI ``` Sẽ được gộp vào danh sách Từ khóa khi chạy. ## `searchSort` (type: `string`): Thứ tự sắp xếp kết quả tìm kiếm từ khóa. Chỉ áp dụng cho Chế độ = Tìm kiếm. ## `dateFrom` (type: `string`): Ngày cũ nhất của bài viết. Chấp nhận YYYY-MM-DD hoặc cách biểu đạt tương đối như "7 days", "1 month". ## `dateTo` (type: `string`): Ngày mới nhất của bài viết. Cùng định dạng với Ngày bắt đầu. ## `postUrls` (type: `array`): URL đầy đủ của bài viết Threads. Dùng khi Chế độ = Post. Ví dụ: https://www.threads.com/@user/post/ABC123. ## `feedUrls` (type: `array`): URL feed tùy chỉnh của Threads. Dùng khi Chế độ = Feed. Ví dụ: https://www.threads.com/custom\_feed/18113589370710265. ## `maxPosts` (type: `integer`): Số bài viết tối đa trên mỗi nguồn. Càng nhiều thì càng nhiều kết quả tính phí ($0.005 mỗi bài). Cuộn trang được quản lý tự động. ## Actor input object example ```json { "mode": "user", "usernames": [ "zuck" ], "searchSort": "top", "maxPosts": 50 } ``` # 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 = { "mode": "user", "usernames": [ "zuck" ] }; // Run the Actor and wait for it to finish const run = await client.actor("claude_code_reviewer/threads-scraper-vi").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 = { "mode": "user", "usernames": ["zuck"], } # Run the Actor and wait for it to finish run = client.actor("claude_code_reviewer/threads-scraper-vi").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 '{ "mode": "user", "usernames": [ "zuck" ] }' | apify call claude_code_reviewer/threads-scraper-vi --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=claude_code_reviewer/threads-scraper-vi", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ````json { "openapi": "3.0.1", "info": { "title": "Threads Scraper — Bài viết, Hồ sơ, Hashtag & Tìm kiếm từ khóa", "description": "Năm chế độ trích xuất Threads trong một actor: hồ sơ người dùng, hashtag, tìm kiếm từ khóa, bài viết đơn lẻ kèm phản hồi, và feed tùy chỉnh. Dán hàng loạt tối đa 100 username hoặc từ khóa, bộ lọc ngày tương đối, chỉ số tương tác, timestamp ISO. Không cần đăng nhập. $0.005 mỗi kết quả.", "version": "1.0", "x-build-id": "6aUSriBOtMho3EElX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/claude_code_reviewer~threads-scraper-vi/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-claude_code_reviewer-threads-scraper-vi", "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/claude_code_reviewer~threads-scraper-vi/runs": { "post": { "operationId": "runs-sync-claude_code_reviewer-threads-scraper-vi", "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/claude_code_reviewer~threads-scraper-vi/run-sync": { "post": { "operationId": "run-sync-claude_code_reviewer-threads-scraper-vi", "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": { "mode": { "title": "🎯 Chế độ", "enum": [ "user", "hashtag", "search", "post", "feed" ], "type": "string", "description": "Bạn muốn scrape gì? Chọn một chế độ và điền vào phần tương ứng bên dưới.", "default": "user" }, "usernames": { "title": "👤 Danh sách username", "maxItems": 100, "uniqueItems": true, "type": "array", "description": "Username Threads thuần (không cần @, không cần URL). Ví dụ: zuck, mosseri. Dùng khi Chế độ = User.", "items": { "type": "string" } }, "bulkUsernames": { "title": "📋 Dán username hàng loạt", "type": "string", "description": "**Mỗi dòng một username**, nhấn Enter giữa các dòng. **Không dấu nháy, không dấu phẩy.** Ví dụ:\n\n```\nzuck\nmosseri\nfinkd\n```\n\nBạn có thể copy một cột từ Google Sheets / Excel và dán thẳng vào đây. Sẽ được gộp vào danh sách Username khi chạy." }, "keywords": { "title": "🏷️ Từ khóa / Tag", "maxItems": 100, "uniqueItems": true, "type": "array", "description": "Từ khóa cho chế độ Tìm kiếm, hoặc hashtag cho chế độ Hashtag (dấu # ở đầu tùy chọn). Ví dụ: tin AI, #côngnghệ.", "items": { "type": "string" } }, "bulkKeywords": { "title": "📋 Dán từ khóa hàng loạt", "type": "string", "description": "**Mỗi dòng một từ khóa hoặc hashtag**, nhấn Enter giữa các dòng. **Không dấu nháy, không dấu phẩy.** Ví dụ:\n\n```\nLLM agent\nvibe coding\n#AI\n```\n\nSẽ được gộp vào danh sách Từ khóa khi chạy." }, "searchSort": { "title": "🔀 Sắp xếp tìm kiếm", "enum": [ "top", "recent" ], "type": "string", "description": "Thứ tự sắp xếp kết quả tìm kiếm từ khóa. Chỉ áp dụng cho Chế độ = Tìm kiếm.", "default": "top" }, "dateFrom": { "title": "📅 Ngày bắt đầu", "type": "string", "description": "Ngày cũ nhất của bài viết. Chấp nhận YYYY-MM-DD hoặc cách biểu đạt tương đối như \"7 days\", \"1 month\"." }, "dateTo": { "title": "📅 Ngày kết thúc", "type": "string", "description": "Ngày mới nhất của bài viết. Cùng định dạng với Ngày bắt đầu." }, "postUrls": { "title": "💬 URL bài viết", "uniqueItems": true, "type": "array", "description": "URL đầy đủ của bài viết Threads. Dùng khi Chế độ = Post. Ví dụ: https://www.threads.com/@user/post/ABC123.", "items": { "type": "string" } }, "feedUrls": { "title": "📰 URL feed", "uniqueItems": true, "type": "array", "description": "URL feed tùy chỉnh của Threads. Dùng khi Chế độ = Feed. Ví dụ: https://www.threads.com/custom_feed/18113589370710265.", "items": { "type": "string" } }, "maxPosts": { "title": "📊 Số bài tối đa", "minimum": 1, "maximum": 500, "type": "integer", "description": "Số bài viết tối đa trên mỗi nguồn. Càng nhiều thì càng nhiều kết quả tính phí ($0.005 mỗi bài). Cuộn trang được quản lý tự động.", "default": 50 } } }, "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 } } } } } } } } } } ````