# Facebook Events Scraper (`automly/facebook-events-scraper`) Actor

Scrape Facebook events by keyword, from public Pages (upcoming and past) or by link: name, dates, place and address, going and interested counts, hosts, tickets and description. No login.

- **URL**: https://apify.com/automly/facebook-events-scraper.md
- **Developed by:** [Automly](https://apify.com/automly) (community)
- **Categories:** Social media
- **Security:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 events

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Facebook Events Scraper

### What is Facebook Events Scraper?

**Facebook Events Scraper** lets you **scrape Facebook events** by keyword, from public Facebook Pages, or from event links: event name, start and end date, place and address, how many people are going and interested, hosts, tickets, description and cover image. Type what you are looking for or paste links, click **Start**, and download the events as Excel, CSV or JSON.

- 🔎 **Search by keyword:** a topic, a place or both, such as `Comedy New York`
- 📅 **Page events:** a Page's upcoming and past events, or just one of the two
- 👥 **Going and interested:** the number of people going, interested and invited for every event
- 📍 **Place and address:** venue name and link, address, city and map coordinates
- 🔓 **No login:** no Facebook account, cookies or API key needed
- 💸 **Free to try:** every Apify account gets $5 of free usage each month

### What can Facebook Events Scraper do?

- Search Facebook events by **keyword, city or both**
- Use Facebook's own **search filters** (dates, categories, places) by pasting a search link
- Get a Page's **upcoming and past events**
- Get the details of **single events** from their links
- Run **many searches and Pages in one run**, read side by side
- Export to Excel, CSV, JSON, HTML or XML, or send the events to Google Sheets, Make, Zapier and more

### What data can you extract from Facebook events?

| | | |
|---|---|---|
| 📝 Event name | 📅 Start date and time | ⏱️ End date and duration (when set) |
| 👥 People going | ⭐ People interested | ✉️ People invited |
| 📍 Place name, link and coordinates | 🏠 Address (when set) | 🌆 City |
| 🧑‍💼 Hosts and their Pages | 🎟️ Tickets link and price (when set) | 🖼️ Cover image and its description |
| 📄 Description | 🔗 Links in the description | 🏷️ Categories (when set) |
| 🌐 Online or in person | ❌ Canceled or not | 🔁 Repeating events and their number of dates |

### How to scrape Facebook events

1. [Create a free Apify account](https://console.apify.com/sign-up) (no credit card needed).
2. Open **Facebook Events Scraper**.
3. Type one or more **searches**, for example `Comedy New York`, or paste **Page or event links**.
4. Choose how many events you want per search or link and click **Start**.
5. When the run finishes, download your events as Excel, CSV, JSON, HTML or XML.

### How much does it cost to scrape Facebook events?

You pay only for the events you get, per 1,000 events. See the **Pricing** tab for the current price. Every Apify account gets **$5 of free usage each month**, so you can try it at no cost.

### ⬇️ Input

| Setting | What it does |
|---|---|
| Search events | Words to search for: a topic (`Comedy`), a place (`Chicago`) or both (`Jazz Chicago`) |
| Or Facebook Page, event or search links | Page links (upcoming and past events), event links, or Facebook event search links with filters |
| Max events per search or link | How many events to get from each search or link. Leave it empty to get every event it lists |

A Page link (`https://www.facebook.com/NASA`) gives the Page's upcoming events, then its past events. Add `/upcoming_hosted_events` or `/past_hosted_events` to the link to get only one of the two.

To use Facebook's search filters (dates, categories, places), search for events on Facebook without logging in, set the filters, and paste the address of the results page, for example `https://www.facebook.com/events/search/?q=yoga&filters=...`.

Example: two searches, 50 events each.

```json
{
  "searchQueries": ["Comedy New York", "Jazz Chicago"],
  "maxEvents": 50
}
```

Example: a Page's events and one event.

```json
{
  "startUrls": [
    "https://www.facebook.com/NASA",
    "https://www.facebook.com/events/1474625497812411/"
  ]
}
```

### ⬆️ Output

You get one row per event. You can view them as a table in Apify Console or download them as Excel, CSV, JSON, HTML or XML.

```json
{
  "inputUrl": "https://www.facebook.com/events/1474625497812411/",
  "url": "https://www.facebook.com/events/1474625497812411/",
  "id": "1474625497812411",
  "name": "MAX POWER",
  "eventFrequency": "SINGLE",
  "dateTimeSentence": "Nov 7 at 8:30 AM – Nov 8 at 6:00 PM EST",
  "utcStartDate": "2026-11-07T13:30:00.000Z",
  "utcEndDate": "2026-11-08T23:00:00.000Z",
  "startTime": "Sat, Nov 7 - Nov 8",
  "timezone": "EST",
  "imageUrl": "https://scontent-iad3-1.xx.fbcdn.net/v/t15.5256-10/819482081_2773846676346553_8509656209476314532_n.jpg?...",
  "imageCaption": null,
  "coverVideo": {"id": "1450137903652075", "url": "https://www.facebook.com/NASA/videos/1450137903652075/"},
  "isCanceled": false,
  "isPast": false,
  "isOnline": false,
  "address": "Rocket Garden, Nasa Pkwy W, Kennedy Space Center, FL 32899, United States",
  "location": {
    "url": null,
    "id": "1645814333580603",
    "name": "NASA-John F. Kennedy Space Center",
    "contextualName": "NASA-John F. Kennedy Space Center",
    "placeType": "TEXT",
    "latitude": 28.52357018035,
    "longitude": -80.681567755658,
    "streetAddress": null,
    "city": "Merritt Island, Florida"
  },
  "duration": "2 days",
  "description": "America’s newest and most exciting aerospace technology expo and air show is landing in Florida this November! ...",
  "usersResponded": 508,
  "usersGoing": 76,
  "usersInterested": 432,
  "usersInvited": 29,
  "ticketsInfo": {
    "buyUrl": "https://www.nasa.gov/maxpower/",
    "title": "Tickets",
    "subtitle": "www.nasa.gov/maxpower",
    "ticketProvider": null
  },
  "organizedBy": "Event by NASA - National Aeronautics and Space Administration",
  "organizators": [
    {"id": "100044561550831", "url": "https://www.facebook.com/NASA", "name": "NASA - National Aeronautics and Space Administration", "isVerified": true}
  ],
  "eventType": "PUBLIC",
  "discoveryCategories": [],
  "externalLinks": ["https://www.nasa.gov/maxpower/"],
  "hasChildEvents": false,
  "childEventsCount": 0
}
```

Each run also saves a short report with how many searches, links and events it covered, and any link it could not scrape with the reason (for example, an event that was deleted or is not public).

### How can I use Facebook events data?

- **Event discovery:** build listings of concerts, classes, meetups and festivals in a city
- **Market research:** see which events draw the most people going and interested
- **Lead generation:** find venues, promoters and organizers that host events
- **Competitor monitoring:** follow the events other venues and brands host
- **Local marketing:** plan your own events around what is already on in your area

### ❓FAQ

#### How many events can I get from one search?

Facebook shows visitors a limited list for each search: from a handful to a few hundred events in our tests, depending on the words (for example about 30 for `music`, 60 for `comedy` and over 200 for `yoga`). The list also changes between runs. To get more, run several searches (for example a topic with different cities) or use Facebook's date filters through a search link.

#### How many events can I get from a Page?

Every upcoming and past event the Page shows to visitors.

#### Why are the going and interested numbers different from what I see on Facebook?

They are the numbers Facebook shows at the time of the run. They change as people answer.

#### Why is there no end date for some events?

The host did not set one. Facebook then shows only the start.

#### What about repeating events?

A repeating event (for example a weekly class) comes back once, with the date and link of its next date, `eventFrequency` (such as `WEEKLY`) and `childEventsCount`, the number of its dates.

#### Why does a link come back as "not found"?

The Page or event does not exist, is not public, or the Page does not show events to visitors. Such links are listed in the run report; they do not fail the run.

#### Do I need a Facebook account?

No. You don't need a Facebook account, cookies or an API key.

#### Can I connect Facebook Events Scraper to other tools or AI agents?

Yes. Start runs and download results with the Apify API or the Python and JavaScript clients, send results to Make, Zapier, n8n, Google Sheets or Slack with Apify integrations and webhooks, or let AI assistants and agents run it through the Apify MCP server at [mcp.apify.com](https://mcp.apify.com).

#### Is it legal to scrape Facebook events?

This scraper only collects events that their hosts chose to make public. It does not collect private data such as e-mail addresses or phone numbers, or the names of the people who answered. Event data can still contain personal data, which may be protected by laws such as GDPR, so only scrape it for a legitimate reason and ask a lawyer if you are unsure. You can read more in [Is web scraping legal?](https://blog.apify.com/is-web-scraping-legal/)

Facebook Events Scraper is an independent tool. It is not affiliated with, endorsed by or sponsored by Facebook or Meta.

#### Something isn't working. What should I do?

Open the **Issues** tab and tell us the search or link and what you expected. We usually reply within a day.

### Scrape more Facebook data

| Actor | What it gets |
|---|---|
| [Facebook Posts Scraper](https://apify.com/automly/facebook-page-posts-scraper) | Posts from public Pages, with reactions, comments and shares counts |
| [Facebook Pages Scraper](https://apify.com/automly/facebook-page-details-scraper) | Followers, category and contact details of many Pages |
| [Facebook Comments Scraper](https://apify.com/automly/facebook-post-comments-scraper) | Comments and replies from public posts |

### ⭐ Your feedback

Ideas, missing fields or problems: open the **Issues** tab and we'll take a look. If Facebook Events Scraper saved you time, a short review on the **Reviews** tab helps other people find it.

# Actor input Schema

## `searchQueries` (type: `array`):

Words to search Facebook events for, e.g. a topic (Comedy), a place (Chicago) or both (Jazz Chicago). Each search is one list of results.

## `startUrls` (type: `array`):

Page links to get the Page's upcoming and past events (e.g. https://www.facebook.com/NASA; add /upcoming_hosted_events or /past_hosted_events for just one of the two), event links (https://www.facebook.com/events/1474625497812411/), or Facebook event search links, filters included (https://www.facebook.com/events/search/?q=yoga).

## `maxEvents` (type: `integer`):

The most events to get from each search or link, e.g. 30. Leave empty to get every event it lists.

## Actor input object example

```json
{
  "searchQueries": [
    "Comedy New York"
  ],
  "startUrls": [
    "https://www.facebook.com/NASA"
  ],
  "maxEvents": 30
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

## `results` (type: `string`):

No description

## `report` (type: `string`):

No description

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQueries": [
        "Comedy New York"
    ],
    "startUrls": [],
    "maxEvents": 30
};

// Run the Actor and wait for it to finish
const run = await client.actor("automly/facebook-events-scraper").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQueries": ["Comedy New York"],
    "startUrls": [],
    "maxEvents": 30,
}

# Run the Actor and wait for it to finish
run = client.actor("automly/facebook-events-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQueries": [
    "Comedy New York"
  ],
  "startUrls": [],
  "maxEvents": 30
}' |
apify call automly/facebook-events-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,automly/facebook-events-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/rvjE7hi4AEN67hKj3/builds/jbZiaLgpuJOZZlbNN/openapi.json