Facebook Search Posts

Search Facebook by keyword and extract posts, pages, groups, people, videos, and events. Get structured data with full engagement metrics, author details, and media URLs.

What does Facebook Search Posts do?

This actor lets you search Facebook just like you would on facebook.com, but returns structured, machine-readable data. Enter a keyword and get back matching posts with all their metadata — perfect for market research, brand monitoring, competitive analysis, and content discovery.

Features

• 6 search types: Posts, Pages, Groups, People, Videos, and Events
• Date filtering: Narrow results to a specific date range
• Location filtering: Scope searches to a geographic area using Facebook location UIDs
• Automatic deduplication: No duplicate results in your dataset
• Automatic pagination: Fetches as many results as you need (up to 1,000)
• Engagement metrics: Reactions breakdown (like, love, haha, wow, sad, angry, care), comments count, and shares count
• Rich media: Image URLs with dimensions, video files (SD/HD), video thumbnails
• Author info: Name, profile URL, and profile picture for each post author

Input parameters

Parameter	Type	Description
query	String	Required. The keyword or phrase to search for
search_type	Enum	Type of content: posts, pages, groups, people, videos, events. Default: posts
max_results	Integer	Maximum unique results to return (1–1,000). Default: 100
start_date	Date	Filter results from this date (YYYY-MM-DD)
end_date	Date	Filter results until this date (YYYY-MM-DD)
recent_posts	Boolean	Sort by most recent instead of relevance. Default: false
location_uid	String	Facebook location UID to filter by geographic area

Output

Each result in the dataset contains:

{
  "post_id": "pfbid02ABC123",
  "type": "photo",
  "url": "https://www.facebook.com/user/posts/pfbid02ABC123",
  "message": "Check out this amazing product!",
  "timestamp": 1710864000,
  "comments_count": 42,
  "reactions_count": 156,
  "reshare_count": 12,
  "reactions": {
    "like": 100,
    "love": 30,
    "haha": 10,
    "wow": 8,
    "sad": 3,
    "angry": 2,
    "care": 3
  },
  "author": {
    "id": "123456789",
    "name": "John Doe",
    "url": "https://www.facebook.com/johndoe",
    "profile_picture_url": "https://..."
  },
  "image": {
    "uri": "https://...",
    "height": 720,
    "width": 1280,
    "id": "img123"
  },
  "video": null,
  "external_url": null
}

Use cases

• Brand monitoring: Track mentions of your brand, products, or competitors
• Market research: Discover trends and public sentiment around topics
• Content discovery: Find popular posts in your niche for inspiration
• Lead generation: Identify potential customers discussing relevant topics
• Event tracking: Monitor discussions around events, launches, or campaigns
• Competitive analysis: Analyze competitor engagement and content strategy

Pricing

This actor is priced per result. You only pay for the results you get — no hidden fees for failed runs or empty searches.

Limitations

• Results depend on Facebook's public search availability
• Some posts may not be accessible if the author has restricted visibility
• Video file URLs (SD/HD) may expire after some time