Facebook Event Scraper (by Search URL)

What does Facebook Event Scraper (by Search URL) do?

Facebook Event Scraper (by Search URL) extracts event data from Facebook event search and explore pages. Provide an event search URL (e.g. /events/explore/ filtered by location or category), and the scraper will automatically discover all individual event links on the search results page, then concurrently fetch and parse each event's detail page.

• Scrape events from Facebook event search/explore URLs (e.g. /events/explore/ by location or category)
• Automatically discover individual event URLs from search results
• Concurrent detail-page fetching for high throughput
• Extract rich event details: title, date, location, description, hosts, tickets, coordinates, and more
• Configurable retry and concurrency settings
• Returns a 404 error if no events are found for a search URL
• Export data in multiple formats: JSON, CSV, Excel, or HTML

What data can you get from Facebook

Facebook Event Scraper (by Search URL) can gather the following data from each event:

How to scrape Facebook events with Facebook Event Scraper (by Search URL)?

Facebook Event Scraper (by Search URL) is easy to use. Follow these 5 steps:

1. Open Facebook Events and navigate to a search/explore page (e.g. /events/explore/us-atlanta/).
2. Copy the search URL and paste it into the url field.
3. Adjust retry_times and max_concurrency if needed.
4. Run the scraper and wait for the data to be extracted.
5. Download your data in JSON, CSV, Excel, or HTML.

Input

To start scraping Facebook events, fill in the input parameters. Facebook Event Scraper (by Search URL) supports the following inputs:

• url (required): Array of Facebook event search/explore URLs
• retry_times (optional): Number of retry attempts per request, between 1 and 5 (default: 3)
• max_concurrency (optional): Maximum number of concurrent detail page requests, between 1 and 20 (default: 8)

Input JSON

{
  "url": [
    { "url": "https://www.facebook.com/events/explore/us-atlanta/107991659233606" }
  ],
  "retry_times": 3,
  "max_concurrency": 8
}

Output

Each input URL may produce multiple result rows (one per event found). Each row contains:

Here is an example of the data object in JSON:

{
  "event_id": "1234567890",
  "url": "https://www.facebook.com/events/1234567890/",
  "title": "Atlanta Jazz Festival 2025",
  "event_date": "2025-07-04T16:00:00.000Z",
  "event_start_time": "2025-07-04T16:00:00.000Z",
  "event_end_time": "2025-07-04T22:00:00.000Z",
  "event_end_date": "2025-07-04T22:00:00.000Z",
  "event_timezone": "EDT",
  "duration": { "time": 360, "time_units": "min" },
  "location": { "address": "Piedmont Park", "url": "https://www.facebook.com/piedmontparkatl" },
  "full_address": "Piedmont Park, Atlanta, GA 30309",
  "longitude": -83.9785,
  "latitude": 33.7854,
  "people_responded": 2847,
  "event_by": [{ "name": "City of Atlanta", "url": "https://www.facebook.com/ATLgov" }],
  "hosts": [{ "name": "City of Atlanta", "url": "https://www.facebook.com/ATLgov", "verified": true }],
  "access_level": "PUBLIC",
  "description": {
    "hashtags": { "url": "https://www.facebook.com/events/explore/music/", "value": "Music" },
    "links": [],
    "text": "Join us for the annual Atlanta Jazz Festival..."
  },
  "unformatted_description_text": "Join us for the annual Atlanta Jazz Festival...",
  "hashtags": [{ "url": "https://www.facebook.com/events/explore/music/", "value": "Music" }],
  "tickets": {
    "currency": null,
    "min_price": null,
    "max_price": null,
    "provider": null,
    "url": null
  },
  "suggested_events": [
    {
      "date": "2025-07-11T18:00:00+00:00",
      "location": "Fox Theatre",
      "name": "Blues Night",
      "people_interested": "520",
      "url": "https://www.facebook.com/events/8765432109/"
    }
  ],
  "main_image_downloadable": "https://scontent.fbko1-1.fna.fbcdn.net/...",
  "error": "",
  "error_code": "",
  "user-input": ""
}

How can I use the data extracted from Facebook events?

• 📅 Build an event calendar by aggregating events from multiple cities and categories
• 📊 Perform market research on event trends, popular locations, and ticket pricing
• 🎯 Identify local events in specific cities, regions, or categories
• 📍 Analyze geographic distribution of events using coordinates and location data
• 🎟️ Monitor ticket availability and pricing across different platforms
• 🔔 Set up automated alerts for new events matching specific criteria
• 📈 Track event engagement through the number of people responded
• 🏢 Conduct competitive analysis by monitoring events in your industry or area

Error items

When the scraper cannot retrieve data for a given URL, it pushes an error item to the dataset instead of silently skipping it. Normal output items are never affected; you can tell them apart by the presence of a non-empty error_code field.

Error item structure

{
  "url": "https://www.facebook.com/events/explore/invalid-location/999999",
  "status": "failed",
  "data": null,
  "error": "No events found for this search URL",
  "error_code": "NO_EVENTS_FOUND"
}

Error codes reference

FAQ

How does the scraper discover individual events from a search page?

The scraper first fetches the event search/explore page (e.g. /events/explore/us-atlanta/), parses the HTML to extract all individual event URLs, then concurrently fetches each event's detail page to extract the full event data.

What is the difference between this scraper and the Event List URL scraper?

This scraper works with search/explore URLs that filter events by location or category. The Event List URL scraper works with venue event list pages that show all events for a specific venue or organization. Use this scraper when you want to find events by geography or topic.

Can I scrape events from multiple search URLs at once?

Yes. The url field accepts an array of search/explore URLs. The scraper will process all URLs and collect events from each search result page.

How fast is the scraper?

The scraper uses concurrent requests (controlled by max_concurrency) to fetch multiple event detail pages in parallel. With the default setting of 8 concurrent requests, it can process search results efficiently. You can increase max_concurrency up to 20 for faster scraping.

What happens if no events are found for a search URL?

The scraper returns a result row with a NO_EVENTS_FOUND error code for that URL, while continuing to process the remaining URLs normally.