Facebook Search Scraper

Facebook Search Scraper 🔎📊

Discover Facebook search results fast and reliably. This Apify Actor finds relevant content across locations, posts, people, and pages, and exports clean, structured data to your Apify dataset for analysis and automation.

Use it for market research, lead gen, social listening, content discovery, or to fuel your analytics workflows.

---

✨ Key Features

• Precise search across four types: locations, posts, people, pages.
• Single page per run for predictable pagination. Provide endCursor to fetch the next page.
• Built-in pacing, stability, and resilient key rotation for reliable production runs.
• Clean JSON output with timestamps and optional pagination info.

---

🚀 Quick Start

1. Open the Actor on Apify and click Run.
2. Choose your searchType and enter a query.
3. Optionally set locationUid, startDate, endDate, recentPosts, and endCursor.
4. Start the run and download results from the Dataset as JSON/CSV/Excel.

---

🧰 Input Parameters

Field	Type	Required	Description
searchType	string	Yes	One of locations, posts, people, pages.
query	string	Yes	Your search text. For locations, enter a place; for others, keywords.
locationUid	string	No	Scope your search to a location UID (get it from a locations search).
startDate	string (YYYY-MM-DD)	No	Only for posts: inclusive start date.
endDate	string (YYYY-MM-DD)	No	Only for posts: inclusive end date.
recentPosts	boolean	No	Only for posts: if true, fetches recent posts.
endCursor	string	No	Use the page_info.cursor from a previous run to fetch the next page.

Example: Posts

{
  "searchType": "posts",
  "query": "funny video",
  "locationUid": "112623132083029",
  "startDate": "2024-01-01",
  "endDate": "2024-12-31",
  "recentPosts": true
}

Example: Locations (to get UIDs)

{ "searchType": "locations", "query": "funny video" }

---

📦 Output Format

Each dataset item uses the following structure:

{
  "success": true,
  "search_type": "posts",
  "query": "funny video",
  "item": { /* result item */ },
  "page_info": { /* optional page info including cursor */ },
  "fetched_at": "2025-10-30T08:00:00.000Z"
}

• On error, a record with success: false and an error message is pushed.
• If a next page is available, the run logs: Next page cursor: …. Use that as endCursor in your next run.

---

🔁 Pagination Strategy

• This actor intentionally returns a single page per run for consistent, controllable pagination.
• To get more results, run again with the endCursor from your previous run’s page_info.cursor (or from the logs).

---

✅ Best Practices

• Start with locations to obtain a locationUid, then pass it to posts, people, or pages for scoped results.
• Store your cursors to resume exactly where you left off.
• Schedule runs on Apify to accumulate data over time.

---

❓ FAQ

• Q: How do I get the next page?

  • A: Copy the page_info.cursor from the dataset or logs and pass it as endCursor in the next run.

• Q: Why are there only a few results per page?

  • A: Facebook search returns limited results per response. Use the endCursor to iterate pages.

• Q: Can I filter posts by date?

  • A: Yes, provide startDate and/or endDate in YYYY-MM-DD format for posts.

• Q: What formats can I export to?

  • A: From the Dataset tab, export JSON, CSV, Excel, or view via the API.

---

🔗 Related Actor

• Facebook Page Video Downloader → https://apify.com/igview-owner/facebook-page-video-downloader

---

🔎 Find me Better

Facebook search scraper, Facebook posts scraper, Facebook pages scraper, Facebook people search, Facebook locations search, social listening tool, market research data, lead generation scraper, Apify actor for Facebook search, dataset export JSON CSV Excel.

---

For issues or feature requests, please open a new issue or contact the actor author. 🧑‍💻