📝 Facebook Post Search Scraper

This actor allows you to search and extract Facebook posts based on keywords, with support for advanced filters and automatic pagination. It leverages the latest Facebook Post Search API, ensuring robust and up-to-date results.

Features

• Keyword Search: Find posts by any keyword or phrase.
• Recent Posts: Optionally restrict results to only recent posts.
• Location Filter: Filter posts by a specific location UID.
• Date Range: Specify a start and end date to narrow down results.
• Auto Pagination: Automatically fetches multiple pages using the API cursor until the desired number of results (maxResults) is reached.
• Structured Output: Returns a structured list of post objects with detailed metadata.

Input Parameters

Field	Type	Required	Description
query	string	Yes	Keywords to search for Facebook posts.
recent_posts	boolean	No	Whether to only search for recent posts.
location_uid	string	No	Location unique identifier for filtering posts.
start_date	string	No	Start date for filtering posts (format: yyyy-mm-dd).
end_date	string	No	End date for filtering posts (format: yyyy-mm-dd).
maxResults	integer	No	Maximum number of posts to fetch (default: 5, max: 5000).

Output

The output is a list of post objects, each containing:

• post_id: Post ID
• type: Post type
• url: Post URL
• message: Post content
• timestamp: Post timestamp
• comments_count: Number of comments
• reactions_count: Number of reactions
• reshare_count: Number of reshares
• reactions: Detailed reaction counts (like, love, haha, wow, sad, angry, care)
• author: Author information (id, name, url, profile_picture_url)
• image: Post image URL (if any)
• video: Post video URL (if any)
• video_thumbnail: Video thumbnail URL (if any)
• external_url: External link URL (if any)

Example output:

[
  {
    "post_id": "1239493390061723",
    "type": "post",
    "url": "https://www.facebook.com/groups/1134408680570195/posts/1239493390061723/",
    "message": "ကျွန်​တော် လက်ရှိ ဖုန်းနဲ့သုံး​နေတဲ့ ai​တွေပါ။\n\nChatGPT\nhttps://chat.openai.com/\n\nGoogle Bard\nhttps://bard.google.com/chat/\n\nBing Ai\nhttps://www.bing.com/?/ai\n\nအ​ပေါ်က၃ခုက သိချင်တာ​မေးဖို့ဖြစ်ပြီး ​အောက်က၁ခုက​တော့ qr codeလှလှ​လေး​တွေ လုပ်ဖို့ပါ။\n\nQuick QR Art\nhttps://quickqr.art/\n\nတစ်ခြား သုံးလို့​ကောင်းတဲ့ ai​လေး​တွေသိရင်လည်း လင်းပါအုံးခင်ဗျ။😁",
    "timestamp": 1697095987,
    "comments_count": 18,
    "reactions_count": 437,
    "reshare_count": 256,
    "reactions": {
      "angry": 0,
      "care": 2,
      "haha": 0,
      "like": 388,
      "love": 47,
      "sad": 0,
      "wow": 0
    },
    "author": {
      "id": "pfbid02prAFBpEg3jQ9iDjBW7noasS3ufXWx32aXuBpnugMCGzMGoAVP9WsqqaZanqaD7AWl",
      "name": "SK Naing",
      "url": "https://www.facebook.com/sknaing29",
      "profile_picture_url": "https://scontent.fsgn8-4.fna.fbcdn.net/v/t39.30808-1/392872297_360573559788889_2181586812231600155_n.jpg?stp=cp0_dst-jpg_p48x48_tt6&_nc_cat=103&ccb=1-7&_nc_sid=e99d92&_nc_ohc=JAdu48yDlVIQ7kNvwFSAPAY&_nc_oc=AdmsDv46TWxR0aJJ0INluXH7s6VgSOD2iTTOiGuXjcDR5oPnIgZCEG4PQeq9-hIFv-w&_nc_zt=24&_nc_ht=scontent.fsgn8-4.fna&_nc_gid=aTRTybJoeuZryp5dbsgmbQ&oh=00_AfLobla_FUp1EW9zKnmXRLdR1qaG3zZLjdlgbC86lkMSvA&oe=683B3748"
    },
    "image": null,
    "video": null,
    "album_preview": null,
    "video_files": null,
    "video_thumbnail": null,
    "external_url": null,
    "attached_event": null,
    "attached_post": null,
    "attached_post_url": null,
    "scrapedAt": "2025-05-27T09:01:38.204Z"
  },
  ...
]

Use Cases

• Social media research and analytics
• Content discovery and trend analysis
• Academic and marketing studies
• Brand monitoring and sentiment analysis

Notes

• The actor will automatically paginate using the API cursor until the maxResults limit is reached or no more results are available.
• Make sure your query is specific enough to get relevant results.
• The API may have rate limits, so consider using appropriate delays between requests.

---

Enjoy fast and reliable Facebook post data extraction!