📘 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

{
  "search_type": "posts",
  "keyword": "coffee",
  "results_limit": 10,
  "location": "106377336067638"  // numeric Facebook location/page ID
}

{
  "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

{
    "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)

[
    {
        "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..."
    }
]