# πŸŽ‰ Facebook Event Search Scraper (`scrapeengine/facebook-event-search-scraper-pay-per-events`) Actor - **URL**: https://apify.com/scrapeengine/facebook-event-search-scraper-pay-per-events.md - **Developed by:** [ScrapeEngine](https://apify.com/scrapeengine) (community) - **Categories:** Automation, Lead generation, Social media - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $3.99 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### πŸ’‘ What is Facebook Event Search Scraper? A Facebook Event Search Scraper is a smart automation tool designed to extract event data from Facebook Events pages quickly and accurately. It helps you search, crawl, and export Facebook events based on keywords, locations, or dates β€” ideal for marketers, researchers, and event organizers 🎯. Using this scraper, you can find and analyze events directly from Facebook’s event search API or via custom search queries. Whether you’re using the Facebook Event Scraper GitHub version, an Apify-based Facebook Event Crawler, or an online version, this tool transforms public Facebook event data into structured, exportable insights. ✨ In short β€” it’s your go-to Facebook Event Search App for real-time event discovery, analytics, and data extraction. * * * ### πŸ“¦ What Data Can You Extract with Facebook Event Search Scraper? | 🧩 Data Type | πŸ“‹ Description | | --- | --- | | πŸ†” Event ID | Unique identifier for each Facebook event | | πŸ—“οΈ Event Title | Name of the event or show | | πŸ—ΊοΈ Location / Venue | City, venue name, and address | | πŸ“† Start & End Time | Complete date and time information | | 🎫 Ticket Info | Price, links, or ticket provider details | | πŸ§‘β€πŸ’Ό Organizer Info | Name and link of the event creator | | 🌐 Event URL | Direct event link for reference | | πŸ–ΌοΈ Cover Image URL | Thumbnail or event poster link | | πŸ’¬ Description | Event details and highlights | | πŸ‘₯ Users Interested / Going | Social metrics for event popularity | βœ… The Facebook Event Search Scraper captures everything you need for market analysis, competitor tracking, and audience research β€” all in a few clicks. * * * #### βš™οΈ Key Features of Facebook Event Search Scraper Here’s why thousands of users trust this tool πŸ‘‡ * πŸ” Smart Event Discovery β€” Search events by keyword, city, category, or date range. * 🌐 Facebook Event Search API Integration β€” Built for seamless Facebook event data extraction. * ⚑ High-Speed Crawling β€” Collect hundreds of events within minutes. * 🧠 Facebook Event Crawler Logic β€” Automatically navigates pagination and hidden results. * πŸ’Ύ Multiple Export Options β€” Export Facebook events data to CSV, JSON, Excel, or XML. * 🧩 GitHub & Python Support β€” Works with Facebook Event Scraper GitHub repositories for full code customization. * 🧠 Apify Cloud Execution β€” Run your scraper online β€” no installations required. * πŸ•΅οΈ Proxies & Anti-Detection System β€” Ensures consistent performance and reliable data access. πŸ’‘ Bonus: Pair it with a Facebook Post Scraper or Facebook Comment Scraper to collect engagement data from related event posts! * * * ### 🧭 How to Use Facebook Event Search Scraper Follow these easy steps to extract events like a pro πŸͺ„ 1. Create an Apify Account – Sign up for a free Apify account. 2. Open the Actor – Search for β€œFacebook Event Search Scraper” in the Apify Store. 3. Add Search Input – Enter your keywords, location, or event URLs. 4. Set Filters – Define date range, max results, or categories. 5. Run the Scraper – Hit Start, and the scraper will fetch events automatically. 6. Download Results – Export Facebook Events data in JSON, CSV, or Excel format. πŸ’‘ Pro Tip: You can automate daily runs or integrate results into your own systems using the Apify API or Facebook Event Search API endpoints. * * * ### 🎯 Use Cases | πŸ’Ό Use Case | πŸ” Description | | --- | --- | | πŸ“… Event Aggregators | Collect and display live Facebook events in your app or website. | | πŸ“Š Market Research | Monitor event trends in specific regions or industries. | | 🧭 Competitor Analysis | Track rival organizers’ upcoming events and performance. | | πŸ“£ Event Marketing | Target local audiences with data-driven ad campaigns. | | πŸ“ Tour Planning | Musicians and promoters can plan tours using event data. | | 🧠 AI Data Training | Use structured event data to train NLP or ML models. | πŸŽ‰ The Facebook Event Search Scraper empowers event marketers, agencies, and data teams to discover and analyze public event trends effortlessly. * * * ### πŸ’₯ Why Choose Our Facebook Event Search Scraper? βœ… All-in-One Functionality – Combine search scraping, event crawling, and data exporting in one tool. βœ… Fast & Reliable – Built for stability with smart proxy rotation. βœ… Flexible Integration – Works with Facebook Event Scraper GitHub, Python APIs, or Apify cloud actors. βœ… Rich Data Coverage – Extract titles, descriptions, prices, and social metrics. βœ… Cross-Scraper Compatibility – Integrate with Facebook Post Scraper or Facebook Comment Scraper. βœ… No Coding Needed – Run it online via Apify platform or use our Facebook Event Search Scraper app. This makes it perfect for agencies, developers, and data-driven organizations who want to stay ahead in social event analytics πŸ“ˆ. * * * ### πŸ“Š How Many Results Can You Scrape? The Facebook Event Search Scraper online can extract thousands of results depending on your input setup: * 🌍 Search Query Mode – Extract up to 2,000 events by keyword or category. * πŸ“† Filter Mode – Get city-based or date-based events with precise targeting. * πŸ”— Direct URL Mode – Scrape full event details from provided Facebook event links. * πŸ’Ύ Export Options – Download data in JSON, Excel, or connect via API webhooks. πŸ’‘ For massive data extraction, use the Facebook Event Crawler GitHub version or scale through Apify cloud runs. * * * ### βš–οΈ Is It Legal to Scrape Facebook Events? βœ… Yes β€” when done ethically and for legitimate business or research purposes. The scraper only collects public event information available to all users, such as: * Event name, date, location, and organizer info. * Ticket and social engagement stats. 🚫 It does not access private user data, messages, or personal identifiers. Always ensure compliance with Facebook’s terms of service and local data protection laws. * * * ### 🧩 Input Parameters Example ```json { "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] }, "startUrls": [ "comedy", "music" ] } ```` | 🧾 Parameter | πŸ’‘ Description | | --- | --- | | query | Keyword or phrase to search for events | | location\_uid | City or location ID for filtering | | start\_date | Filter events after this date | | end\_date | Filter events before this date | | maxResults | Maximum number of events to scrape | *** ### πŸ“€ Output Format Example ```json [ { "query": "comedy", "event_id": "2623456577864336", "title": "Comedy Show", "url": "https://www.facebook.com/events/2623456577864336/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:00.176899Z" }, { "query": "comedy", "event_id": "551832004284847", "title": "No Stress Comedy", "url": "https://www.facebook.com/events/551832004284847/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:00.177031Z" }, { "query": "comedy", "event_id": "442331735063558", "title": "Comedy Open Mic", "url": "https://www.facebook.com/events/442331735063558/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:00.177045Z" }, { "query": "comedy", "event_id": "1487183009199861", "title": "Comedy Night", "url": "https://www.facebook.com/events/1487183009199861/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:00.177053Z" }, { "query": "comedy", "event_id": "777280871847713", "title": "Midwest Comedy Tour", "url": "https://www.facebook.com/events/777280871847713/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:00.177059Z" }, { "query": "comedy", "event_id": "930776622519153", "title": "Comedy Night", "url": "https://www.facebook.com/events/930776622519153/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:00.177068Z" }, { "query": "comedy", "event_id": "2804315799773207", "title": "Comedy Night", "url": "https://www.facebook.com/events/2804315799773207/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:00.177073Z" }, { "query": "comedy", "event_id": "4195354767344850", "title": "Comedy Night", "url": "https://www.facebook.com/events/4195354767344850/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:00.177077Z" }, { "query": "comedy", "event_id": "628795123515647", "title": "Wine&Comedy", "url": "https://www.facebook.com/events/628795123515647/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:00.177080Z" }, { "query": "comedy", "event_id": "752183650869508", "title": "Chelmsford Comedy Club ", "url": "https://www.facebook.com/events/752183650869508/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:06.893233Z" }, { "query": "comedy", "event_id": "1987238048485746", "title": "Comedy Night", "url": "https://www.facebook.com/events/1987238048485746/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:06.893260Z" }, { "query": "comedy", "event_id": "1416854276257089", "title": "Comedy Night @ Rob's Comedy Playhouse", "url": "https://www.facebook.com/events/1416854276257089/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:06.893266Z" }, { "query": "comedy", "event_id": "604926326018233", "title": "Tuesday Comedy Show!", "url": "https://www.facebook.com/events/604926326018233/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:06.893272Z" }, { "query": "comedy", "event_id": "680160168458879", "title": "Comedy Night Fundraiser", "url": "https://www.facebook.com/events/680160168458879/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:06.893276Z" }, { "query": "comedy", "event_id": "1882468792664393", "title": "Comedy Night", "url": "https://www.facebook.com/events/1882468792664393/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:06.893282Z" }, { "query": "comedy", "event_id": "1307454863717723", "title": "Crown & Comedy", "url": "https://www.facebook.com/events/1307454863717723/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:06.893287Z" }, { "query": "comedy", "event_id": "774156792070789", "title": "Ladies Comedy Night ", "url": "https://www.facebook.com/events/774156792070789/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:06.893292Z" }, { "query": "comedy", "event_id": "1307454863717723", "title": "Crown & Comedy", "url": "https://www.facebook.com/events/1307454863717723/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:24.928427Z" }, { "query": "comedy", "event_id": "774156792070789", "title": "Ladies Comedy Night ", "url": "https://www.facebook.com/events/774156792070789/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:24.928451Z" }, { "query": "comedy", "event_id": "1314844513673333", "title": "Comedy Christmas Party! ", "url": "https://www.facebook.com/events/1314844513673333/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:24.928457Z" }, { "query": "comedy", "event_id": "2623456577864336", "title": "Comedy Show", "url": "https://www.facebook.com/events/2623456577864336/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:24.928463Z" }, { "query": "comedy", "event_id": "950187563665344", "title": "Cackle Shack Comedy", "url": "https://www.facebook.com/events/950187563665344/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:24.928468Z" }, { "query": "comedy", "event_id": "1077031711240744", "title": "πŸŽ™οΈCOMEDY NIGHT!πŸŽ™οΈ", "url": "https://www.facebook.com/events/1077031711240744/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:24.928474Z" }, { "query": "comedy", "event_id": "1307606347008338", "title": "Comedy Gumbeaux", "url": "https://www.facebook.com/events/1307606347008338/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:24.928480Z" }, { "query": "comedy", "event_id": "543563068687092", "title": "Comedy Open Mic", "url": "https://www.facebook.com/events/543563068687092/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:24.928486Z" }, { "query": "comedy", "event_id": "654995264029585", "title": "Oof Comedy Hour", "url": "https://www.facebook.com/events/654995264029585/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:24.928489Z" }, { "query": "comedy", "event_id": "543479405522328", "title": "$2 TUESDAY & COMEDY ", "url": "https://www.facebook.com/events/543479405522328/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:29.939810Z" }, { "query": "comedy", "event_id": "1491246925261957", "title": "Saturday Comedy Shows!", "url": "https://www.facebook.com/events/1491246925261957/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:29.939832Z" }, { "query": "comedy", "event_id": "1124056066537913", "title": "Furkids Comedy Night", "url": "https://www.facebook.com/events/1124056066537913/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:29.939836Z" }, { "query": "comedy", "event_id": "1245228617376144", "title": "Comedy at The Ship", "url": "https://www.facebook.com/events/1245228617376144/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:29.939840Z" }, { "query": "comedy", "event_id": "2289915491392334", "title": "Candlemaker Comedy FREE ENTRY", "url": "https://www.facebook.com/events/2289915491392334/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:29.939843Z" }, { "query": "comedy", "event_id": "1792413358215694", "title": "Unplugged Comedy", "url": "https://www.facebook.com/events/1792413358215694/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:29.939847Z" }, { "query": "comedy", "event_id": "1078661170247406", "title": "Comedy - Open Mic", "url": "https://www.facebook.com/events/1078661170247406/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:29.939851Z" }, { "query": "comedy", "event_id": "547645624896595", "title": "Open Mic Comedy", "url": "https://www.facebook.com/events/547645624896595/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:33.493152Z" }, { "query": "comedy", "event_id": "1093336159154464", "title": "Comedy charity night", "url": "https://www.facebook.com/events/1093336159154464/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:33.493179Z" }, { "query": "comedy", "event_id": "846481427020279", "title": "SoirΓ©e Stand up comedy", "url": "https://www.facebook.com/events/846481427020279/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:33.493186Z" }, { "query": "comedy", "event_id": "1782957222363547", "title": "Comedy Show at Rivals", "url": "https://www.facebook.com/events/1782957222363547/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:33.493191Z" }, { "query": "comedy", "event_id": "903715802816833", "title": "All Served Comedy Show", "url": "https://www.facebook.com/events/903715802816833/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:33.493198Z" }, { "query": "comedy", "event_id": "644039055440610", "title": "Live Comedy November 15th ", "url": "https://www.facebook.com/events/644039055440610/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:33.493204Z" }, { "query": "comedy", "event_id": "1299326078334233", "title": "The Headliners Comedy Series", "url": "https://www.facebook.com/events/1299326078334233/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:33.493210Z" }, { "query": "comedy", "event_id": "1509426334081897", "title": "STAND UP Β« COMEDY LOVE Β» ", "url": "https://www.facebook.com/events/1509426334081897/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:33.493216Z" }, { "query": "comedy", "event_id": "1102553491612174", "title": "Comedy-avond Oldchib 2025", "url": "https://www.facebook.com/events/1102553491612174/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:33.493222Z" }, { "query": "comedy", "event_id": "682337907581489", "title": "Spoken Word Comedy Night", "url": "https://www.facebook.com/events/682337907581489/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:37.555172Z" }, { "query": "comedy", "event_id": "1265643704117822", "title": "MalmΓΆ English Comedy Nights @ Scandic Triangeln! Upcoming shows", "url": "https://www.facebook.com/events/1265643704117822/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:37.555187Z" }, { "query": "comedy", "event_id": "544445171823313", "title": "Comedy Underground - Saturday Showcase", "url": "https://www.facebook.com/events/544445171823313/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:37.555191Z" }, { "query": "comedy", "event_id": "761308202316159", "title": "Eindhoven English Comedy Nights at LAB-1!", "url": "https://www.facebook.com/events/761308202316159/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:37.555194Z" }, { "query": "comedy", "event_id": "348526844645127", "title": "Upcoming Hague English Comedy Nights, 2 showtimes @ 19,00 & 21,00", "url": "https://www.facebook.com/events/348526844645127/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:37.555196Z" }, { "query": "comedy", "event_id": "1215198076486543", "title": "Crazy Comedy Banko // Horsens", "url": "https://www.facebook.com/events/1215198076486543/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:37.555200Z" }, { "query": "comedy", "event_id": "1486791062728557", "title": "Laugh Lab Comedy Show", "url": "https://www.facebook.com/events/1486791062728557/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:37.555203Z" }, { "query": "comedy", "event_id": "1202415731921405", "title": "Stand U.P. Comedy Fest", "url": "https://www.facebook.com/events/1202415731921405/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:37.555206Z" }, { "query": "comedy", "event_id": "966849775363351", "title": "Tuesday Night Comedy Show", "url": "https://www.facebook.com/events/966849775363351/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:37.555209Z" }, { "query": "music", "event_id": "1135434017986150", "title": "Live music", "url": "https://www.facebook.com/events/1135434017986150/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:43.884849Z" }, { "query": "music", "event_id": "3384400211708749", "title": "Market & Music", "url": "https://www.facebook.com/events/3384400211708749/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:43.884876Z" }, { "query": "music", "event_id": "747018487742693", "title": "Lallycooler Music Festival", "url": "https://www.facebook.com/events/747018487742693/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:43.884882Z" }, { "query": "music", "event_id": "2207705703081675", "title": "Christmas Music Bingo!", "url": "https://www.facebook.com/events/2207705703081675/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:43.884887Z" }, { "query": "music", "event_id": "433090913205144", "title": "Music Bingo", "url": "https://www.facebook.com/events/433090913205144/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:43.884892Z" }, { "query": "music", "event_id": "1168073158146628", "title": "Mestizo Live Music", "url": "https://www.facebook.com/events/1168073158146628/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:43.884896Z" }, { "query": "music", "event_id": "1222132672796244", "title": "Music BINGO Fridays!", "url": "https://www.facebook.com/events/1222132672796244/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:43.884902Z" }, { "query": "music", "event_id": "669473702608465", "title": "Music Bingo", "url": "https://www.facebook.com/events/669473702608465/", "type": "search_event", "scrapedAt": "2025-11-06T12:05:43.884906Z" } ] ``` | πŸ“Š Field | 🧠 Description | | --- | --- | | id | Unique event ID | | title | Event name | | eventUrl | Facebook event link | | start\_time | Start date/time of the event | | is\_online | Indicates if the event is online | | location | Venue or city | | ticketPrice | Ticket info (if available) | | usersInterested | People marked as β€œInterested” | | usersGoing | People attending the event | | organizer | Event organizer or page name | *** ### ❓ FAQ β€” Facebook Event Search Scraper #### 1️⃣ What is the Facebook Event Search Scraper used for? It extracts public Facebook event data (titles, locations, ticket info, and social stats) for research and marketing. #### 2️⃣ Can I use the Facebook Event Scraper GitHub version? Yes β€” you can deploy or modify open-source scrapers from GitHub for local automation. #### 3️⃣ Does it work with the Facebook Event Search API? Absolutely. It’s built to integrate seamlessly with Facebook’s search query URLs or API-like endpoints. #### 4️⃣ Is it free to use? You can try the Facebook Event Search Scraper free version on Apify or run it locally with limited events. #### 5️⃣ Can I export Facebook events data? Yes β€” export data to CSV, Excel, JSON, or XML formats easily. #### 6️⃣ What’s the difference between the Event Scraper and Event Crawler? The Facebook Event Crawler is ideal for large-scale data scraping with advanced filters and automation. #### 7️⃣ Can I analyze event-related posts or comments? Yes β€” integrate with Facebook Post Scraper or Facebook Comment Scraper for engagement metrics. *** ### πŸš€ Final Thoughts The Facebook Event Search Scraper is your all-in-one solution for discovering, exporting, and analyzing Facebook events with unmatched accuracy and speed ⚑. Whether you’re using the Facebook Event Scraper GitHub version, Apify cloud actor, or your own Facebook Event Search API setup, this tool delivers rich, structured data that helps you: βœ… Track event trends\ βœ… Optimize marketing campaigns\ βœ… Monitor competitor activities\ βœ… Build event discovery apps 🎯 Start using the Facebook Event Search Scraper online today β€” turn public Facebook event data into powerful insights and business opportunities! # Actor input Schema ## `startUrls` (type: `array`): πŸ“ Add one keyword or phrase per line (e.g. "stand-up comedy", "indie concerts", "AI summit"). πŸ”„ Each entry is searched on its own β€” great for comparing scenes or covering several topics in one run. πŸ’‘ Tip: short, specific phrases usually surface the freshest results. ## `maxEvents` (type: `integer`): 🎯 Caps how many event cards we collect per search term before moving to the next. πŸ“ˆ Allowed range: 1 – 100,000 β€” tune it for quick samples or bulk discovery. ⚑ Higher limits mean more pagination and runtime; start small, then crank it up. ## `proxyConfiguration` (type: `object`): πŸ›‘οΈ Residential proxy is the recommended default β€” Facebook actively blocks Apify datacenter IP ranges, so running without a proxy on the Apify cloud usually fails. πŸ”„ If a request still gets blocked, the actor automatically retries up to 3Γ— and escalates the proxy tier: 1️⃣ Datacenter (auto group) 2️⃣ Residential πŸ’‘ Override the prefilled groups only if you have a private group you'd rather use. ## Actor input object example ```json { "startUrls": [ "comedy", "music" ], "maxEvents": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ "comedy", "music" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("scrapeengine/facebook-event-search-scraper-pay-per-events").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [ "comedy", "music", ], "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("scrapeengine/facebook-event-search-scraper-pay-per-events").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ "comedy", "music" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call scrapeengine/facebook-event-search-scraper-pay-per-events --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapeengine/facebook-event-search-scraper-pay-per-events", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "πŸŽ‰ Facebook Event Search Scraper", "version": "1.0", "x-build-id": "EBr4l70r075lbJKnD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapeengine~facebook-event-search-scraper-pay-per-events/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapeengine-facebook-event-search-scraper-pay-per-events", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/scrapeengine~facebook-event-search-scraper-pay-per-events/runs": { "post": { "operationId": "runs-sync-scrapeengine-facebook-event-search-scraper-pay-per-events", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/scrapeengine~facebook-event-search-scraper-pay-per-events/run-sync": { "post": { "operationId": "run-sync-scrapeengine-facebook-event-search-scraper-pay-per-events", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "πŸ”Ž What should we search for?", "type": "array", "description": "πŸ“ Add one keyword or phrase per line (e.g. \"stand-up comedy\", \"indie concerts\", \"AI summit\").\nπŸ”„ Each entry is searched on its own β€” great for comparing scenes or covering several topics in one run.\nπŸ’‘ Tip: short, specific phrases usually surface the freshest results.", "items": { "type": "string" } }, "maxEvents": { "title": "πŸ“Š How many events per keyword?", "minimum": 1, "maximum": 100000, "type": "integer", "description": "🎯 Caps how many event cards we collect per search term before moving to the next.\nπŸ“ˆ Allowed range: 1 – 100,000 β€” tune it for quick samples or bulk discovery.\n⚑ Higher limits mean more pagination and runtime; start small, then crank it up.", "default": 10 }, "proxyConfiguration": { "title": "🌍 Proxy & network", "type": "object", "description": "πŸ›‘οΈ Residential proxy is the recommended default β€” Facebook actively blocks Apify datacenter IP ranges, so running without a proxy on the Apify cloud usually fails.\nπŸ”„ If a request still gets blocked, the actor automatically retries up to 3Γ— and escalates the proxy tier:\n 1️⃣ Datacenter (auto group)\n 2️⃣ Residential\nπŸ’‘ Override the prefilled groups only if you have a private group you'd rather use.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```