# Threads Scraper - Posts, Profiles, Replies and Search (`nexuscortex/threads-scraper`) Actor

Threads scraper and unofficial Threads API. Scrape public Threads (Meta) posts, profiles, replies and keyword search results without login: text, likes, replies, reposts, quotes, media URLs and author details. Export to JSON, CSV or Excel.

- **URL**: https://apify.com/nexuscortex/threads-scraper.md
- **Developed by:** [Nexus Cortex](https://apify.com/nexuscortex) (community)
- **Categories:** Social media, Marketing
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.60 / 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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Threads Scraper & Unofficial Threads API: Posts, Profiles, Replies and Keyword Search (No Login)

Extract public data from **Threads** (threads.com / threads.net, by Meta) without an account, cookies or API key. Scrape the latest posts of any public profile, a single post with its replies, or search Threads by keyword, and export the results as JSON, CSV, Excel or via the Apify API.

Use it as an **unofficial Threads API**: call it from your code, Make, Zapier, n8n or Google Sheets and get Threads posts, profiles and replies as structured data, without creating a Meta developer app.

### How to scrape Threads

1. Click **Try for free** (or **Start**) on this page.
2. Enter Threads usernames or profile URLs, post URLs, or search keywords.
3. Set **Maximum results** to cap the size and cost of the run.
4. Run the Actor, then download the Threads data as JSON, CSV or Excel, or read it through the Apify API.

### What does Threads Scraper do?

- **Profile posts**: give one or more usernames (or profile URLs) and get each account's latest posts, deep into the history (hundreds of posts per account), newest first.
- **Profile info**: name, bio, follower count, verified badge and profile picture for each username.
- **Post and replies**: give post URLs and get the post plus its replies, with likes, reply counts and author details.
- **Keyword search**: search Threads for a keyword or phrase, sorted by relevance (`top`) or by time (`recent`).
- **Incremental runs**: `postsNewerThan` (for example `24 hours`) stops paging as soon as old posts show up, so scheduled monitoring runs stay cheap.

It works with plain HTTP requests against the same public endpoints Threads' own website uses for logged-out visitors. No browser is started, so runs are fast (roughly 300-800 results per minute in our tests) and cheap.

### Why use it?

- Brand and competitor monitoring: track what a company, creator or news outlet posts and how it performs.
- Social listening and market research: pull the most recent posts that mention a product, topic or event.
- Content and trend analysis: engagement (likes, replies, reposts, quotes), media type, links and topic tags per post.
- Audience research: read the replies under a post.
- Datasets for sentiment analysis, LLM pipelines and dashboards.

### Input

| Field | Description |
|---|---|
| `usernames` | Usernames or profile URLs (`zuck`, `@nasa`, `https://www.threads.com/@natgeo`) |
| `postUrls` | Links to single posts, including share links from the Threads app (`threads.com/share/...`) |
| `searchQueries` | Keywords or phrases to search |
| `searchType` | `top`, `recent` or `both` |
| `maxItems` | Hard cap on results for the whole run (also your cost cap) |
| `resultsPerTarget` | Max posts per profile / keyword |
| `maxRepliesPerPost` | Max replies per post URL (0 = only the post) |
| `includeProfileInfo` | Add one `profile` item per username |
| `includeThreadContinuations` | Keep the author's own follow-up posts in a thread |
| `postsNewerThan` | Date (`2026-10-01`) or age (`7 days`, `12 hours`) |
| `proxyConfiguration` | Apify Proxy settings (default on) |

Example:

```json
{
    "usernames": ["zuck", "nasa", "https://www.threads.com/@natgeo"],
    "postUrls": ["https://www.threads.com/@zuck/post/DfaNgswkQPG"],
    "searchQueries": ["artemis"],
    "searchType": "recent",
    "maxItems": 200,
    "resultsPerTarget": 50,
    "maxRepliesPerPost": 20,
    "postsNewerThan": "30 days"
}
```

### Output

Each dataset item has a `type`: `post`, `reply` or `profile`. Download as JSON, CSV, Excel, XML or HTML.

Post example (shortened):

```json
{
    "type": "post",
    "id": "4024588638696309702",
    "code": "DfaNgswkQPG",
    "url": "https://www.threads.com/@zuck/post/DfaNgswkQPG",
    "username": "zuck",
    "userId": "63055343223",
    "userFullName": "Mark Zuckerberg",
    "userVerified": true,
    "text": "Using our new spaces feature on Muse to build a tool for my smoker. ...",
    "createdAt": "2026-11-06T18:06:14.000Z",
    "timestamp": 1793988374,
    "likeCount": 1647,
    "replyCount": 434,
    "repostCount": 68,
    "quoteCount": 23,
    "mediaType": "carousel",
    "images": ["https://scontent.cdninstagram.com/..."],
    "videos": ["https://scontent.cdninstagram.com/..."],
    "links": [],
    "mentions": [],
    "topicTag": "techthreads",
    "linkPreview": null,
    "quotedPostUrl": null,
    "repostedPostUrl": null,
    "isReply": false,
    "replyToUsername": null,
    "isPinned": false,
    "language": "en"
}
```

Profile example:

```json
{
    "type": "profile",
    "id": "63055343223",
    "username": "zuck",
    "url": "https://www.threads.com/@zuck",
    "fullName": "Mark Zuckerberg",
    "biography": "Mostly superintelligence and MMA takes",
    "biographyLinks": [],
    "followerCount": 5766526,
    "isVerified": true,
    "profilePicUrl": "https://scontent.cdninstagram.com/..."
}
```

Replies add `parentPostCode` and `parentPostUrl`; search results add `searchQuery` and `searchSort`. A run summary (items, items per minute, failed targets) is saved to the key-value store under `SUMMARY`.

Note: media and profile-picture URLs are signed Meta CDN links that expire after a few days. Download the files you need promptly.

### How much does it cost?

You pay per result: **one `result` event for every dataset item** (post, reply or profile) written to the dataset. You pay nothing for failed targets or empty results. Set `maxItems` (and the run's maximum cost) to cap your spend; the Actor stops gracefully as soon as the limit is reached. See the pricing box on this page for the current price per 1,000 results. Each run also has Apify's standard start fee of $0.00005 ($0.05 per 1,000 runs), which covers the first seconds of compute. Apify subscribers pay less per result: 10% off on Bronze, 15% on Silver and 20% on Gold and higher plans.

### Limitations (please read)

- **Public data only.** Private accounts, and anything that needs a login, are not available and not attempted.
- **Keyword search returns one page**: Threads does not paginate anonymous search, so each keyword returns about 10 to 20 posts per sort order. Use many keywords, `recent` sorting and scheduled runs for continuous monitoring.
- **Reposts are not included** in profile feeds. Replies made by an account to other people's threads (the "Replies" tab) are not included either.
- **No view counts, follower lists or hashtag pages.**
- Meta changes its website regularly. If the Actor breaks, it fails with a clear error message instead of returning wrong data; please report it in the Issues tab.
- Very large jobs benefit from the Residential proxy group if you see blocking errors in the log.

### FAQ

**Do I need a Threads or Instagram account?** No. The Actor never logs in and never asks for cookies.

**Does it scrape emails or phone numbers?** No. It only returns what a public post or public profile shows, and does not extract contact data.

**Is scraping Threads legal?** The Actor collects only publicly visible data without logging in. In *Meta v. Bright Data* (N.D. Cal., January 2024) a US court held that Meta's terms do not bar logged-off scraping of public data. Laws differ by country and by what you do with the data (personal data is covered by GDPR and similar laws). This is not legal advice; make sure your use case complies with the laws that apply to you.

**Is there an official Threads API? Why use this instead?** Meta's official Threads API needs a Meta developer app, an access token and app review, and is built mainly for managing your own account. This Actor needs none of that: it reads the public posts, profiles, replies and search results any logged-out visitor can see.

**Can I use it through the API or schedule it?** Yes: use the Apify API, schedules, webhooks and integrations (Make, Zapier, Google Sheets, n8n, and more).

**How many posts can I get per profile?** Pagination works deep into an account's history (150 posts in 7 requests in our tests); set `resultsPerTarget` accordingly.

**Something returned fewer results than I expected.** Check the `SUMMARY` record in the key-value store; failed or non-public targets are listed there.

### Feedback

Found a bug or need a field? Open an issue in the Issues tab and we will look at it. If this Actor saved you time, a short review on this page helps other users find it.

### More scrapers from NexusCortex

- [Threads Search Scraper](https://apify.com/nexuscortex/threads-search-scraper): Threads posts and profiles by keyword, back in time
- [Threads Replies Scraper](https://apify.com/nexuscortex/threads-replies-scraper): all comments of Threads posts
- [Telegram Channel Scraper](https://apify.com/nexuscortex/telegram-channel-scraper): posts, views and reactions of public Telegram channels
- [Pinterest Scraper](https://apify.com/nexuscortex/pinterest-scraper): pins, boards and profiles by keyword or URL

# Actor input Schema

## `usernames` (type: `array`):

Threads usernames or profile URLs, e.g. `zuck`, `@nasa` or `https://www.threads.com/@natgeo`. Returns the profile summary plus the latest posts of each account.

## `postUrls` (type: `array`):

Links to single Threads posts, e.g. `https://www.threads.com/@zuck/post/DfaNgswkQPG`. Share links from the Threads app (`https://www.threads.com/share/...`) work too. Returns the post and, optionally, its replies.

## `searchQueries` (type: `array`):

Keywords or phrases to search for on Threads. Anonymous search returns one page of results (about 10 to 20 posts) per keyword and sort order; use many keywords and schedule runs for ongoing monitoring.

## `searchType` (type: `string`):

`top` = most relevant posts, `recent` = newest posts, `both` = run each keyword twice.

## `maxItems` (type: `integer`):

Hard cap on the number of results (profiles, posts and replies) saved and charged in this run.

## `resultsPerTarget` (type: `integer`):

Maximum posts collected for each profile or search keyword.

## `maxRepliesPerPost` (type: `integer`):

Maximum replies collected for each post URL. Set 0 to scrape only the post itself.

## `includeProfileInfo` (type: `boolean`):

Add one `profile` item (name, bio, followers, verified, picture) for each username. Counts as one result.

## `includeThreadContinuations` (type: `boolean`):

A profile feed also contains the follow-up posts an author adds to their own thread. Turn off to keep only top-level posts.

## `postsNewerThan` (type: `string`):

Optional. A date such as `2026-10-01` or a relative age such as `7 days`, `12 hours`. Stops paging a profile as soon as older posts appear, which saves cost for monitoring runs.

## `proxyConfiguration` (type: `object`):

Apify Proxy is recommended on the platform. If you see blocking errors, switch to the Residential proxy group.

## Actor input object example

```json
{
  "usernames": [
    "zuck",
    "nasa"
  ],
  "searchType": "top",
  "maxItems": 50,
  "resultsPerTarget": 25,
  "maxRepliesPerPost": 20,
  "includeProfileInfo": true,
  "includeThreadContinuations": true,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

All scraped items in the default dataset (posts, profiles and replies).

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "usernames": [
        "zuck",
        "nasa"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("nexuscortex/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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "usernames": [
        "zuck",
        "nasa",
    ],
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("nexuscortex/threads-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "usernames": [
    "zuck",
    "nasa"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call nexuscortex/threads-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,nexuscortex/threads-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/KqCe11eb2NTS2IAeW/builds/LHAAW7DLTEsC7xdeJ/openapi.json
