📘 Facebook Search Scraper Facebook Search Scraper is a powerful tool that enables you to search and extract public content from Facebook based on a keyword. You can use it to discover posts, pages, or people matching your search criteria — ideal for research, monitoring, or competitive analysis. --- ## 🚀 Key Features - 🔎 Search Facebook by keyword - 📝 Fetch public posts, pages, or people - 📅 Optional filter to sort posts by recency - 📅 New: You can now filter posts by a start date and end date to retrieve content within a specific range. If no range is provided, you can instead use since with options like 1d, 7d, or 30d, or simply leave these attributes empty if you don’t want to apply a time interval. - 📊 Get engagement data: likes, shares, comments, views - 👤 Author details (name, profile picture, ID) - 🖼 Image, video, and post content extraction - 📍 Filter results by location using either a numeric Facebook location/page ID or a human-readable place name (applies to posts, pages, and people) --- ## 📥 Input Schema | Field | Type | Description | | ------------------------ | --------- | ---------------------------------------------------------------- | | search_type | string | One of "posts", "pages", or "people" | | keyword | string | The search term to use | | filter_by_recent_posts | boolean | If true, filters to most recent posts | | results_limit | number | Maximum number of search results to return | | min_wait_time_in_sec | number | Minimum wait time between requests (to avoid rate limiting) | | max_wait_time_in_sec | number | Maximum wait time between requests | | cookies | array | Optional cookies for authenticated access | | start_date | string | Optional filter to specify the start date for posts (YYYY-MM-DD) | | end_date | string | Optional filter to specify the end date for posts (YYYY-MM-DD) | | since | string | Optional relative time window; one of "1d", "7d", or "30d". overrides start_date/end_date if provided | | location | string | Optional location filter. Accepts either a 10–20 digit Facebook place/page ID, or a place name. Preferred string format is "City, Country" (e.g., "Berlin, Germany"). Names are auto-resolved to the closest match via Facebook's place typeahead. Applies to posts, pages, and people. | ### 📍 Location Filtering - What you can pass: - Numeric ID: a 10–20 digit Facebook location/page ID. This is treated as an exact match. - Place name: a human-readable place string. Preferred format is "City, Country" (e.g., "Berlin, Germany", "Cairo, Egypt"). The scraper resolves this to the closest Facebook place using a typeahead lookup. - How it works internally: - If location looks like a numeric ID, it is used directly. - If location is a name, it is resolved to an ID first. If no place is found, the location filter is skipped. - Applies to all search types: - posts → adds a location filter - pages → adds a filter_pages_location filter - people → adds a users_location filter #### 💡 Examples json { "search_type": "posts", "keyword": "coffee", "results_limit": 10, "location": "106377336067638" // numeric Facebook location/page ID } json { "search_type": "people", "keyword": "john", "results_limit": 10, "location": "New York, United States" // preferred City, Country string; will be resolved to an ID } ### 📥 Example Input json { "search_type": "posts", "keyword": "iron man", "filter_by_recent_posts": false, "results_limit": 10, "min_wait_time_in_sec": 1, "max_wait_time_in_sec": 4, "cookies": [], "start_date": "2022-01-01", "end_date": "2022-12-31", "since": "1d", // this will override start_date and end_date "location": "Berlin, Germany" // preferred City, Country string, or use a numeric Facebook ID } ``` ### 📤 Example Output (Posts Type) ```json [ { "input": "iron man", "author": null, "post_id": "1202413085219598", "action_id": "ZmVlZGJhY2s6MTIwMjQxMzA4NTIxOTU5OA==", "text": "March Recap\n\nWhat was post to be an exciting month...", "create_time": 1575889354000, "post_url": "https://www.facebook.com/reel/1374619206869162/", "like_count": 8, "comment_count": 12, "share_count": 0, "view_count": 36, "play_count": 36, "image_list": [ "https://scontent.fcai20-6.fna.fbcdn.net/v/t51.75761-10/..." ], "video_list": [ "https://video.fcai20-6.fna.fbcdn.net/o1/v/t2/f2/m69/..." ], "video_cover_image": [ "https://scontent.fcai20-6.fna.fbcdn.net/v/t51.75761-10/..." ], "durationInSec": [33], "type": "video", "author_username": "Michelle Bella", "author_user_id": "100063527524035", "author_profile_url": "https://www.facebook.com/chellsbohojungle", "author_avatar": "https://scontent.fcai20-6.fna.fbcdn.net/v/t39.30808-1/..." } ] ### 📤 Example Output (Pages and People Type) json [ { "input": "Google", "id": "100069202816629", "id_v2": "100069202816629", "name": "Google Cloud", "profile_url": "https://www.facebook.com/GoogleCloudIN", "profile_picture": "https://scontent-iad3-1.xx.fbcdn.net/v/t39.30808-1...", "is_verified": true, "info": "Welcome to the official Google Cloud..." } ]