Facebook Search Agent

For simple searching and extracting public Facebook posts at scale. Featuring keyword-based filtering, date range support, mobile-optimized scraping, and anti-bot handling. Ideal for businesses, analysts, and developers performing market research, trend analysis, or content monitoring.

🚀 Key Features

• Pure HTTP Requests: No browser overhead - uses Facebook's GraphQL API directly
• Complete Data Extraction: Posts, authors, engagement metrics, images, and metadata
• High Performance: Can handle thousands of posts efficiently
• Real Engagement Metrics: Accurate comment and reaction counts
• Enterprise Grade: Production-ready with comprehensive error handling

🎯 Use Cases

• Social Media Monitoring: Track brand mentions and sentiment
• Market Research: Analyze trends and public opinion
• Content Analysis: Study viral content and engagement patterns
• Competitor Intelligence: Monitor competitor social media activity
• Academic Research: Collect data for social science studies
• Trend Analysis: Identify emerging topics and hashtags

📊 Sample Output

[
  {
    "post_id": "123456789",
    "url": "https://facebook.com/posts/123456789",
    "message": "Check out this amazing new technology! #innovation #tech",
    "timestamp": 1674567890,
    "comments_count": 25,
    "reactions_count": 150,
    "author": {
      "id": "user123",
      "name": "Tech Enthusiast",
      "url": "https://facebook.com/techuser",
      "profile_picture_url": "https://facebook.com/profile.jpg"
    },
    "image": {
      "uri": "https://facebook.com/image.jpg",
      "height": 720,
      "width": 1280,
      "id": "img123"
    },
    "video": null,
    "attached_post_url": null
  }
]

⚙️ Input Configuration

Parameter	Type	Description	Default	Required
query	string	Search term (e.g., "technology", "climate change")	-	✅
max_posts	integer	Maximum posts to collect (1-10,000)	50	✅
start_date	string	Start date (YYYY-MM-DD format)	-	❌
end_date	string	End date (YYYY-MM-DD format)	-	❌
recent_posts	boolean	Focus on recent posts	true	❌
search_type	string	Search type (currently "posts")	"posts"	❌

Example Input:

{
  "query": "artificial intelligence",
  "max_posts": 500,
  "start_date": "2025-01-01",
  "end_date": "2025-01-31",
  "recent_posts": true,
  "search_type": "posts"
}

📈 Performance & Scalability

• Handles 10,000+ posts with infinite scroll
• Memory efficient - processes posts in batches
• Rate limit compliant - built-in delays prevent blocking
• Fault tolerant - handles network issues and retries
• Progress tracking - real-time logging for long jobs

Performance Metrics:

• ~100 posts per minute (varies by content)
• Memory usage: <500MB for 1000 posts
• Success rate: >95% for typical queries

🔍 Troubleshooting

Common Issues:

No posts found:

• Verify the search query works on Facebook manually
• Check if the account has access to the content
• Ensure date ranges include available posts

Rate limiting:

• Reduce max_posts or add delays
• Use different Facebook account
• Run during off-peak hours

📚 Advanced Usage

Large Scale Scraping:

{
  "query": "climate change",
  "max_posts": 5000,
  "recent_posts": true
}

Historical Data Collection:

{
  "query": "covid vaccine",
  "max_posts": 1000,
  "start_date": "2021-01-01",
  "end_date": "2021-12-31"
}

Brand Monitoring:

{
  "query": "your_brand_name",
  "max_posts": 200,
  "recent_posts": true
}

🔒 Privacy & Compliance

• Respects Facebook's robots.txt
• Implements proper rate limiting
• Uses public data only
• Includes user agent identification
• Follows ethical scraping practices

🤝 Support

For issues, questions, or feature requests:

1. Check the troubleshooting section above
2. Review Apify Actor logs for error details
3. Contact support with specific error messages

---

Ready to scrape Facebook posts at scale? Deploy this actor and start collecting valuable social media data today! 🚀