# Facebook Event Details by URL (`igview-owner/facebook-event-details`) Actor Extract complete Facebook event details by URL: title, date, venue, GPS coordinates, cover image, hosts, ticket links, and response counts in CSV/JSON. - **URL**: https://apify.com/igview-owner/facebook-event-details.md - **Developed by:** [Sachin Kumar Yadav](https://apify.com/igview-owner) (community) - **Categories:** Social media, Automation, MCP servers - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 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. 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 Event Details by URL – Event Scraper **Get complete, rich details of any Facebook event by its URL. Extract event title, description, start/end dates, exact local time, location text, GPS coordinates (lat/lng), hosts, ticket availability, response counts, cover image, related events, and more. Supports scraping multiple event URLs in a single run. Built with Apify best practices for reliability.** --- ### Table of Contents - [Features](#features) - [Use Cases](#use-cases) - [Quick Start](#quick-start) - [Input Parameters](#input-parameters) - [Output Format](#output-format) - [Performance & Limits](#performance--limits) - [FAQ](#faq) - [Troubleshooting](#troubleshooting) - [Why Choose This Actor?](#why-choose-this-actor) - [Tags](#tags) - [Get Started Now](#get-started-now) - [Related Actors](#related-actors) --- ### Features - **Extract Comprehensive Event Details** - Get event title, description, cover photo, hosts, tags, and cancellation status. - **Precise Timing & Schedule** - Retrieve exact start/end dates, times, and pre-formatted local time strings. - **Geographic & Venue Data** - Extract venue name, address, GPS coordinates (latitude & longitude), and venue profile page links. - **Engagement Statistics** - Get the responded count representing interested/going attendees. - **Ticket Check** - Easily identify if the event has external tickets associated with it. - **Discover Related Events** - Extract related event listings recommended by Facebook. - **Bulk Scraping Support** - Provide multiple event URLs (up to 100 per run) to scrape details in parallel. --- ### Use Cases | Use Case | Description | Key Benefits | |----------|-------------|--------------| | Event Aggregation | Aggregate events from various pages and niches into a central calendar or app. | Automate database updates with structured event metadata. | | Competitor & Market Research | Keep track of event launches, sizing, and pricing strategies in your industry. | Extract event descriptions, hosts, and venue locations. | | Geographic Analytics | Use GPS coordinates (lat/lng) to map and plot hot zones of public events. | Plot event density, locate venues, and perform spatial analysis. | | Engagement Tracking | Monitor responded counts for events over time to gauge community interest. | Analyze event popularity, trending activities, and attendance estimates. | | Lead Generation | Extract hosts, co-hosts, and organizer profiles for outreach and sponsorships. | Identify venue managers, event promoters, and business pages. | --- ### Quick Start #### 1. Basic - Simple Event Detail Scraping ```json { "urls": [ "https://www.facebook.com/events/5155026207969598/" ] } ```` #### 2. Bulk - Scrape Multiple Events at Once ```json { "urls": [ "https://www.facebook.com/events/5155026207969598/", "https://www.facebook.com/events/1249846673359547/", "https://www.facebook.com/events/1689625195618347/" ] } ``` *** ### Input Parameters | Parameter | Type | Required | Description | Default | Example | |-----------|------|----------|-------------|---------|---------| | `urls` | Array | Yes | List of Facebook event URLs to scrape. Each entry can be an object with a `url` field or a raw URL string. | `["https://www.facebook.com/events/5155026207969598/"]` | `["https://www.facebook.com/events/5155026207969598/"]` | *** ### Output Format #### Event Result Data Structure ```json { "source": "facebook_event_details", "input_url": "https://www.facebook.com/events/5155026207969598/", "event_id": "5155026207969598", "status": "ok", "title": "Toronto Blue Jays vs. St. Louis Cardinals", "start_date": "2026-07-31", "start_time": "23:07:00", "end_date": "2026-07-31", "end_time": null, "local_formatted_time": "Friday 31 July 2026 at 19:07 EDT", "location_text": "1 Blue Jays Way Gate13, Toronto, ON, Canada M5V1J3", "lat": 43.64203, "lng": -79.3906, "location_place_name": "Physiomed Rogers Centre", "location_place_url": "https://facebook.com/100076952378532", "location_place_description": "Let us make you feel better!!!!You can be assured that you are receiving the most comprehensive approach to your treatment program that we can offer.", "location_from_details": null, "details": "\n\nSale Dates and Times:\n\nPublic Onsale : Thu, 22 Jan 2026 at 10:00 AM\n\nDistrict Drop : Mon, 9 Mar 2026 at 03:00 PM\n", "tags": [], "hosts": [ "BlueJays", "https://www.facebook.com/people/Physiomed-Rogers-Centre/100076952378532/" ], "cover_image_url": "https://scontent.fasu9-1.fna.fbcdn.net/v/t39.30808-6/616836498_1346003927568161_1408195293951945551_n.jpg...", "responded_count": 18, "has_tickets": true, "is_canceled": false, "related_events": [ { "event_id": "1249846673359547", "url": "https://www.facebook.com/events/1249846673359547/", "title": "Toronto Tempo vs. Dallas Wings" }, { "event_id": "1689625195618347", "url": "https://www.facebook.com/events/1689625195618347/", "title": "Día de los trabajadores " } ], "scraped_at": "2026-07-05T02:56:36.430Z" } ``` #### Output Fields Explained | Field | Type | Description | |-------|------|-------------| | `source` | String | Source indicator, always `facebook_event_details` | | `input_url` | String | The exact Facebook event URL provided as input | | `event_id` | String | Facebook's unique identifier for the event | | `status` | String | API retrieval status (e.g., `ok`) | | `title` | String | The title of the Facebook event | | `start_date` | String | Start date of the event in YYYY-MM-DD format | | `start_time` | String | Start time of the event in HH:MM:SS format | | `end_date` | String | End date of the event in YYYY-MM-DD format | | `end_time` | String | End time of the event (or null if not provided) | | `local_formatted_time` | String | Human-readable schedule helper showing date, time, and timezone context | | `location_text` | String | Full text address of the venue / location | | `lat` | Float | Latitude coordinate of the venue for mapping | | `lng` | Float | Longitude coordinate of the venue for mapping | | `location_place_name` | String | Named Facebook Place or venue representing the event location | | `location_place_url` | String | URL pointer to the Facebook Page of the venue | | `location_place_description` | String | Short description/intro of the venue Facebook page | | `location_from_details` | String | Additional specific details about locating the event | | `details` | String | Full HTML-cleaned description body text of the event | | `tags` | Array | Relevant tags or categories associated with the event | | `hosts` | Array | List of page names and links representing organizers/hosts | | `cover_image_url` | String | Link to the high-resolution event header/banner image | | `responded_count` | Integer | Estimated counts of users who clicked "Going" or "Interested" | | `has_tickets` | Boolean | True if the event links to an external ticket purchasing platform | | `is_canceled` | Boolean | True if the organizer has marked the event as canceled | | `related_events` | Array | List of suggested events featuring `event_id`, `url`, and `title` | | `scraped_at` | String | ISO timestamp of extraction | *** ### Performance & Limits - **Batching** - Results are pushed to datasets in batches of 10 to ensure safety against network drops. - **Parallel Crawling** - Input URLs are processed systematically, with optimized delay parameters to maximize safety. *** ### FAQ - **Q: Do I need a Facebook account to scrape event details?** - No. This actor handles all requests using public server proxies and API keys, so no personal accounts or cookies are needed. - **Q: Can I extract attendees' profiles?** - No, due to privacy rules and API scopes, only aggregated attendance counts (`responded_count`) are returned. - **Q: Can I scrape private Facebook events?** - No. Only public Facebook events accessible to everyone can be parsed and scraped. - **Q: Why does the cover image link fail after some time?** - Facebook CDN links are temporary. You should download or cache images if you need long-term access. *** ### Troubleshooting | Issue | Cause | Solution | |-------|-------|----------| | Empty details / Error returned | The event might be private, deleted, or geoblocked | Confirm you can access the event URL in an incognito window | | Invalid URL schema | The input URL format is not recognized | Check that the URL matches `https://www.facebook.com/events/ID/` | | "Network error" / Slow responses | Large queue of URLs or rate limits | Restrict the number of URLs scraped per batch, or wait a few minutes before retrying | *** ### Why Choose This Actor? - **Zero setup** - No cookies or login configurations required. - **Rich Output** - Returns complete geodata (lat/lng) and related event nodes. - **Safe Execution** - Dynamic key-rotation means low block rates. - **Convenient Exports** - Clean output formats ready for Google Sheets, CRM, or marketing systems. *** ### Tags `facebook event scraper`, `facebook events details`, `facebook event coordinates`, `facebook event ticket link`, `facebook venue scraper`, `facebook business page events`, `event calendar api`, `apify actor` *** ### Get Started Now 1. Provide the list of target **Event URLs** (e.g., `https://www.facebook.com/events/5155026207969598/`) 2. Click **Start** to run the scraper 3. Export details in JSON, CSV, or Excel format 4. Click ["Try for free"](https://apify.com?fpr=ykgg9c) to test the actor *** ### Related Actors - **[Facebook Events Search Scraper](https://apify.com/igview-owner/facebook-events-search)** - Search and discover events on Facebook by keyword. - **[Facebook Page Search Scraper](https://apify.com/igview-owner/facebook-page-search)** - Find Facebook page details and IDs. - **[Facebook Ads Library Scraper](https://apify.com/igview-owner/facebook-ads-search)** - Extract ad campaigns and designs. *Built using Apify Platform | Optimized for Performance & Reliability* # Actor input Schema ## `urls` (type: `array`): 📎 Enter one or more Facebook event URLs (e.g., https://www.facebook.com/events/5155026207969598/). You can search and find Facebook event URLs using our Facebook Events Search Scraper (https://apify.com/igview-owner/facebook-events-search). ## Actor input object example ```json { "urls": [ { "url": "https://www.facebook.com/events/5155026207969598/" } ] } ``` # Actor output Schema ## `events_overview` (type: `string`): Open the dataset view with an overview of all events including title, date, location, hosts, and more. # 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 = { "urls": [ { "url": "https://www.facebook.com/events/5155026207969598/" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("igview-owner/facebook-event-details").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 = { "urls": [{ "url": "https://www.facebook.com/events/5155026207969598/" }] } # Run the Actor and wait for it to finish run = client.actor("igview-owner/facebook-event-details").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 '{ "urls": [ { "url": "https://www.facebook.com/events/5155026207969598/" } ] }' | apify call igview-owner/facebook-event-details --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=igview-owner/facebook-event-details", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Facebook Event Details by URL", "description": "Extract complete Facebook event details by URL: title, date, venue, GPS coordinates, cover image, hosts, ticket links, and response counts in CSV/JSON.", "version": "1.0", "x-build-id": "M9blIr24126dxCgYN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/igview-owner~facebook-event-details/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-igview-owner-facebook-event-details", "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/igview-owner~facebook-event-details/runs": { "post": { "operationId": "runs-sync-igview-owner-facebook-event-details", "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/igview-owner~facebook-event-details/run-sync": { "post": { "operationId": "run-sync-igview-owner-facebook-event-details", "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": [ "urls" ], "properties": { "urls": { "title": "🔗 Event URLs", "minItems": 1, "maxItems": 100, "type": "array", "description": "📎 Enter one or more Facebook event URLs (e.g., https://www.facebook.com/events/5155026207969598/). You can search and find Facebook event URLs using our Facebook Events Search Scraper (https://apify.com/igview-owner/facebook-events-search).", "default": [ { "url": "https://www.facebook.com/events/5155026207969598/" } ], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } } } }, "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 } } } } } } } } } } ```