Facebook Event Scraper (by Event List URL)

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

Facebook Event Scraper (by Event List URL) extracts event data from Facebook venue event list pages. Provide a venue's /events or /upcoming_hosted_events URL, and the scraper will automatically discover all individual event links on the page, then concurrently fetch and parse each event's detail page.

• Scrape events from venue event list URLs (e.g. /events, /upcoming_hosted_events)
• Automatically discover individual event URLs from listing pages
• Concurrent detail-page fetching for high throughput
• Optionally filter to upcoming hosted events only
• Extract rich event details: title, date, location, description, hosts, tickets, coordinates, and more
• Configurable retry and concurrency settings
• Export data in multiple formats: JSON, CSV, Excel, or HTML

What data can you get from Facebook

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

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

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

1. Prepare one or more Facebook venue event list URLs (e.g. https://www.facebook.com/hp/events).
2. Configure the input: paste the URLs into the url field.
3. (Optional) Enable upcoming_events_only to filter results to upcoming events only.
4. Adjust retry_times and max_concurrency if needed.
5. Run the scraper and download your data in JSON, CSV, Excel, or HTML.

Input

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

• url (required): Array of Facebook venue event list URLs (e.g. /events or /upcoming_hosted_events)
• upcoming_events_only (optional): When enabled, only upcoming hosted events are collected (default: false)
• 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/hp/events" }
  ],
  "upcoming_events_only": false,
  "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": "Summer Music Festival 2025",
  "event_date": "2025-07-20T18:00:00.000Z",
  "event_start_time": "2025-07-20T18:00:00.000Z",
  "event_end_time": "2025-07-20T23:00:00.000Z",
  "event_end_date": "2025-07-20T23:00:00.000Z",
  "event_timezone": "EDT",
  "duration": { "time": 300, "time_units": "min" },
  "location": { "address": "Central Park", "url": "https://www.facebook.com/centralparknyc" },
  "full_address": "Central Park, New York, NY 10024",
  "longitude": -73.9654,
  "latitude": 40.7829,
  "people_responded": 1523,
  "event_by": [{ "name": "NYC Events", "url": "https://www.facebook.com/nyc-events" }],
  "hosts": [{ "name": "NYC Events", "url": "https://www.facebook.com/nyc-events", "verified": true }],
  "access_level": "PUBLIC",
  "description": {
    "hashtags": { "url": "https://www.facebook.com/events/explore/music/", "value": "Music" },
    "links": [],
    "text": "Join us for the biggest summer music event..."
  },
  "unformatted_description_text": "Join us for the biggest summer music event...",
  "hashtags": [{ "url": "https://www.facebook.com/events/explore/music/", "value": "Music" }],
  "tickets": {
    "currency": "$",
    "min_price": 25.0,
    "max_price": null,
    "provider": "Eventbrite",
    "url": "https://www.eventbrite.com/e/summer-music-fest"
  },
  "suggested_events": [
    {
      "date": "2025-08-01T19:00:00+00:00",
      "location": "Brooklyn Bowl",
      "name": "Jazz Night",
      "people_interested": "340",
      "url": "https://www.facebook.com/events/9876543210/"
    }
  ],
  "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 venues
• 📊 Perform market research on event trends, popular venues, and ticket pricing
• 🎯 Identify sponsorship and partnership opportunities by tracking organizers and hosts
• 📍 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/999999999/",
  "status": "failed",
  "data": null,
  "error": "Page not found or access denied",
  "error_code": "PAGE_NOT_FOUND"
}

Error codes reference

FAQ

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

The scraper first fetches the venue event list page (e.g. /events), 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 URL scraper?

This scraper starts from a venue event list URL and automatically discovers all events on that page. The Event URL scraper requires you to provide individual event URLs directly. Use this scraper when you want to collect all events from a venue or organization.

What does the upcoming_events_only option do?

When enabled, the scraper filters the event list to only include events that are hosted in the future. This is useful when you want to avoid collecting past events.

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 event lists efficiently. You can increase max_concurrency up to 20 for faster scraping.

Can I scrape events from multiple venues at once?

Yes. The url field accepts an array of venue event list URLs. The scraper will process all URLs and collect events from each venue.