# Threads Search Scraper (`igview-owner/threads-search-scraper`) Actor

Powerful Meta Threads search scraper for posts and users. Filter by keywords or usernames, export structured data for analytics, research, monitoring and reporting.

- **URL**: https://apify.com/igview-owner/threads-search-scraper.md
- **Developed by:** [Sachin Kumar Yadav](https://apify.com/igview-owner) (community)
- **Categories:** Social media, Developer tools, Lead generation
- **Stats:** 2,783 total users, 447 monthly users, 100.0% runs succeeded, 37 bookmarks
- **User rating**: 4.39 out of 5 stars

## Pricing

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

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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 Search Scraper

**Extract Threads posts with comprehensive metadata, engagement metrics, and user information. Perfect for social media analytics, brand monitoring, content research, and competitive intelligence.**

### 📋 Table of Contents

- [✨ Key Features](#-key-features)
- [Input Parameters](#-input-parameters)
- [📤 Output Data Structure](#-output-data-structure)
- [Usage Examples](#-usage-examples)
- [🎯 Use Cases](#-use-cases)
- [❓ Frequently Asked Questions](#-frequently-asked-questions)
- [🔒 Privacy & Compliance](#-privacy--compliance)
- [💬 Support](#-support)
- [🏷️ Tags](#️-Tags)

***

### ✨ Key Features

| Feature | Description |
|---------|-------------|
| 🧵**Advanced Search** | Search Threads posts by keywords, phrases, or hashtags |
| 📊 **Sort Options** | Sort results by relevance (top) or recency (recent) |
| 👤 **User Filtering** | Filter search results by specific username |
| 📅 **Date Filtering** | Filter posts by date range (before/after dates) |
| 📱 **Rich Metadata** | Extract complete post data and engagement metrics |
| 🎬 **Media Support** | Download videos, images, and thumbnails |
| 🔄 **Pagination** | Automatic pagination support for large datasets |
| ⚡ **Fast & Reliable** | Built-in retry logic and error handling |

***

### 📊 Input Parameters

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| **searchQuery** | String | ✅ Yes | - | Keywords, phrases, or hashtags to search (e.g., "AI technology", "#TechNews") |
| **sort** | String | No | `"top"` | Sort order: `"top"` (most relevant) or `"recent"` (newest first) |
| **fromUser** | String | No | - | Filter by specific username without @ symbol (e.g., "elonmusk") |
| **before** | String | No | - | Filter posts created before this date (YYYY-MM-DD format) |
| **after** | String | No | - | Filter posts created after this date (YYYY-MM-DD format) |
| **maxPages** | Integer | No | `5` | Maximum pages to fetch (1-20, ~10 posts per page) |

#### Search Query Tips

- **Keywords**: `"machine learning"`, `"climate change"`
- **Exact Phrases**: Use quotes `"artificial intelligence"`
- **Hashtags**: `"#TechNews"`, `"#AI"`
- **Multiple Terms**: `"startup funding venture capital"`

***

### 📤 Output Data Structure

Each extracted thread contains comprehensive information:

#### Core Fields

| Field | Type | Description |
|-------|------|-------------|
| `search_query` | String | Original search query used |
| `sort_option` | String | Sort method applied (top/recent) |
| `from_user` | String | User filter applied (if any) |
| `before_date` | String | Before date filter (if any) |
| `after_date` | String | After date filter (if any) |

#### Thread Information

| Field | Type | Description |
|-------|------|-------------|
| `thread_id` | String | Unique thread identifier |
| `post_id` | String | Post ID |
| `code` | String | Thread code for URL |
| `thread_url` | String | Direct link to the thread |
| `timestamp` | String | ISO formatted timestamp |

#### Content Data

| Field | Type | Description |
|-------|------|-------------|
| `caption` | String | Thread caption/text |
| `text_content` | String | Plain text content |

#### Media Information

| Field | Type | Description |
|-------|------|-------------|
| `media_type` | Integer | Media type (1=image, 2=video) |
| `has_audio` | Boolean | Whether video has audio |
| `video_versions` | Array | Available video files and qualities |
| `image_versions` | Array | Available image sizes |

#### User Information

| Field | Type | Description |
|-------|------|-------------|
| `user.username` | String | Username (handle) |
| `user.full_name` | String | Display name |
| `user.profile_pic_url` | String | Profile picture URL |
| `user.is_verified` | Boolean | Verification status |
| `user.is_private` | Boolean | Account privacy setting |

#### Engagement Metrics

| Field | Type | Description |
|-------|------|-------------|
| `like_count` | Integer | Number of likes |
| `comment_count` | Integer | Number of comments/replies |
| `repost_count` | Integer | Number of reposts |
| `quote_count` | Integer | Number of quote posts |
| `reshare_count` | Integer | Number of reshares |

***

### 💡 Usage Examples

#### Example 1: Basic Keyword Search

Search for posts about artificial intelligence:

```json
{
  "searchQuery": "artificial intelligence",
  "sort": "top",
  "maxPages": 5
}
```

#### Example 2: User-Specific Search

Get posts from a specific user:

```json
{
  "searchQuery": "startup tips",
  "fromUser": "elonmusk",
  "sort": "recent",
  "maxPages": 3
}
```

#### Example 3: Date Range Search

Search posts within a specific date range:

```json
{
  "searchQuery": "AI trends",
  "after": "2025-01-01",
  "before": "2025-02-01",
  "sort": "recent",
  "maxPages": 10
}
```

#### Example 4: Hashtag Research

Track trending hashtags:

```json
{
  "searchQuery": "#TechNews",
  "sort": "recent",
  "maxPages": 15
}
```

#### Example 5: Competitive Analysis

Monitor competitor mentions:

```json
{
  "searchQuery": "product launch announcement",
  "sort": "top",
  "maxPages": 10
}
```

***

### 🎯 Use Cases

#### 📊 Business Intelligence

- **Brand Monitoring** - Track brand mentions and sentiment analysis
- **Competitor Analysis** - Monitor competitor content and strategy
- **Market Research** - Understand industry trends and discussions
- **Crisis Management** - Monitor brand mentions during issues

#### 📱 Social Media Marketing

- **Content Research** - Discover popular topics and formats
- **Trend Analysis** - Identify viral content and trending topics
- **Hashtag Research** - Find effective hashtag strategies
- **Influencer Research** - Find key voices in your niche

#### 🎨 Content Strategy

- **Content Planning** - Plan content based on trending topics
- **Viral Content Study** - Analyze viral content patterns
- **Posting Strategy** - Optimize posting times and formats
- **Campaign Monitoring** - Track campaign performance and reach

***

### ❓ Frequently Asked Questions

#### General Questions

**Q: What is Threads Search Scraper?**\
A: A powerful Apify actor that extracts Threads posts with complete metadata, engagement metrics, and user information using advanced search capabilities.

**Q: How many posts can I extract?**\
A: You can extract up to 20 pages per run, with approximately 10 posts per page (around 200 posts total).

**Q: Is this scraper free to use?**\
A: The actor runs on Apify platform. You'll need an Apify account and will be charged based on platform usage (compute units).

**Q: What data format does it output?**\
A: Data is exported in JSON, CSV, Excel, HTML, or XML format through Apify's dataset storage.

#### Search & Filtering

**Q: Can I search for specific hashtags?**\
A: Yes, include hashtags in your search query (e.g., "#TechNews", "#AI").

**Q: Can I filter by date?**\
A: Yes, use `before` and `after` parameters with YYYY-MM-DD format to filter posts by date range.

**Q: Can I search posts from a specific user?**\
A: Yes, use the `fromUser` parameter with the username (without @ symbol).

**Q: What's the difference between "top" and "recent" sorting?**\
A: "Top" shows most relevant/popular posts first, while "recent" shows newest posts in chronological order.

#### Technical Questions

**Q: How long does it take to run?**\
A: Typically 1-5 minutes depending on the number of pages requested and search complexity.

**Q: What if my search returns no results?**\
A: Try different keywords, broader search terms, or remove filters. The actor will complete successfully but return an empty dataset.

**Q: Does it handle rate limits?**\
A: Yes, the actor has built-in retry logic and error handling to manage rate limits automatically.

**Q: Can I schedule regular runs?**\
A: Yes, use Apify's scheduler feature to run the actor at specific intervals (hourly, daily, weekly).

#### Data & Export

**Q: What file formats are supported?**\
A: JSON, CSV, Excel (XLSX), HTML, XML, and RSS feed formats.

**Q: Can I integrate this with other tools?**\
A: Yes, use Apify's API or webhooks to integrate with your tools and workflows.

**Q: How do I download the extracted data?**\
A: Data is automatically saved to Apify dataset. You can download it from the platform or access via API.

***

### 🔒 Privacy & Compliance

- ✅ **Public Data Only** - Extracts only publicly available Threads content
- ✅ **GDPR Compliant** - Follows data protection regulations
- ✅ **No Authentication Required** - No login credentials needed
- ✅ **Ethical Scraping** - Respects platform rate limits and terms

***

### 💬 Support

#### Need Help?

- 📧 **Issues** - Report bugs through Apify platform
- 💡 **Feature Requests** - Submit enhancement suggestions
- 🤝 **Community** - Join Apify community for discussions

#### Troubleshooting

| Issue | Solution |
|-------|----------|
| No results found | Try different keywords or broader search terms |
| Rate limit errors | The actor automatically handles this with retry logic |
| Invalid date format | Use YYYY-MM-DD format (e.g., "2025-01-15") |
| Empty dataset | Verify your search query and filters are correct |

***

### 🏷️ Tags

`threads scraper`, `threads search scraper`, `meta threads scraper`, `threads data scraper`, `threads api scraper`, `threads social media analytics`, `threads content research`, `threads engagement metrics`, `threads post extractor`, `threads data extraction`, `social media scraping tool`, `threads monitoring tool`, `threads brand monitoring`, `threads competitor analysis`, `threads trend analysis`, `how to scrape threads posts`, `extract threads data`, `threads search without account`, `download threads posts`, `threads hashtag research`, `threads influencer research`, `threads market research tool`, `threads sentiment analysis`, `threads content strategy tool`, `meta threads data export`, `social media intelligence`, `social listening tool`, `content research tool`, `brand monitoring software`, `competitor intelligence`, `viral content analysis`, `engagement metrics tracker`, `social media analytics platform`, `threads exporter`, `threads downloader`

***

### 🚀 Get Started Now

**Ready to download Threads search results?**

1. 🎯 Enter the **Search Query** (e.g., `faded`)
2. ⚙️ Set the **Sort Option** (e.g., `top`)
3. ⚙️ Set the **From User** (e.g., `alanwalkermusic`)
4. ⚙️ Set the **Max Pages** (e.g., `5`)
5. ⚙️ Set the **After Date** (e.g., `2025-01-01`)
6. ⚙️ Set the **Before Date** (e.g., `2025-12-01`)
7. ▶️ Click **Start** to run the actor
8. 📥 Download your data in JSON, CSV, Excel, or HTML format
9. Click ["Try for free"](https://apify.com?fpr=ykgg9c) to test the actor

**⭐ If this actor helps your workflow, please give it a star!**

***

### Related Actors 🤝

- **[Threads Scraper Lite](https://apify.com/igview-owner/threads-scraper-lite)**
- **[Threads Scraper Pro](https://apify.com/igview-owner/threads-scraper-pro)**
- **[Threads Media Downloader](https://apify.com/igview-owner/threads-media-downloader)**
- **[Threads Profile Following Scraper](https://apify.com/igview-owner/threads-user-following-scraper)**
- **[Threads Profile Followers Scraper](https://apify.com/igview-owner/threads-user-followers-scraper)**
- **[Threads Profile Media Scraper](https://apify.com/igview-owner/threads-user-media-scraper)**
- **[Threads Profile Scraper](https://apify.com/igview-owner/meta-threads-profile-scraper)**
- **[Threads Replies Scraper](https://apify.com/igview-owner/threads-replies-scraper)**

***

**Made with ❤️ for Apify Platform**

# Actor input Schema

## `searchQuery` (type: `string`):

Enter keywords, topics, hashtags, or phrases to search for in Threads posts. Example: 'trump', 'artificial intelligence', '#tech', etc.

## `sort` (type: `string`):

Choose how to sort search results. 'top' shows most relevant/popular posts first, 'recent' shows newest posts first.

## `from` (type: `string`):

Filter results to show only posts from a specific username. Example: 'foxnews', 'meta', etc. Leave empty to search all users.

## `before` (type: `string`):

Show posts created before this date. Select a date using the picker. Leave empty for no date limit.

## `after` (type: `string`):

Show posts created after this date. Select a date using the picker. Leave empty for no date limit.

## `maxPosts` (type: `integer`):

Maximum number of posts to scrape from search results. The scraper will fetch posts in batches until this limit is reached. ⚠️ Cannot be used together with cursor — if cursor is provided, maxPosts will be ignored.

## `cursor` (type: `string`):

Resume scraping from a specific cursor position. Use this to fetch the next page of results. The cursor value is returned in the output of a previous run. ⚠️ Cannot be used together with maxPosts — if cursor is provided, maxPosts will be ignored and only one page is fetched.

## Actor input object example

```json
{
  "searchQuery": "AI",
  "sort": "top",
  "maxPosts": 20
}
```

# Actor output Schema

## `searchResults` (type: `string`):

Open the dataset view with an overview of all search results including post content, authors, timestamps, and engagement metrics.

## `engagementMetrics` (type: `string`):

Open the dataset view with comprehensive engagement metrics including likes, replies, reposts, quotes, and shares.

## `mediaContent` (type: `string`):

Open the dataset view with media information including images, videos, and link previews from search results.

## `userProfiles` (type: `string`):

Open the dataset view with user profile details including profile pictures, verification status, and privacy settings.

# 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 = {
    "searchQuery": "AI",
    "sort": "top",
    "maxPosts": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("igview-owner/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 = {
    "searchQuery": "AI",
    "sort": "top",
    "maxPosts": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("igview-owner/threads-search-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 '{
  "searchQuery": "AI",
  "sort": "top",
  "maxPosts": 20
}' |
apify call igview-owner/threads-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=igview-owner/threads-search-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/FP43CZrdHtiSNn4SY/builds/tbQYnDAgP02XGaoO5/openapi.json