Facebook Events Scraper

What is Facebook Events Scraper and how does it work?

Meet our Facebook Events Scraper! This tool is designed to extract data for events organized and promoted on Facebook. It enables you to scrape Facebook in three ways:

🔎 By search query. Search and scrape Facebook events by providing a text query, let's say comedy. This way you can come up with search queries and explore pretty much unlimited number of events. You can also search by location, let's say Chicago. Or you can combine both previous search and go for comedy Chicago.

🎯 By search query + filters. Combine search queries with various other search filters. You can filter out paid-only events, online events or events taking place in a specific city, or on a specific date. All you need to do is to set up the filters on Facebook's event search page, copy the URLs and paste them to startUrls input field 👇. Our scraper will recognize the filters since Facebook includes them in search URLs.

🔗 By event URL. Give the scraper URLs of specific events: one or multiple. It will scrape all the available information for each of the chosen events. You can also input search and explore URLS as shown 👇.

• https://www.facebook.com/events/1023978871819924
• https://www.facebook.com/events/search/?q=Party
• https://www.facebook.com/events/explore/fr-paris/110774245616525
• https://www.facebook.com/events/search?q=Comedy&sde=AbrQ9KopLfqYT7heXVVCxznkZYxRr9hU1JA4cdLbJhjgs56yyeHW3e833A9dGP1WlEHOyagjWyFL9Y79gw-Ko1iVuJCILVkpVsHkmSbBFb3SEA&filters=eyJmaWx0ZXJfZXZlbnRzX2NhdGVnb3J5OjAiOiJ7XCJuYW1lXCI6XCJmaWx0ZXJfZXZlbnRzX2NhdGVnb3J5XCIsXCJhcmdzXCI6XCIyMTA0MTIxMTM5ODUwMTAwXCJ9IiwicnBfZXZlbnRzX2xvY2F0aW9uOjAiOiJ7XCJuYW1lXCI6XCJmaWx0ZXJfZXZlbnRzX2xvY2F0aW9uXCIsXCJhcmdzXCI6XCIxMDg0MjQyNzkxODkxMTVcIn0iLCJmaWx0ZXJfZXZlbnRzX2RhdGVfcmFuZ2U6MCI6IntcIm5hbWVcIjpcImZpbHRlcl9ldmVudHNfZGF0ZVwiLFwiYXJnc1wiOlwiMjAyMy0wMi0yNX4yMDIzLTAyLTI2XCJ9In0%3D

For pages recent events can be scraped by URLs like:

• https://www.facebook.com/dcimprovcomedyclub/upcoming_hosted_events
• https://www.facebook.com/O.Vienna/past_hosted_events

Please note that pattern https://www.facebook.com/PAGENAME/events is for logged Facebook users only and will not return any scraped events for pages. For groups however it's opposite: recent events available only by pattern https://www.facebook.com/groups/freerussiansglobal/events as both upcoming and past events. You need to be able to provide correct URLs to get recent events from pages or groups. Last but not least - pages or groups rarely host a lot of events, so actor will get only recent ones (without scrolling). To get more per page or group please run actor by schedule.

What Facebook Events data can I extract?

With this Facebook Scraper API, you will be able to extract the following Facebook data:

How do I use Facebook Events Scraper?

Facebook Events Scraper was designed to be easy to start with even if you've never extracted data from the web before. Here's how you can scrape Facebook data with this tool:

1. Create a free Apify account using your email.
2. Open Facebook Events Scraper.
3. Add one or more Facebook event URLs to scrape its data.
4. Click "Start" and wait for the data to be extracted.
5. Download your data in JSON, XML, CSV, Excel, or HTML.

Do I need to be logged in to Facebook to scrape events?

You don't need to fill in any credentials since anyone can browse public events listed on Facebook without being logged into their account. Facebook's recommendations on events depend on user's location and other criteria.

Do I need proxies to scrape Facebook Events?

Our Facebook Events Scraper is set up to utilize smart proxy rotation. Thanks to that, your search queries will go through many different IP addresses and you may discover events you would never come across if you were using your device exclusively. The easiest way to enable proxy rotation is to use Apify proxies in Console but you can also provide a proxy pool of your own.

How many results can you scrape with Facebook Events Scraper?

Facebook Events Scraper can return over 2000 results on average. However, you have to keep in mind that scraping facebook.com has many variables to it and may cause the results to fluctuate case by case. There’s no one-size-fits-all-use-cases number. The maximum number of results may vary depending on the complexity of the input, location, and other factors. Some of the most frequent cases are:

• website gives a different number of results depending on the type/value of the input
• website has an internal limit that no scraper can cross
• scraper has a limit that we are working on improving

Therefore, while we regularly run Actor tests to keep the benchmarks in check, the results may also fluctuate without our knowing. The best way to know for sure for your particular use case is to do a test run yourself.

How much will scraping Facebook Events cost you?

When it comes to scraping, it can be challenging to estimate the resources needed to extract data as use cases may vary significantly. That's why the best course of action is to run a test scrape with a small sample of input data and limited output. You’ll get your price per scrape, which you’ll then multiply by the number of scrapes you intend to do.

Watch this video for a few helpful tips. And don't forget that choosing a higher plan will save you money in the long run.

Input

The input for Facebook Events Scraper should be URLs of Facebook events you want to scrape data from. Click on the input tab for a full input explanation in JSON.

1[
2{
3  "debugMode": false,
4  "maxEvents": 150,
5  "proxyConfiguration": {
6    "useApifyProxy": true
7  },
8  "startUrls": [
9    "https://www.facebook.com/events/search?q=Comedy&sde=AbrQ9KopLfqYT7heXVVCxznkZYxRr9hU1JA4cdLbJhjgs56yyeHW3e833A9dGP1WlEHOyagjWyFL9Y79gw-Ko1iVuJCILVkpVsHkmSbBFb3SEA&filters=eyJmaWx0ZXJfZXZlbnRzX2NhdGVnb3J5OjAiOiJ7XCJuYW1lXCI6XCJmaWx0ZXJfZXZlbnRzX2NhdGVnb3J5XCIsXCJhcmdzXCI6XCIyMTA0MTIxMTM5ODUwMTAwXCJ9IiwicnBfZXZlbnRzX2xvY2F0aW9uOjAiOiJ7XCJuYW1lXCI6XCJmaWx0ZXJfZXZlbnRzX2xvY2F0aW9uXCIsXCJhcmdzXCI6XCIxMDg0MjQyNzkxODkxMTVcIn0iLCJmaWx0ZXJfZXZlbnRzX2RhdGVfcmFuZ2U6MCI6IntcIm5hbWVcIjpcImZpbHRlcl9ldmVudHNfZGF0ZVwiLFwiYXJnc1wiOlwiMjAyMy0wMi0yNX4yMDIzLTAyLTI2XCJ9In0%3D"
10  ],
11  "searchQueries": []
12}
13]

Output sample

Once the scraper collects data for the first event, you'll see an output visualization on Apify platform. The output will look similar to the following example generated for Comedy search query:

You can of course export all extracted events to the format of your choice for easy postprocessing. We support JSON, CSV, XML, RSS, HTML Table, JSONL and Excel. Here's an excerpt from the JSON dataset you'd get:

1{
2  "url": "https://www.facebook.com/events/1330679037525139/",
3  "id": "1330679037525139",
4  "name": "Stand Up Comedy",
5  "dateTimeSentence": "SAT, FEB 25",
6  "utcStartDate": "2023-02-26T01:00:00.000Z",
7  "imageUrl": "https://scontent-frt3-2.xx.fbcdn.net/v/t39.30808-6/333102347_1229452008008092_7759957056661117666_n.jpg?stp=c0.62.168.112a_dst-jpg_p168x128&_nc_cat=110&ccb=1-7&_nc_sid=340051&_nc_ohc=drED8P15iu8AX_whbVz&_nc_ht=scontent-frt3-2.xx&oh=00_AfAJIcm32ZrwUI-eJMr_VxecAjurSa3SySjL079b9ql6jw&oe=64040E22",
8  "imageCaption": "May be an image of 4 people and text that says 'Stand up COMEDY SAT 2/25-8pm HEADLINING MARY DIMINO Ladies of Laughter CHRIS RICH USO Tour FEATURING DINO BARDIS STEVE BARBERESI SPECIAL GUEST JULIAN SAUL M TICKET PRICE: S10 No Drink Minimum HUB17 WAVE STREET STATEN ISLAND NY 10304'",
9  "duration": null,
10  "description": "Headlining Mary Dimino \n$10\nhttp://www.onwavestreet.com/events/2023/2/25/stand-up-comedy-in-the-gallery",
11  "usersGoing": 1,
12  "usersInterested": 0,
13  "usersResponded": 1,
14  "location": {
15    "url": "https://facebook.com/hub17nyc",
16    "id": "1577514862497917",
17    "name": "Hub 17 NYC",
18    "contextualName": "New York, NY, United States",
19    "placeType": "PLACE",
20    "latitude": 40.629799557735,
21    "longitude": -74.077178835869,
22    "countryCode": "US",
23    "streetAddress": "73 Wave St",
24    "city": "New York, NY, United States"
25  },
26  "ticketsInfo": null,
27  "organizedBy": "Event by Hub 17 NYC",
28  "organizators": [
29    {
30      "id": "100064406033772",
31      "url": "https://www.facebook.com/hub17nyc",
32      "name": "Hub 17 NYC",
33      "isVerified": false
34    }
35  ],
36  "eventType": "PUBLIC",
37  "privacyInfo": "Public · Hosted by Hub 17 NYC",
38  "isPast": true,
39  "isOnline": false,
40  "paidContent": false,
41  "isClassEvent": false,
42  "isLiveAudioRoom": false,
43  "isRemoteLearningClass": false,
44  "isRemoteLearningCourse": false,
45  "groupEventPinnedToFeatured": false,
46  "hasRecordingAvailable": false,
47  "discoveryCategories": [
48    {
49      "url": "https://www.facebook.com/events/discovery/?suggestion_token=%7B%22event_categories%22%3A%5B660032617536373%5D%7D",
50      "label": "Comedy"
51    }
52  ],
53  "externalLinks": [
54    "http://www.onwavestreet.com/events/2023/2/25/stand-up-comedy-in-the-gallery"
55  ]
56},
57{
58  "url": "https://www.facebook.com/events/343447954420125/",
59  "id": "343447954420125",
60  "name": "Hi Hello Comedy Show",
61  "dateTimeSentence": "FRI, MAR 10 AT 7:30 PM EST",
62  "utcStartDate": "2022-04-08T23:30:00.000Z",
63  "imageUrl": "https://scontent-frt3-2.xx.fbcdn.net/v/t39.30808-6/278053533_3116259105290534_3428247187624626142_n.jpg?stp=c250.0.1500.1000a_dst-jpg_s168x128&_nc_cat=111&ccb=1-7&_nc_sid=340051&_nc_ohc=6hX5qI0v65YAX85Otj5&_nc_ht=scontent-frt3-2.xx&oh=00_AfDDT6IGAl7Ni38pZ1Z5w8NUMuv5n0GuFbhWu_0lJd_lLQ&oe=640526CE",
64  "imageCaption": "No photo description available.",
65  "duration": "337 days",
66  "description": "Hi, Hello is a standup comedy show at Fiction Bar/Cafe in Williamsburg. Comics as seen on The Tonight Show, Colbert, Netflix, Comedy Central\n\nHi Hello Comedy Show is a line up of comedians you've seen on Netflix, HBO, Comedy Central, and Late Night, bringing their stand up comedy to an intimate hidden gem venue in Brooklyn.\nWe're located at Fiction Bar/Cafe in Williamsburg (308 Hooper St, Brooklyn), every other Friday. In addition to the show, there's also a $10 beer - shot drink special!\nDoors at 7:00, comedy show at 7:30\nQuestions? DM us on instagram at @hihellocomedyshow or shoot us an email hihellocomedy@gmail.com",
67  "usersGoing": 0,
68  "usersInterested": 15,
69  "usersResponded": 15,
70  "location": {
71    "url": null,
72    "id": "960353104680520",
73    "name": "308 Hooper Street,Brooklyn,11211,US",
74    "contextualName": null,
75    "placeType": "TEXT",
76    "latitude": 40.70723,
77    "longitude": -73.95374,
78    "countryCode": "US",
79    "streetAddress": null,
80    "city": null
81  },
82  "ticketsInfo": {
83    "buyUrl": "https://www.eventbrite.com/e/hi-hello-comedy-show-tickets-222708124997?aff=efbevent",
84    "price": null,
85    "title": "Tickets · $5",
86    "subtitle": "via Eventbrite",
87    "ticketProvider": "Eventbrite"
88  },
89  "organizedBy": "Event by Hi Hello Comedy Show",
90  "organizators": [
91    {
92      "id": "100083312802587",
93      "url": "https://www.facebook.com/people/Hi-Hello-Comedy-Show/100083312802587/",
94      "name": "Hi Hello Comedy Show",
95      "isVerified": false
96    }
97  ],
98  "eventType": "PUBLIC",
99  "privacyInfo": "Public · Hosted by Hi Hello Comedy Show",
100  "isPast": false,
101  "isOnline": false,
102  "paidContent": false,
103  "isClassEvent": false,
104  "isLiveAudioRoom": false,
105  "isRemoteLearningClass": false,
106  "isRemoteLearningCourse": false,
107  "groupEventPinnedToFeatured": false,
108  "hasRecordingAvailable": false,
109  "discoveryCategories": [
110    {
111      "url": "https://www.facebook.com/events/discovery/?suggestion_token=%7B%22event_categories%22%3A%5B660032617536373%5D%7D",
112      "label": "Comedy"
113    }
114  ],
115  "externalLinks": []
116},
117]
118...

Want to scrape Facebook reviews or groups?

You can use the dedicated scrapers below if you want to scrape specific Facebook data. Each of them is built particularly for the relevant Facebook scraping case be it a group, reviews, comments or photos. Feel free to browse them:

• Facebook Comments Scraper
• Facebook Groups Scraper
• Facebook Posts Scraper
• Facebook Reviews Scraper

Integrations and Facebook Events Scraper

Last but not least, Facebook Events Scraper can be connected with almost any cloud service or web app thanks to integrations on the Apify platform. You can integrate with Make, Zapier, Slack, Airbyte, GitHub, Google Sheets, Google Drive, and more. Or you can use webhooks to carry out an action whenever an event occurs, e.g. get a notification whenever Facebook Events Scraper successfully finishes a run.

Using Facebook Events Scraper with the Apify API

The Apify API gives you programmatic access to the Apify platform. The API is organized around RESTful HTTP endpoints that enable you to manage, schedule, and run Apify actors. The API also lets you access any datasets, monitor actor performance, fetch results, create and update versions, and more.

To access the API using Node.js, use the apify-client NPM package. To access the API using Python, use the apify-client PyPI package.

Check out the Apify API reference docs for full details or click on the API tab for code examples.

Is it legal to scrape Facebook Events data?

Our Facebook scrapers are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what the user has chosen to share publicly. However, you should be aware that your results could contain personal data. You should not scrape personal data unless you have a legitimate reason to do so.

If you're unsure whether your reason is legitimate, consult your lawyers. You can also read our blog post on the legality of web scraping and ethical scraping.

Need other social media scrapers?

We have many more social media related scrapers for you to try, such as Facebook Pages Scraper, Instagram Scraper, Twitter Scraper, TikTok Scraper or Reddit Scraper. If you're interested in those, browse the Social media Category in Apify Store.

Not your cup of tea? Build your own scraper

Facebook Events Scraper doesn’t exactly do what you need? You can always build your own! We have various scraper templates in Python, JavaScript, and TypeScript to get you started. Alternatively, you can write it from scratch using our open-source library Crawlee. You can keep the scraper to yourself or make it public by adding it to Apify Store (and find users for it).

Or let us know if you need a custom scraping solution.

Your feedback

We’re always working on improving the performance of our Actors. So if you’ve got any technical feedback for Facebook Events Scraper or simply found a bug, please create an issue on the Actor’s Issues tab in Apify Console.