Facebook Events Search – Event Finder & Scraper

Search Facebook events by keyword, location, and date range. Extract detailed event listings including event titles, Facebook URLs, event IDs, and ranking positions. Supports pagination, location-based filtering, and start/end date range filters. Built with Apify best practices for reliability.

---

Table of Contents

• Features
• Use Cases
• Quick Start
• Input Parameters
• Output Format
• Performance & Limits
• FAQ
• Troubleshooting
• Why Choose This Actor?
• Tags
• Get Started Now
• Related Actors

---

Features

• Keyword Event Discovery - Search public Facebook events by any topic, interest, or niche.
• Location-Based Filtering - Target events in specific regions using location UIDs (e.g., city or region IDs).
• Date Range Filters - Narrow down your searches by setting a Start Date and End Date.
• Pagination Support - Scrape multiple result pages (up to 20 pages) for deep event indexing.
• Clean Structure - Outputs direct URLs, event IDs, titles, and search positions.
• Seamless Exporting - Download your scraped events database in CSV, JSON, Excel, or HTML.

---

Use Cases

Use Case	Description	Key Benefits
Local Event Directories	Scrape and build local event directories and community guides.	Discover events by city locations and date periods automatically.
Competitor Tracking	Track industry events, launch schedules, or vendor fairs.	Identify when competitors schedule promotional events.
Influencer & Sponsor Outreach	Discover niche festivals, meetups, and conferences.	Find events matching target audiences for sponsorship pitches.
Trend Detection	Monitor trending keywords (e.g., "AI", "blockchain", "yoga") to see interest levels.	Gauge regional popularity of specific topics based on events listed.
Event Marketing Campaigns	Discover local events to target physical flyering or geofenced digital ads.	Generate location-relevant event lists for marketing teams.

---

Quick Start

1. Basic - Simple Keyword Search

{
  "query": "music festival",
  "maxPages": 1
}

2. Advanced - Location & Date Filtering

{
  "query": "tech conference",
  "locationUid": "108155985871234",
  "startDate": "2026-08-01",
  "endDate": "2026-08-31",
  "maxPages": 3
}

---

Input Parameters

Parameter	Type	Required	Description	Default	Example
query	String	Yes	Search keyword or phrase to find matching events on Facebook	"music festival"	"tech conference", "yoga class", "food truck"
locationUid	String	No	Facebook location UID to filter events. Use our Facebook Location UID Finder to get the exact ID	-	"108155985871234"
startDate	String	No	Start date filter (ISO format or datepicker selection)	-	"2026-08-01"
endDate	String	No	End date filter (ISO format or datepicker selection)	-	"2026-08-31"
maxPages	Integer	No	Max pages of search results to crawl (1-20). Each page contains ~8 event listings.	1	2, 5, 10

---

Output Format

Event Result Data Structure

{
  "source": "facebook_events_search",
  "search_query": "music festival",
  "position": 1,
  "type": "search_event",
  "event_id": "777847974632596",
  "title": "Alive Music Festival 2026",
  "url": "https://www.facebook.com/events/777847974632596/",
  "scraped_at": "2026-07-05T02:59:56.035Z"
}

Output Fields Explained

Field	Type	Description
source	String	Source indicator, always facebook_events_search
search_query	String	The exact keyword query used for the search
position	Integer	Ranking position in search results (1-based index)
type	String	Data entity type, always search_event
event_id	String	Facebook's unique event ID
title	String	The title of the Facebook event
url	String	Direct URL link to the event's Facebook details page
scraped_at	String	ISO timestamp of extraction

---

Performance & Limits

• Pagination Limits - Maximum of 20 pages per query can be scraped to guarantee speedy execution and prevent key fatigue.
• Output Batching - Flushes data in sets of 10 to ensure safety of results in case of connection dropouts.

---

FAQ

• Q: Where does the actor get the location UIDs?
  • Location UIDs are Facebook's unique identifier for cities and places. You can extract these using the Facebook Location UID Finder actor or through Facebook search page URLs.
• Q: How many events are scraped per page?
  • Typically, Facebook returns around 8 key event listings per page request.
• Q: Do I need proxies to run this?
  • The scraper comes fully bundled with proxies and rotation middleware, so you don't need to configure your own.
• Q: Can I get full event details from this scraper?
  • This scraper acts as a discovery tool (event finder). To get complete venue details, GPS coordinates, descriptions, and ticket links, copy the output URLs into the Facebook Event Details by URL actor.

---

Troubleshooting

Issue	Cause	Solution
No events found	Query is too specific or filters are too narrow	Broaden the keyword or remove/adjust the location and date filters
Invalid location UID	Incorrect ID format provided	Ensure you use a valid Facebook location entity UID (not custom strings)
Rate-limiting delays	High traffic or long runs	The scraper rotates keys and continues. To speed up, consider running smaller maxPages per task

---

Why Choose This Actor?

• Flexible Filtering - Drill down into specific dates and geographic locations.
• Direct Event Links - Instantly produces clean Facebook URLs ready for detailed scraping.
• Robust Integration - Fully matches standard Apify dataset exports.
• Error Resilient - Automatic retry and key rotation logic ensures continuous execution.

---

Tags

facebook event finder, facebook events search, facebook events scraper, local event search, facebook search API, social media event tracker, event scraper, apify actor

---

Get Started Now

1. Enter the Search Query (e.g., music festival)
2. Add optional filters like Location UID or Date Ranges
3. Choose the Maximum Pages to crawl
4. Click Start to run the scraper
5. Export listings in CSV, JSON, or Excel format
6. Click "Try for free" to test the actor

---

Related Actors

• Facebook Event Details by URL Scraper - Scrape full description, hosts, coordinates, and ticket links.
• Facebook Page Search Scraper - Search for pages and retrieve page info.
• Facebook Ads Library Scraper - Retrieve competitor ad listings.

Built using Apify Platform | Optimized for Performance & Reliability