# Threads Scraper: Posts & Profiles (Meta Threads) (`pnda/threads-scraper`) Actor

Scrape Meta Threads posts of any profile, post details and profiles: text, likes, replies, reposts, date, followers and bio. No login, no cookies. Pay per result.

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

## Pricing

from $2.40 / 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/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: Posts & Profiles (Meta Threads)

Scrape Meta Threads posts of any profile, post details and profiles: text, likes, replies, reposts, date, followers and bio. No login, no cookies. Pay per result.

### What you can scrape

| Mode | What | Input | Results |
|---|---|---|---|
| `postsByProfile` | Posts of profiles | Threads URLs in `urls` | several per input |
| `postDetails` | Posts (by post URL) | Threads URLs in `urls` | one per input |
| `profiles` | Profiles (by URL) | Threads URLs in `urls` | one per input |

Every result is the full public record: all the fields Threads shows publicly, cleaned and flattened for JSON, CSV or Excel export.

### Emails included

Not just a scraper: in **Profiles (by URL)**, every profile comes with its **public email** when the account publishes one (option **Find the email of each profile**, on by default), cleaned to one standard format: lower-case, "name \[at] domain \[dot] com" decoded, junk and no-reply addresses removed.

Keep only what you need with **Which profiles to deliver**: all profiles, only profiles with an email (ready for outreach), or only profiles without one.

| Field | Meaning |
|---|---|
| `email` | Best email of the profile, or `null` |
| `emails` | Every email found on the profile |
| `email_source` | `profile-email` (business email field), `bio` (written in the bio, "name \[at] domain \[dot] com" included) or `profile-link` (mailto link) |
| `email_status` | `public` (published by the account) or `not-found` |

`email` is the best address (handy for CSV and spreadsheets), `emails` lists all of them. The email comes only from the scraped profile: no guessing, no extra request. Need a verified business email, from the creator's website too? Use [Influencer Finder](https://apify.com/pnda/creator-contact-finder), then check deliverability with [Email Verifier](https://apify.com/pnda/email-verifier).

### How to use it

1. Pick a mode in **What to scrape**.
2. Paste URLs, or type keywords / usernames.
3. Set **Max results per URL / keyword** and **Max results in total**, then run.

Input example:

```json
{
  "mode": "postsByProfile",
  "urls": [
    "https://www.threads.com/@nasa"
  ],
  "maxResultsPerInput": 20,
  "maxResults": 100
}
```

### Pricing

Pay per result: **$2.40 per 1,000 results**, plus $0.005 per run.

- Profiles delivered **with an email**: **$4.00 per 1,000** (instead of $2.40).

- With an email filter, profiles left out are not delivered and billed $2.40 per 1,000 (they were scraped).

- Inputs that are private, deleted, not found or that fail are **free**.

- The run never fetches more than your **maximum cost per run** can pay for, so you never get a surprise bill.

- Free Apify plan: up to 20 results per run.

### Why this scraper

- **No login, no cookies, no account at risk.** Public data only.
- **Reliable:** temporary blocks (rate limits, captchas, timeouts) are retried automatically.
- **Predictable cost:** limits are applied before scraping, not after.
- **API ready:** call it from Python, JavaScript, Make, Zapier, n8n or any HTTP client.

### FAQ

**Is it legal?** It collects only data that Threads shows publicly to any visitor. You are responsible for how you use the data (GDPR, CCPA, Threads terms).

**What if a URL is private, deleted or not found?** You get no result for it and you are not charged.

**Can I schedule it?** Yes, with Apify schedules, and send results to Google Sheets, Slack or a webhook.

# Actor input Schema

## `mode` (type: `string`):

Choose what to collect from Threads.

## `urls` (type: `array`):

For: Posts of profiles, Posts (by post URL), Profiles (by URL). Paste Threads URLs (one per line).

## `maxResultsPerInput` (type: `integer`):

For modes that return several items per input (posts of a profile, comments of a post, keyword search).

## `maxResults` (type: `integer`):

Hard limit on the number of results (and on the cost) of the run.

## `findEmails` (type: `boolean`):

For: Profiles (by URL). Adds email, emails, email_source and email_status: the public email of the profile (business email, bio or profile links), from the scraped data. A profile delivered with an email is billed $4.00 per 1,000 instead of $2.40.

## `emailFilter` (type: `string`):

For: Profiles (by URL). "All profiles" (default), "Only profiles with an email" or "Only profiles without an email". Profiles left out by the filter are not delivered but were scraped: each one is billed as a checked profile ($2.40 per 1,000).

## Actor input object example

```json
{
  "mode": "postsByProfile",
  "urls": [
    "https://www.threads.com/@nasa"
  ],
  "maxResultsPerInput": 20,
  "maxResults": 200,
  "findEmails": true,
  "emailFilter": "all"
}
```

# Actor output Schema

## `dataset` (type: `string`):

All records (JSON, CSV, Excel).

# 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 = {
    "mode": "postsByProfile",
    "urls": [
        "https://www.threads.com/@nasa"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("pnda/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 = {
    "mode": "postsByProfile",
    "urls": ["https://www.threads.com/@nasa"],
}

# Run the Actor and wait for it to finish
run = client.actor("pnda/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 '{
  "mode": "postsByProfile",
  "urls": [
    "https://www.threads.com/@nasa"
  ]
}' |
apify call pnda/threads-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,pnda/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/Kn7aakCb4Pva7cZuM/builds/U7kpwmWvdFL3vdLze/openapi.json