# Facebook Events Scraper (`unfenced-group/facebook-events-scraper`) Actor Scrape public Facebook events by keyword, city, page, or URL. Get names, full descriptions, dates, geo-coordinates, ticket links, hosts, and exact going and interested counts. Four modes, no Facebook account, no API key. Pay only per result. - **URL**: https://apify.com/unfenced-group/facebook-events-scraper.md - **Developed by:** [Unfenced Group](https://apify.com/unfenced-group) (community) - **Categories:** Social media - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.84 / 1,000 list results 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/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 ## Facebook Events Scraper ![Facebook Events Scraper](https://api.apify.com/v2/key-value-stores/lJlifu6C8YQfZMPKE/records/facebook-events-scraper) Extract public Facebook events at scale, with the richest field set available: full descriptions, precise geo-coordinates, ticketing links, hosts, and exact going and interested counts. No Facebook account required. --- ### Why this scraper? #### ๐Ÿ”Ž Four ways to find events Search by keyword, list every event in a city, pull all events hosted by a page or organizer, or fetch full detail for specific event URLs. One actor covers all four. #### ๐Ÿ“„ Complete event data Event name, full description, date and time, duration, and the online-or-in-person flag. Detail mode returns every field Facebook publishes for an event. #### ๐Ÿ“ Precise location Venue name, full address, city, and exact latitude and longitude, so events can be mapped or filtered by area. #### ๐ŸŽŸ๏ธ Ticketing and hosts Ticket URL where the event sells tickets, the event creator, and every co-host with their page URL and type. #### ๐Ÿ“Š Real engagement numbers Exact going and interested counts, not rounded text. See which events draw a crowd. #### ๐Ÿ’ถ No account, no API key Runs without a Facebook login. Datacenter proxy by default for speed and low cost, with residential available for high volume. --- ### Input parameters | Parameter | Type | Default | Description | |---|---|---|---| | `mode` | string | `"search"` | What to scrape: `search` (by keyword), `city` (by city URL), `page` (by page or organizer), or `detail` (by event URL). | | `searchQueries` | array | (empty) | Keywords to search, used when `mode` is `search`. Each keyword is searched separately. | | `cityUrls` | array | (empty) | Facebook city event URLs, used when `mode` is `city`. | | `pageUrls` | array | (empty) | Page or organizer URLs or usernames, used when `mode` is `page`. Accepts a full URL or a bare username. | | `eventUrls` | array | (empty) | Specific event URLs to fetch full detail for, used when `mode` is `detail`. | | `maxResults` | integer | `100` | Maximum number of events to return per run. | | `fetchDetails` | boolean | `true` | For search, city and page modes: fetch the full detail record for each event. Uses one extra request per event. Turn off for a faster, cheaper list-only run. | | `dateFrom` | string | (empty) | Optional. Only return events starting on or after this date (YYYY-MM-DD). | | `dateTo` | string | (empty) | Optional. Only return events starting on or before this date (YYYY-MM-DD). | | `proxyConfiguration` | object | Datacenter | Proxy settings. Defaults to Apify datacenter proxy. Switch to Residential if you hit blocks at high volume. | --- ### Output schema Two record shapes are returned. List modes (search, city, page) without enrichment return the core fields below. Detail mode, and any list run with `fetchDetails` on, returns the full record. Fields the source does not publish for a given event are returned as `null` rather than omitted. #### Core fields (always present) | Field | Type | Description | |---|---|---| | `id` | string | Facebook event ID. | | `name` | string | Event name. | | `url` | string | Event URL. | | `event_kind` | string | Facebook's event kind classifier. | | `type` | string | Event type or node type. | | `day_time_sentence` | string | Human-readable date and time, e.g. "Sat, Jul 4 at 4:00 PM EDT". | | `start_timestamp` | integer | Event start as a Unix timestamp. | | `start_time` | string | Event start as an ISO 8601 datetime. | | `is_past` | boolean | Whether the event has already happened. | | `is_online` | boolean | Whether the event is online. | | `is_happening_now` | boolean | Whether the event is currently live. | | `location_name` | string | Venue or place name. | | `place_id` | string | Facebook place ID. | | `latitude` | number | Venue latitude. Populated in detail mode. | | `longitude` | number | Venue longitude. Populated in detail mode. | | `price_range_text` | string | Price range text where the list feed publishes it. | | `interested_count` | integer | Number of people interested. | | `going_count` | integer | Number of people going. | | `social_context_text` | string | Raw engagement text, e.g. "4K interested ยท 134 going". | | `cover_photo_url` | string | Event cover photo URL. | | `scraped_at` | string | ISO 8601 timestamp of when the record was scraped. | #### Additional fields (with `fetchDetails` or in detail mode) | Field | Type | Description | |---|---|---| | `description` | string | Full event description text. | | `one_line_address` | string | Single-line venue address. | | `city` | string | City name from reverse geocode. | | `city_id` | string | Facebook city page ID. | | `place_type` | string | Type of the venue place. | | `privacy_icon` | string | Privacy indicator for the event. | | `duration_text` | string | Duration and price context text where published. | | `display_duration` | string | Human-readable duration where published. | | `ticket_url` | string | External ticket purchase URL where the event sells tickets. | | `categories` | array | Discovery categories Facebook assigns the event. | | `creator` | object | Event creator: `id`, `name`, `type`. | | `hosts` | array | Co-hosts, each with `id`, `name`, `url`, `type`. | | `host_names` | array | Host names as a flat list. | #### Example record ```json { "id": "1585998413155078", "name": "The Fourth: Celebrating America 250 on the St Pete Pier", "url": "https://www.facebook.com/events/1585998413155078/", "event_kind": "PUBLIC_TYPE", "description": "Pier Events, LLC Presents: Celebrate America's 250th Anniversary at the St. Pete Pier.", "one_line_address": "800 2nd Ave NE, Saint Petersburg, FL", "day_time_sentence": "Sat, Jul 4 at 4:00 PM EDT", "start_timestamp": 1751659200, "start_time": "2026-07-04T20:00:00.000Z", "is_online": false, "is_past": false, "location_name": "St. Pete Pier", "place_id": "111326725552547", "latitude": 27.77322, "longitude": -82.62692, "city": "Saint Petersburg, Florida", "city_id": "111326725552547", "ticket_url": null, "interested_count": 4208, "going_count": 134, "creator": { "id": "100064...", "name": "St. Pete Pier", "type": "Page" }, "hosts": [ { "id": "100064...", "name": "St. Pete Pier", "url": "https://www.facebook.com/StPetePier", "type": "Page" }, { "id": "100064...", "name": "City of St. Petersburg, Florida", "url": "https://www.facebook.com/...", "type": "Page" } ], "host_names": ["St. Pete Pier", "City of St. Petersburg, Florida"], "categories": ["Festivals"], "cover_photo_url": "https://scontent.xx.fbcdn.net/...", "scraped_at": "2026-07-03T07:40:00.000Z" } ```` *** ### Examples #### Search by keyword, with full detail ```json { "mode": "search", "searchQueries": ["comedy", "live music"], "maxResults": 200, "fetchDetails": true } ``` #### Every event in a city, within a date window ```json { "mode": "city", "cityUrls": ["https://www.facebook.com/events/explore/amsterdam-netherlands/104032872967849"], "dateFrom": "2026-07-01", "dateTo": "2026-07-31", "maxResults": 500 } ``` #### All events hosted by a page or organizer ```json { "mode": "page", "pageUrls": ["StPetePier", "https://www.facebook.com/nike"], "fetchDetails": true } ``` #### Fast list-only feed, no enrichment ```json { "mode": "search", "searchQueries": ["festival"], "maxResults": 1000, "fetchDetails": false } ``` *** **Daily feed of upcoming events (run on a schedule):** ```json { "searchQueries": ["live music"], "maxResults": 200 } ``` Schedule this input to run once a day in the Apify Scheduler to catch newly published events. ### ๐Ÿ’ฐ Pricing Two result types, each priced separately. You only pay for events returned. Failed retries are never charged. **List result** โ€” an event from search, city or page mode without detail enrichment. **$0.94 per 1,000.** **Detail result** โ€” an event scraped to full detail. **$1.63 per 1,000.** | Results | List cost | Detail cost | |---|---|---| | 100 | ~$0.09 | ~$0.16 | | 1,000 | ~$0.94 | ~$1.63 | | 10,000 | ~$9.40 | ~$16.30 | | 100,000 | ~$94 | ~$163 | Subscription tiers lower both rates further, down to $0.74 per 1,000 list results and $0.89 per 1,000 detail results at the highest tier. Use the **Max results** cap to control your spend exactly. *** ### Performance | Run size | Typical time | |---|---| | 100 events (list only) | under 1 minute | | 100 events (with details) | 1โ€“3 minutes | | 1,000 events (with details) | 10โ€“20 minutes | Detail enrichment fetches one page per event, so runs with it enabled take longer than list-only runs. *** ### Known limitations - Attendee identities are never returned. Only aggregate going and interested counts are available, by design. - Private and invite-only events are not accessible. This scraper covers public events only. - Some events omit end time, duration, ticket price, or categories. Facebook itself does not always publish these. - Coordinates and full address are populated in detail mode, not in list-only output. *** ### Technical details - **Source:** public Facebook events - **Coverage:** global, any keyword, city, or page - **No login required:** does not need a Facebook account - **Retry:** automatic retry on network errors with exponential backoff *** ### Need a custom scraper? **[Unfenced Group](https://www.unfencedgroup.nl)** builds Apify actors for any website โ€” for free. If the site you need isn't in our portfolio yet, just ask. We scope, build, and publish it at no cost to you. You only pay for results โ€” we absorb the compute and proxy costs ourselves. Same pay-per-result pricing, same quality, same standards as every actor in this portfolio. **Get in touch:** [www.unfencedgroup.nl](https://www.unfencedgroup.nl) # Actor input Schema ## `mode` (type: `string`): What to scrape. 'search' finds events by keyword. 'city' lists events for a Facebook city explore URL. 'detail' fetches full data for specific event URLs. ## `searchQueries` (type: `array`): Keywords to search events for (used when mode = search). Each keyword is searched separately, e.g. 'comedy', 'tech conference Amsterdam'. ## `cityUrls` (type: `array`): Facebook city event URLs (used when mode = city), e.g. https://www.facebook.com/events/explore/amsterdam-netherlands/104032872967849 ## `pageUrls` (type: `array`): Facebook page/profile URLs or usernames to pull hosted events from (used when mode = page), e.g. https://www.facebook.com/nike or just "nike". Also accepts /events and /upcoming\_hosted\_events tab URLs directly. ## `eventUrls` (type: `array`): Specific Facebook event URLs to fetch full details for (used when mode = detail), e.g. https://www.facebook.com/events/1234567890/ ## `maxResults` (type: `integer`): Maximum number of events to return per run. ## `fetchDetails` (type: `boolean`): For search and city modes: fetch the full detail record for each event (ticketing, geo coordinates, hosts, description, exact going/interested counts). Uses one extra API credit per event. Turn off for faster, cheaper list-only output. ## `dateFrom` (type: `string`): Optional. Only return events starting on or after this date. ## `dateTo` (type: `string`): Optional. Only return events starting on or before this date. ## `proxyConfiguration` (type: `object`): Proxy settings. Defaults to Apify datacenter proxy, which is fast and reliable for Facebook event pages. Switch to Residential if you hit blocks at high volume. ## Actor input object example ```json { "mode": "search", "searchQueries": [], "cityUrls": [], "pageUrls": [], "eventUrls": [], "maxResults": 100, "fetchDetails": true, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `results` (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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("unfenced-group/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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "proxyConfiguration": { "useApifyProxy": True } } # Run the Actor and wait for it to finish run = client.actor("unfenced-group/facebook-events-scraper").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 '{ "proxyConfiguration": { "useApifyProxy": true } }' | apify call unfenced-group/facebook-events-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=unfenced-group/facebook-events-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Facebook Events Scraper", "description": "Scrape public Facebook events by keyword, city, page, or URL. Get names, full descriptions, dates, geo-coordinates, ticket links, hosts, and exact going and interested counts. Four modes, no Facebook account, no API key. Pay only per result.", "version": "0.0", "x-build-id": "LlHHjHYBkQPhqkSuc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/unfenced-group~facebook-events-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-unfenced-group-facebook-events-scraper", "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/unfenced-group~facebook-events-scraper/runs": { "post": { "operationId": "runs-sync-unfenced-group-facebook-events-scraper", "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/unfenced-group~facebook-events-scraper/run-sync": { "post": { "operationId": "run-sync-unfenced-group-facebook-events-scraper", "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", "properties": { "mode": { "title": "Mode", "enum": [ "search", "city", "page", "detail" ], "type": "string", "description": "What to scrape. 'search' finds events by keyword. 'city' lists events for a Facebook city explore URL. 'detail' fetches full data for specific event URLs.", "default": "search" }, "searchQueries": { "title": "Search queries", "type": "array", "description": "Keywords to search events for (used when mode = search). Each keyword is searched separately, e.g. 'comedy', 'tech conference Amsterdam'.", "default": [], "items": { "type": "string" } }, "cityUrls": { "title": "City explore URLs", "type": "array", "description": "Facebook city event URLs (used when mode = city), e.g. https://www.facebook.com/events/explore/amsterdam-netherlands/104032872967849", "default": [], "items": { "type": "string" } }, "pageUrls": { "title": "Page or organizer URLs", "type": "array", "description": "Facebook page/profile URLs or usernames to pull hosted events from (used when mode = page), e.g. https://www.facebook.com/nike or just \"nike\". Also accepts /events and /upcoming_hosted_events tab URLs directly.", "default": [], "items": { "type": "string" } }, "eventUrls": { "title": "Event URLs", "type": "array", "description": "Specific Facebook event URLs to fetch full details for (used when mode = detail), e.g. https://www.facebook.com/events/1234567890/", "default": [], "items": { "type": "string" } }, "maxResults": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Maximum number of events to return per run.", "default": 100 }, "fetchDetails": { "title": "Fetch full event details", "type": "boolean", "description": "For search and city modes: fetch the full detail record for each event (ticketing, geo coordinates, hosts, description, exact going/interested counts). Uses one extra API credit per event. Turn off for faster, cheaper list-only output.", "default": true }, "dateFrom": { "title": "Date from (YYYY-MM-DD)", "type": "string", "description": "Optional. Only return events starting on or after this date." }, "dateTo": { "title": "Date to (YYYY-MM-DD)", "type": "string", "description": "Optional. Only return events starting on or before this date." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Defaults to Apify datacenter proxy, which is fast and reliable for Facebook event pages. Switch to Residential if you hit blocks at high volume.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```