Facebook Events Scraper

A powerful Apify Actor that scrapes Facebook events based on search queries. This actor fetches comprehensive event information including event details, locations, organizers, attendee counts, and more.

Why Choose Us?

• Comprehensive Data Extraction: Fetches complete event information including descriptions, locations with coordinates, organizers, ticket information, and social engagement metrics
• Smart Proxy Management: Automatically handles proxy fallback (no proxy → datacenter → residential) to ensure reliable data collection
• Bulk Processing: Supports multiple search queries in a single run for efficient batch processing
• Live Data Saving: Saves data to Apify dataset as it's processed, so you don't lose progress if the actor stops
• Async Performance: Uses asynchronous requests for fast, concurrent data fetching
• Robust Error Handling: Automatic retry logic with intelligent proxy fallback ensures maximum success rate

Key Features

• Search by Keywords: Find events using any search query (e.g., "travel", "comedy", "music")
• Detailed Event Information:
  • Event name, URL, ID, and description
  • Date and time information (UTC and formatted)
  • Location data with coordinates (latitude/longitude)
  • Organizer information with profile links
  • Ticket pricing information
  • Social engagement metrics (going, interested, total responses)
  • Event images and captions
• Automatic Enrichment: Fetches additional details from event pages for complete data
• Pagination Support: Automatically handles pagination to collect multiple pages of results
• Proxy Fallback System: Intelligent proxy management ensures requests succeed even when blocked

Input

The actor accepts the following input parameters:

{
  "searchQueries": ["travel", "comedy", "music"],
  "maxEvents": 10,
  "sortOrder": "relevance",
  "maxComments": 0,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}

Input Parameters

• searchQueries (required, array): List of search queries/keywords to find Facebook events. Supports bulk input. Example: ["travel", "comedy"]
• maxEvents (optional, integer): Maximum number of events to collect per search query. Default: 10, Range: 1-1000
• sortOrder (optional, string): Sort order for events. Options: "relevance", "date", "popularity". Default: "relevance"
• maxComments (optional, integer): Maximum comments to fetch per event (for future use). Default: 0, Range: 0-1000
• proxyConfiguration (optional, object): Proxy configuration. By default, starts with no proxy and falls back to datacenter/residential if blocked. Use Apify proxy editor to configure.

Output

The actor outputs an array of event objects, each containing comprehensive event information:

[
  {
    "url": "https://www.facebook.com/events/1202620635007207/",
    "id": "1202620635007207",
    "name": "Cairns Travel Expo",
    "dateTimeSentence": "SAT, 15 NOV AT 10:00 AEST",
    "utcStartDate": "2025-11-15T00:00:00.000Z",
    "imageUrl": "https://...",
    "imageCaption": "May be an image of...",
    "duration": "4 hr",
    "description": "Event in Cairns, QLD, Australia by...",
    "usersGoing": 76,
    "usersInterested": 527,
    "usersResponded": 603,
    "location": {
      "url": null,
      "id": "1439955531468391",
      "name": "Shangri-La The Marina, Cairns",
      "contextualName": "Shangri-La The Marina, Cairns",
      "placeType": "FreeformPlace",
      "latitude": -16.91993058397,
      "longitude": 145.78028848415,
      "countryCode": null,
      "streetAddress": null,
      "city": "Cairns, QLD, Australia"
    },
    "ticketsInfo": null,
    "organizedBy": "Kellie Grace TravelManagers",
    "organizators": [
      {
        "name": "Kellie Grace TravelManagers",
        "id": "61556325142266",
        "url": "https://www.facebook.com/profile.php?id=61556325142266"
      }
    ],
    "eventType": "PUBLIC",
    "privacyInfo": null,
    "isPast": false,
    "isOnline": false,
    "paidContent": false,
    "isClassEvent": false,
    "isLiveAudioRoom": false,
    "isRemoteLearningClass": false,
    "isRemoteLearningCourse": false,
    "groupEventPinnedToFeatured": false,
    "hasRecordingAvailable": false,
    "discoveryCategories": [],
    "externalLinks": []
  }
]

Output Fields

• url: Facebook event URL
• id: Unique event ID
• name: Event name
• dateTimeSentence: Formatted date/time string
• utcStartDate: UTC start date in ISO format
• imageUrl: Event cover image URL
• imageCaption: Image accessibility caption
• duration: Event duration (e.g., "4 hr", "2 days")
• description: Event description
• usersGoing: Number of users going
• usersInterested: Number of users interested
• usersResponded: Total users who responded (going + interested)
• location: Location object with name, coordinates, address details
• ticketsInfo: Ticket pricing information (if available)
• organizedBy: Primary organizer name
• organizators: Array of organizer objects with name, ID, and profile URL
• eventType: Event type ("PUBLIC" or "PRIVATE")
• isPast: Whether the event is in the past
• isOnline: Whether the event is online

🚀 How to Use the Actor (via Apify Console)

1. Log in at https://console.apify.com and go to Actors.
2. Find your actor (e.g., facebook-events-scraper) and click it.
3. Configure inputs:
   • Enter search queries (e.g., ["travel", "comedy"])
   • Set maximum events per query
   • Configure proxy settings if needed (optional)
4. Run the actor.
5. Monitor logs in real time to see progress.
6. Access results in the OUTPUT tab.
7. Export results to JSON or CSV.

Best Use Cases

• Event Discovery: Find events by category, location, or keyword
• Market Research: Analyze event trends and engagement metrics
• Lead Generation: Collect event organizer information for outreach
• Competitive Analysis: Monitor competitor events and activities
• Event Aggregation: Build comprehensive event databases
• Location-Based Services: Extract location data for mapping and analysis

Frequently Asked Questions

Q: How many events can I scrape?
A: The actor supports up to 1000 events per search query. You can run multiple queries in a single run.

Q: Do I need to configure a proxy?
A: No, the actor starts without a proxy. It automatically falls back to datacenter or residential proxies if requests are blocked.

Q: How long does scraping take?
A: Depends on the number of events and queries. The actor processes events concurrently for faster results. Typically, 10 events take 1-2 minutes.

Q: What happens if an event page is not accessible?
A: The actor will retry up to 3 times with automatic proxy fallback. If it still fails, it will log the error and continue with other events.

Q: Can I scrape private events?
A: The actor only scrapes publicly available event information. Private events are not accessible.

Q: How accurate is the location data?
A: Location data includes coordinates when available. The actor enriches location information from event pages for better accuracy.

Support and Feedback

For issues, questions, or feedback, please contact the actor maintainer or visit the Apify platform support.

Cautions

• Data is collected only from publicly available sources.
• No data is taken from private accounts or password-protected content.
• The end user is responsible for ensuring legal compliance (spam laws, privacy, data protection, etc.).
• Please respect Facebook's Terms of Service and rate limits when using this actor.