🧵 Threads Search Scraper

Extract Threads posts with comprehensive metadata, engagement metrics, and user information using advanced search capabilities. Perfect for social media analytics, content research, trend analysis, and competitive intelligence.

📋 Table of Contents

• � Key Features
• 🚀 Quick Start
• 📊 Input Parameters
• � Output Data Structure
• 💡 Usage Examples
• ⚙️ Configuration
• 🔧 Technical Details
• 📊 Performance & Limits
• �️ Error Handling
• 📱 Use Cases
• 🔒 Privacy & Compliance
• ❓ FAQ
• 🆘 Support

� Key Features

Feature	Description
🔍 Advanced Search	Search Threads posts by keywords with precision
📊 Sort Options	Sort results by relevance (top) or recency (recent)
👤 User Filtering	Filter search results by specific user accounts
📱 Rich Metadata	Extract complete post information, media, and engagement metrics
🎬 Media Support	Get video files, images, and thumbnails

Quick Start

1. Open this actor on Apify and go to the Input tab
2. Configure your search parameters in the input
3. Run the actor and get structured Threads data in the Apify dataset

{
  "searchQuery": "artificial intelligence",
  "sort": "top",
  "maxResults": 100
}

Input Parameters

Parameter	Type	Required	Default	Description
searchQuery	String	Yes	-	Keywords to search for in Threads posts
sort	String	No	"top"	Sort order: "top" (relevance) or "recent" (newest first)
fromUser	String	No	-	Filter results from specific username (without @)
maxResults	Integer	No	50	Maximum number of posts to extract (1-1000)
enablePagination	Boolean	No	true	Enable automatic pagination for more results

Search Query Tips

• Keywords: Use relevant keywords like "AI technology", "climate change"
• Phrases: Use quotes for exact phrases: "machine learning"
• Multiple terms: Combine terms: "startup funding venture capital"
• Trending topics: Search for hashtags: "#TechNews"

Output Data Structure

Each extracted thread contains comprehensive information:

Core Data Fields

Field	Type	Description
success	Boolean	Extraction status indicator
search_query	String	Original search query used
sort_option	String	Sort method applied
from_user	String	User filter applied (if any)

Thread Identifiers

Field	Type	Description
thread_id	String	Unique thread identifier
post_id	String	Post ID for the thread
code	String	Thread code for URL generation

Content Information

Field	Type	Description
caption	String	Thread caption/text content
text_content	String	Extracted plain text content
thread_url	String	Direct link to the thread

Media Information

Field	Type	Description
media_type	Integer	Media type (1=image, 2=video, etc.)
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.id	String	User's unique identifier
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
repost_count	Integer	Number of reposts
quote_count	Integer	Number of quote posts
reshare_count	Integer	Number of reshares

Timing Information

Field	Type	Description
taken_at	Integer	Unix timestamp of post
timestamp	String	ISO formatted timestamp
fetched_at	String	When data was extracted

Usage Examples

Basic Keyword Search

{
  "searchQuery": "artificial intelligence",
  "sort": "top",
  "maxResults": 50
}

User-Specific Search

{
  "searchQuery": "startup tips",
  "fromUser": "elonmusk",
  "sort": "recent",
  "maxResults": 25
}

Trending Topics Analysis

{
  "searchQuery": "#TechNews OR #Innovation",
  "sort": "recent",
  "maxResults": 200,
  "enablePagination": true
}

Competitive Research

{
  "searchQuery": "product launch",
  "sort": "top",
  "maxResults": 100
}

Technical Details

API Integration

• Service: Threads search API used internally by this actor
• Endpoint: /search with advanced query parameters
• Authentication: Handled internally via the actor’s configuration
• Rate Limiting: Built-in throttling and queue management

Data Processing Pipeline

1. Input Validation: Validate search parameters and sanitize inputs
2. API Calls: Execute search requests with retry logic
3. Data Extraction: Parse and structure response data
4. Enrichment: Add metadata and computed fields
5. Output: Save to structured dataset

Reliability Features

• Automatic Retries: Exponential backoff for failed requests
• Error Recovery: Graceful handling of API limitations
• Data Validation: Ensure data quality and completeness

Performance & Limits

Metric	Specification
Max Results per Run	1,000 posts
Request Timeout	30 seconds
Retry Attempts	3x
Pagination Support	Automatic
Concurrent Requests	Load balanced

Error Handling

Common Error Types

Error Type	Description	Solution
Invalid Query	Empty or malformed search query	Provide valid search terms
Rate Limited	API quota exceeded	Add more keys or reduce frequency
Network Timeout	Request timeout	Automatic retry with backoff
No Results	Search returned empty	Try different keywords

Error Response Format

{
  "success": false,
  "search_query": "your search query",
  "error": "Descriptive error message",
  "fetched_at": "2024-01-15T10:30:00.000Z"
}

Use Cases

Business Intelligence

• Brand Monitoring: Track mentions and sentiment
• Competitor Analysis: Monitor competitor content strategy
• Market Research: Understand industry trends and discussions
• Influencer Identification: Find key voices in your niche

Content Strategy

• Trend Analysis: Identify viral content patterns
• Content Planning: Discover popular topics and formats
• Engagement Research: Analyze what drives user interaction
• Hashtag Research: Find effective hashtag strategies

Academic Research

• Social Media Studies: Analyze communication patterns
• Sentiment Analysis: Study public opinion on topics
• Network Analysis: Map user interactions and communities
• Trend Forecasting: Predict emerging topics

Marketing & PR

• Campaign Monitoring: Track campaign performance and reach
• Crisis Management: Monitor brand mentions during issues
• Influencer Outreach: Identify potential collaboration partners
• Content Optimization: Improve content based on successful posts

Privacy & Compliance

Data Protection

• Public Data Only: Extracts only publicly available content
• No Personal Data: Doesn’t collect private user information
• GDPR Compliant: Follows data protection regulations
• Ethical Scraping: Respects platform terms and rate limits

FAQ

General Questions

Q: What types of content can I search for? A: You can search for any public Threads posts using keywords, phrases, hashtags, or user mentions.

Q: How many results can I get per search? A: You can extract up to 1,000 posts per run, with pagination support for comprehensive data collection.

Q: Can I filter results by specific users? A: Yes, use the fromUser parameter to filter results from specific usernames.

Technical Questions

Q: How do I handle rate limits? A: The actor automatically manages rate limits. For higher volume.

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

Q: Can I search for posts from a specific time period? A: Currently, time-based filtering isn’t supported, but you can sort by "recent" to get newer posts first.

Pricing Questions

Q: What are the costs of using this actor? A: Usage follows standard Apify platform pricing (compute units, storage, and any custom limits on your account).

Q: How can I optimize costs? A: Use specific search queries, set appropriate maxResults limits, and avoid unnecessary runs.

Support

Troubleshooting Steps

1. Check Actor Settings: Ensure any required secrets or configuration on Apify are correctly set
2. Check Query: Validate your search query format
3. Review Limits: Ensure you’re within rate limits and quotas
4. Test Connection: Try with a simple search first

Contact Information

• Issues: Report bugs through the Apify platform
• Feature Requests: Submit enhancement requests
• Documentation: Suggest improvements to this guide

---

🏷️ Find me

threads scraper threads social media analytics threads search threads content research threads engagement metrics social media intelligence threads api social media monitoring brand monitoring competitor analysis trend analysis social listening content strategy influencer research market research social media data threads posts social media scraping social media tools meta threads search scraper Threads Data Scraping API Threads Search Post Scraper Threads search scraper instagram Threads search scraper download meta threads api threads exporter threads search user threads search without account threads search image