🧵 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
• Input Parameters
• 📤 Output Data Structure
• Usage Examples
• 🎯 Use Cases
• ❓ Frequently Asked Questions
• 🔒 Privacy & Compliance
• 💬 Support
• 🏷️ 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:

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

Example 2: User-Specific Search

Get posts from a specific user:

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

Example 3: Date Range Search

Search posts within a specific date range:

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

Example 4: Hashtag Research

Track trending hashtags:

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

Example 5: Competitive Analysis

Monitor competitor mentions:

{
  "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" to test the actor

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

---

Related Actors 🤝

• Threads Scraper Lite
• Threads Scraper Pro
• Threads Media Downloader
• Threads Profile Following Scraper
• Threads Profile Followers Scraper
• Threads Profile Media Scraper
• Threads Profile Scraper
• Threads Replies Scraper

---

Made with ❤️ for Apify Platform