Facebook Events Scraper

Facebook Events Scraper

Facebook Events Scraper is a cloud-based Facebook event extractor that turns your keywords into structured, analysis-ready records. It solves the manual work of finding and copying event details by acting as a Facebook events crawler that searches public events and enriches each result with extra details from the event page. Built for marketers, developers, data analysts, and researchers, this Facebook events scraping tool scales from a few terms to bulk queries and supports Facebook events data export for downstream workflows. Use it as a practical Facebook events API alternative to automate discovery, enrichment, and export at scale. 🚀

What data / output can you get?

Below are the primary output fields the actor writes to the dataset (one record per event). Field names are exactly as they appear in the output.

Data type	Description	Example value
id	Event ID from Facebook	"1202620635007207"
url	Direct URL to the event page	"https://www.facebook.com/events/1202620635007207/"
name	Event name/title	"Cairns Travel Expo"
eventFrequency	Single vs recurring information when available	"SINGLE"
dateTimeSentence	Human-readable date/time sentence (uppercased)	"SAT, 15 NOV AT 10:00 AEST"
utcStartDate	Start time in UTC ISO format (if present)	"2025-11-15T00:00:00.000Z"
startTime	Best-effort human-readable start time	"Sat, Nov 15 at 10:00 AM"
imageUrl	Cover image URL (if available)	"https://..."
imageCaption	Accessible caption for the cover image	"May be an image of..."
description	Full event description (from page, if found)	"Event in Cairns, QLD, Australia by..."
duration	Display duration when present	"4 hr"
address	Best-effort address string composed from location fields	"Shangri-La The Marina, Cairns"
location	Structured place object (URL, ID, name, coordinates, etc.)	{"name":"Shangri-La...","latitude":-16.91,...}
ticketsInfo	Ticketing summary if detected	{"price":"$25–$60","title":"Tickets · $25–$60"}
usersGoing	Parsed “going” count from social context	76
usersInterested	Parsed “interested” count	527
usersResponded	Sum of going + interested	603
organizedBy	Primary organizer, when detected	"Kellie Grace TravelManagers"
organizators	Array of organizers with optional verification	[{"name":"Kellie Grace TravelManagers","id":"615563...","isVerified":false}]
eventType	"PUBLIC" or "PRIVATE" inferred from event kind	"PUBLIC"
privacyInfo	Privacy sentence, if available or composed	"Public · Hosted by Kellie Grace TravelManagers"
isPast	Whether the event date is in the past	false
isOnline	Whether the event is online	false
childEvents	Normalized list of child/occurrence events (if any)	[{"id":"...","url":"...","name":"..."}]
hasChildEvents	True if childEvents was detected	true
discoveryCategories	Linked discovery categories found in page JSON	[{"url":"https://www.facebook.com/events/discovery/...","label":"Community"}]
externalLinks	Unique external links extracted from description	["https://tickets.example.com"]
paidContent	Additional flag from the API parsing layer (default false)	false
isClassEvent	Additional flag from the API parsing layer (default false)	false
isLiveAudioRoom	Additional flag from the API parsing layer (default false)	false
isRemoteLearningClass	Additional flag from the API parsing layer (default false)	false
isRemoteLearningCourse	Additional flag from the API parsing layer (default false)	false
groupEventPinnedToFeatured	Additional flag from the API parsing layer (default false)	false
hasRecordingAvailable	Additional flag from the API parsing layer (default false)	false
inputUrl	Relative input search path used for the query	"/events/search/?q=comedy"
externalLinksSource	Reserved for link source (currently null)	null

Notes:

• Bonus fields like childEvents, discoveryCategories, coordinates, ticketsInfo, and organizer details are populated when available on the event page.
• Export your dataset to CSV or JSON directly from Apify once the run completes.

Key features

• ⚡ Async pagination & batching per keyword
  High-concurrency async requests (up to 25) fetch and process events fast — ideal for bulk runs with a best-in-class Facebook events scraping tool.

• 🧠 Dynamic GraphQL discovery
  Automatically discovers the required doc_id per query and fetches event edges reliably, operating as a robust Facebook events crawler.

• 📝 Event page enrichment
  Enriches search results by fetching each event page to extract descriptions, coordinates, tickets, discovery categories, external links, and organizer details.

• 🛡 Residential proxy by default
  The actor attempts to use Apify Proxy with RESIDENTIAL IPs automatically for stability. If proxy setup fails, it continues without a proxy as a fallback.

• 📦 Live dataset output and easy export
  Items are pushed to the dataset as they’re processed, making it simple to export Facebook events to CSV or JSON and integrate downstream.

• 🐍 Developer-friendly (Python + Apify SDK)
  Implemented in Python with the Apify SDK, making it easy to automate from your scripts and data pipelines — a practical Facebook events scraper Python option.

• 🔍 Public events only
  Designed to scrape public Facebook events data without logging in for safe, structured aggregation.

How to use Facebook Events Scraper - step by step

1. Sign in to Apify.
2. Open “Facebook Events Scraper” in the Apify Store.
3. Add searchQueries: enter one or more keywords (one per line), such as “travel”, “comedy”, or a city like “San Francisco”.
4. Set maxEvents: choose how many events to collect per keyword (1–1000; default 10).
5. (Optional) Configure proxyConfiguration: you can enable Use Apify Proxy. The actor will still attempt to use Apify Proxy RESIDENTIAL automatically for best reliability, and will proceed without a proxy if that fails.
6. Start the run: the actor fetches events via Facebook’s API and enriches them with details from each event page.
7. Watch progress: items are pushed to the dataset live as they are processed.
8. Export your dataset: download JSON or export Facebook events to CSV directly from the dataset.

Pro tip: Pull datasets into your analytics stack or ETL via the Apify API to automate ongoing Facebook events data export.

Use cases

Use case name	Description
Event aggregation platforms	Build a directory by collecting public events into a unified feed using a scalable Facebook event extractor.
Local SEO & directories	Populate location pages by scraping Facebook events by location keywords to boost engagement and relevance.
Market research & trend tracking	Analyze categories, timing, and engagement (going/interested) to spot local and niche trends.
Competitor & community monitoring	Track organizers and venues in target niches; benchmark activity and audience interest.
Lead/context gathering	Enrich outreach with event context (topics, locations, audiences, interest signals).
Data pipeline ingestion (API)	Use the Dataset API from Python to automate ingestion into your ETL or data warehouse.
Academic & social research	Collect structured public Facebook events data for studies and reproducible datasets.

Why choose Facebook Events Scraper?

Built for precision, enrichment, and reliability at scale.

• ✅ Accurate, structured fields: Clean keys like id, url, name, utcStartDate, location, ticketsInfo, and organizer details.
• ⚡ Scales with async concurrency: High parallelism accelerates throughput per query for bulk scraping.
• 🐍 Developer access: Python-based with Apify SDK for automation and integration in code.
• 🛡 Resilient by design: Targets public events only and attempts residential proxies by default for stability.
• 💾 Easy exports: Export Facebook events to CSV or JSON with a few clicks.
• 🔁 Production-ready: Retries, proxy fallback, and live pushing to datasets outperform fragile browser extensions or ad-hoc scripts.

In short: a robust Facebook events scraping service that pairs fast fetching with smart enrichment — a reliable Facebook events API alternative for your workflows.

Is it legal / ethical to use Facebook Events Scraper?

Yes — when done responsibly. This actor targets public Facebook event content without logging in and does not access private or authenticated data.

Guidelines for responsible use:

• Only collect publicly available event information.
• Comply with applicable laws and regulations (e.g., GDPR, CCPA).
• Review and respect Facebook’s terms for your use case.
• Do not scrape private profiles or non-public content.
• Consult your legal team for edge cases or commercial redistribution.

Input parameters & output format

Example input JSON:

{
  "searchQueries": ["travel", "comedy"],
  "maxEvents": 10,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}

Parameter reference:

Field	Type	Description	Default	Required
searchQueries	array (stringList editor)	One term per line — topics, cities, or niches. Each query is processed in order.	—	Yes
maxEvents	integer	Cap results per keyword (1–1000). Lower is faster; higher is broader.	10	No
proxyConfiguration	object (proxy editor)	Apify Proxy reduces blocks. Residential IPs usually work best. If proxy setup fails, the run may continue without a proxy (less reliable).	—	No

Example output JSON (one item):

{
  "inputUrl": "/events/search/?q=comedy",
  "url": "https://www.facebook.com/events/1202620635007207/",
  "id": "1202620635007207",
  "name": "Cairns Travel Expo",
  "eventFrequency": "SINGLE",
  "dateTimeSentence": "SAT, 15 NOV AT 10:00 AEST",
  "utcStartDate": "2025-11-15T00:00:00.000Z",
  "startTime": "Sat, Nov 15 at 10:00 AM",
  "imageUrl": "https://...",
  "imageCaption": "May be an image of...",
  "duration": "4 hr",
  "description": "Event in Cairns, QLD, Australia by...",
  "address": "Shangri-La The Marina, Cairns",
  "isCanceled": false,
  "hasChildEvents": false,
  "childEvents": [],
  "usersGoing": 76,
  "usersInterested": 527,
  "usersResponded": 603,
  "location": {
    "url": null,
    "id": "1439955531468391",
    "name": "Shangri-La The Marina, Cairns",
    "contextualName": "Shangri-La The Marina, Cairns",
    "placeType": "PLACE",
    "latitude": -16.91993,
    "longitude": 145.78029,
    "countryCode": null,
    "streetAddress": null,
    "city": "Cairns, QLD, Australia"
  },
  "ticketsInfo": {
    "buyUrl": null,
    "price": "$25–$60",
    "title": "Tickets · $25–$60",
    "subtitle": null,
    "ticketProvider": null
  },
  "organizedBy": "Kellie Grace TravelManagers",
  "organizators": [
    {
      "name": "Kellie Grace TravelManagers",
      "id": "61556325142266",
      "url": "https://www.facebook.com/profile.php?id=61556325142266",
      "isVerified": false
    }
  ],
  "eventType": "PUBLIC",
  "privacyInfo": "Public · Hosted by Kellie Grace TravelManagers",
  "isPast": false,
  "isOnline": false,
  "paidContent": false,
  "isClassEvent": false,
  "isLiveAudioRoom": false,
  "isRemoteLearningClass": false,
  "isRemoteLearningCourse": false,
  "groupEventPinnedToFeatured": false,
  "hasRecordingAvailable": false,
  "discoveryCategories": [],
  "externalLinks": [],
  "externalLinksSource": null
}

Notes:

• Many enrichment fields (description, coordinates, ticketsInfo, organizedBy, childEvents, discoveryCategories) depend on what’s publicly available on the event page. When not present, they may be null, false, or empty arrays.
• The dataset view highlights a subset of fields for convenience (e.g., url, id, name, dateTimeSentence, utcStartDate, location, organizedBy, usersGoing, usersInterested, usersResponded, eventType, isPast, isOnline).

FAQ

Do I need a Facebook login to use this?

No. The actor targets public Facebook events and does not require login or cookies. It fetches public search results and enriches details from publicly available event pages.

Can I export Facebook events to CSV or JSON?

Yes. Results are saved to an Apify dataset in structured JSON, and you can export to CSV or JSON from the dataset UI or via the API.

Is this a Facebook events scraper Python solution?

Yes. This actor is written in Python and works seamlessly with the Apify SDK and the Apify API, making it easy to automate runs and download results.

How many events can I collect per keyword?

Use maxEvents to control this (1–1000 per query). Lower values run faster; higher values broaden coverage.

Which fields are included in the output?

Core fields include id, url, name, dateTimeSentence, utcStartDate, location, usersGoing, usersInterested, usersResponded, eventType, isPast, isOnline, plus enriched details like description, ticketsInfo, organizers, discoveryCategories, childEvents, and externalLinks when available.

Do I need to configure a proxy?

Proxy configuration is optional in the input, but the actor attempts to use Apify Proxy with RESIDENTIAL IPs automatically for better reliability. If proxy setup fails, it continues without a proxy as a fallback.

Can I scrape Facebook events by location?

Yes. Add city or region names (e.g., “Berlin”, “London”) to searchQueries to collect public events matching those locations in Facebook’s search.

Is this a Facebook events API alternative?

Yes. It programmatically collects public event data using Facebook’s public endpoints and event pages, providing a practical alternative for Facebook events data export without relying on an official API.

Does it capture group or page-hosted events?

It searches public events and enriches them from event pages. When page- or group-hosted events appear in public search results, they are processed like any other public event.

Closing CTA / Final thoughts

Facebook Events Scraper is built to reliably scrape public Facebook events at scale and enrich each record with high-value details. With async batching, automatic residential proxying, and structured JSON output, it helps marketers, developers, data analysts, and researchers collect accurate event records and export Facebook events to CSV/JSON for downstream use. Developers can integrate via the Apify API or Python to automate pipelines end-to-end. Start extracting smarter event data today and turn public Facebook event signals into actionable insight.