# Threads Scraper: Keyword Search, Profiles & Posts (`earlytern/threads-search-scraper`) Actor

Search public Threads posts by keyword and scrape profiles: text, likes, replies, reposts, quotes, date, media, followers and bio. No login.

- **URL**: https://apify.com/earlytern/threads-search-scraper.md
- **Developed by:** [earlytern](https://apify.com/earlytern) (community)
- **Categories:** Social media, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 1,000 posts

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: Keyword Search, Profiles & Posts

Threads Scraper searches public Threads posts by keyword and reads public Threads profiles, without logging in. Each
post comes back as one clean row: text, author, likes, replies, reposts, quotes, shares, publish time, and picture and
video addresses. Each profile also gets one free row with its name, bio, follower count and verified badge.

### What does Threads Scraper do?

- **Keyword search:** the top posts Threads shows for a word, a phrase or a hashtag (about 20 per keyword).
- **Profile posts:** the latest public posts of any public profile (about 5 per profile), plus the profile details.
- **Post data:** text, author user name and display name, verified badge, likes, replies, reposts, quotes, shares,
  publish time (ISO 8601), media type and media addresses, post address and ID.
- **Profile data:** user name, display name, bio, links, followers, verified badge, profile picture.
- **One row per post per run:** a post found by two keywords is saved and charged once.
- **Free rows that explain:** a keyword with no posts, a profile that does not exist, or a line that is not usable
  gets a free row saying why, so you always know what happened to each line.

### Why use Threads Scraper?

- **Brand and product monitoring:** see what people post about your brand, product or competitors.
- **Trend and topic research:** collect posts about a topic or hashtag for analysis or AI summaries.
- **Creator and influencer research:** check followers, bio and recent engagement of public profiles.
- **AI agents:** give an AI agent fresh public Threads posts through the Apify API or MCP.
- **Low, simple price:** $1.50 per 1,000 posts, no start fee, profile rows free, nothing charged for empty results.
- **No login, no cookies:** you never share a Threads or Instagram account.

### How to use Threads Scraper

1. Click **Try for free**.
2. Add **Search keywords** (for example `coffee` or `#marketing`), **Profiles** (for example `nasa`, `@nasa` or
   `https://www.threads.com/@nasa`), or both.
3. Optionally set **Maximum posts per keyword or profile**.
4. Click **Start**. A run with a few keywords and profiles finishes in under a minute.
5. Download the results as JSON, CSV or Excel, or use them through the API.

### Input

```json
{
  "keywords": ["coffee"],
  "profiles": ["nasa"],
  "maxPostsPerSource": 10
}
```

| Field | What it does |
|---|---|
| `keywords` | Words, phrases or hashtags to search, one per line. |
| `profiles` | User names (`nasa`, `@nasa`) or profile addresses (`https://www.threads.com/@nasa`). A post address also works: its author's profile is read. |
| `maxPostsPerSource` | At most this many posts per keyword and per profile (1-100, default 25). |
| `proxyConfiguration` | Connection used to open Threads. The default Apify Proxy works for most runs. |

Add at least one keyword or one profile.

### Output

One row per post (`type: "post"`), one row per profile (`type: "profile"`), and free rows that explain lines without
posts. Example post row:

```json
{
  "type": "post",
  "source": "profile",
  "query": "nasa",
  "id": "4025371820235557316",
  "code": "Dfc_lfaAgnE",
  "url": "https://www.threads.com/@nasa/post/Dfc_lfaAgnE",
  "text": "Do you want to be an astronaut?\n\nApplications are now open to join NASA's astronaut corps. ...",
  "createdAt": "2026-11-07T20:03:13.000Z",
  "username": "nasa",
  "fullName": "NASA",
  "isVerified": true,
  "userId": "28829152388",
  "likes": 2268,
  "replies": 147,
  "reposts": 197,
  "quotes": 43,
  "shares": 173,
  "mediaType": "video",
  "mediaUrls": ["https://scontent.cdninstagram.com/v/....mp4"],
  "isReply": false,
  "bio": null,
  "bioLinks": [],
  "followers": null,
  "profilePicUrl": null,
  "message": null,
  "scrapedAt": "2026-11-16T04:45:03.000Z"
}
```

Example profile row (free):

```json
{
  "type": "profile",
  "source": "profile",
  "query": "nasa",
  "url": "https://www.threads.com/@nasa",
  "username": "nasa",
  "fullName": "NASA",
  "isVerified": true,
  "userId": "28829152388",
  "bio": "Making the seemingly impossible, possible. ✨",
  "bioLinks": [],
  "followers": 12798625,
  "profilePicUrl": "https://scontent.cdninstagram.com/v/....jpg",
  "message": null
}
```

Post fields are `null` on profile rows and the other way round. Row types:

| `type` | Meaning | Charged |
|---|---|---|
| `post` | One Threads post | Yes |
| `profile` | Details of a profile you asked for | No |
| `no_results` | Threads showed no posts for the keyword or profile, or every post was already saved for another line | No |
| `not_found` | No public profile with this user name | No |
| `blocked` | Threads did not answer after several tries; try again later | No |
| `invalid` | The line is not a usable keyword or profile | No |
| `skipped` | Left out because the run reached your maximum cost per run | No |

### How much does Threads Scraper cost?

You pay per saved post. There is no start fee, and profile rows and explanation rows are free.

| Apify plan | Price per 1,000 posts |
|---|---|
| Free | $1.50 |
| Bronze | $1.40 |
| Silver | $1.30 |
| Gold and higher | $1.20 |

Example: 10 keywords with about 20 posts each are about 200 posts, which cost about $0.30 on the Free plan. Set a
**maximum cost per run** in the run options to cap what a run can spend: when it is reached, the run stops cleanly
and the posts it could not pay for come back as free `skipped` rows instead.

### Limits

- **Logged-out view only.** The Actor never logs in, so it sees what Threads shows to visitors: about 20 top posts
  per keyword and the first 5 or so posts of each profile. Raising "Maximum posts" does not return more than that.
- **Top results only.** Keyword search returns Threads' default ("Top") results; a "Recent" sort is not available to
  visitors.
- **Private and deleted profiles** are not available; they get a free `not_found` row.
- **Media addresses expire** after a few days. Download the pictures and videos you need soon after the run.
- Threads limits how fast one connection can search. The Actor uses a new IP address for each request and retries
  with a pause, so runs are slower when Threads is busy.

### FAQ

**Do I need a Threads or Instagram account?** No. The Actor reads public pages without logging in and never uses
cookies.

**Can I search hashtags?** Yes: add the hashtag as a keyword, for example `#marketing`.

**Why did a keyword return fewer posts than I asked for?** Threads shows visitors only about 20 posts per keyword.
Add related keywords or other spellings to collect more.

**Why is `likes` null on some posts?** The author chose to hide the like count.

**Can I run it on a schedule?** Yes. Use Apify Schedules to run it daily or hourly, and connect the results to Make,
Zapier, n8n, Google Sheets or your own app through the API.

### Is it legal to scrape Threads?

The Actor collects only data that Threads shows publicly to visitors who are not logged in. Posts, user names,
display names and profile details are **personal data** of the people who wrote them. If you store or process them,
you need a lawful basis under the data protection laws that apply to you (for example the GDPR in the EU or the UK
GDPR), and you must respect the rights of the people in the data. Do not use the data for spam, harassment or
profiling of individuals. You are responsible for how you use the results; when in doubt, ask a lawyer.

### Questions and feedback

Open an issue on the **Issues** tab; we answer within 2 working days.

# Actor input Schema

## `keywords` (type: `array`):

Words or short phrases to search on Threads, one per line, for example coffee or #marketing. Each keyword returns the top posts Threads shows to visitors (about 20).

## `profiles` (type: `array`):

Threads profiles, one per line: a user name such as nasa or @nasa, or an address such as https://www.threads.com/@nasa. Each profile returns its details and its latest public posts (about 5).

## `maxPostsPerSource` (type: `integer`):

The run saves at most this many posts for each keyword and each profile. Threads shows visitors about 20 posts per keyword and about 5 per profile, so higher values do not return more.

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

Connection used to open Threads. The default Apify Proxy works for most runs; each request uses a new IP address.

## Actor input object example

```json
{
  "keywords": [
    "coffee"
  ],
  "profiles": [
    "nasa"
  ],
  "maxPostsPerSource": 10,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

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

No description

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

// Prepare Actor input
const input = {
    "keywords": [
        "coffee"
    ],
    "profiles": [
        "nasa"
    ],
    "maxPostsPerSource": 10,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("earlytern/threads-search-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 = {
    "keywords": ["coffee"],
    "profiles": ["nasa"],
    "maxPostsPerSource": 10,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("earlytern/threads-search-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 '{
  "keywords": [
    "coffee"
  ],
  "profiles": [
    "nasa"
  ],
  "maxPostsPerSource": 10,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call earlytern/threads-search-scraper --silent --output-dataset

```

## MCP server setup

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