{ "openapi": "3.0.1", "info": { "title": "Facebook Events Scraper", "description": "Find public Facebook events by keyword, city, organizer Page or event URL. Get dates with time zones, venues with coordinates, organizers, ticket links, cover images and attendance counts. No Facebook login or cookies needed.", "version": "1.0", "x-build-id": "EgUmtjrPU1D1f7MOt" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/coregent~facebook-events-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-coregent-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/coregent~facebook-events-scraper/runs": { "post": { "operationId": "runs-sync-coregent-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/coregent~facebook-events-scraper/run-sync": { "post": { "operationId": "run-sync-coregent-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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Keywords to find public Facebook events with, e.g. \"live music\", \"food festival\", \"tech meetup\". Each term is searched day by day across your date range, which finds far more events than a single search. Facebook's logged-out event search is limited per keyword, so several related terms (plus organizer Pages) give the broadest coverage. Up to 100 terms. Leave empty to use only Pages or event URLs.", "default": [], "items": { "type": "string" } }, "pageUrls": { "title": "Facebook Page URLs", "type": "array", "description": "Public Facebook Pages whose events you want — venues, promoters, organizers. A Page URL (https://www.facebook.com/), its handle, or a profile.php?id= link. The best way to get every event of a known organizer.", "default": [], "items": { "type": "string" } }, "eventUrls": { "title": "Facebook event URLs", "type": "array", "description": "Specific public events to read: https://www.facebook.com/events//, a numeric event ID, or a fb.me/e/ short link. A recurring event's occurrence link (…?event_time_id=…) is read as that occurrence.", "default": [], "items": { "type": "string" } }, "maxEvents": { "title": "Maximum events", "minimum": 1, "maximum": 10000, "type": "integer", "description": "The most unique events to deliver in this run, across all inputs. You are charged only for events actually delivered.", "default": 100 }, "maxEventsPerPage": { "title": "Maximum events per Page", "minimum": 1, "maximum": 10000, "type": "integer", "description": "The most events to take from EACH Page in \"Facebook Page URLs\".", "default": 100 }, "eventTiming": { "title": "Event timing", "enum": [ "UPCOMING", "PAST", "ALL" ], "type": "string", "description": "Upcoming events (the default), past events, or both. Checked against each event's own page.", "default": "UPCOMING" }, "startDateFrom": { "title": "Start date from", "type": "string", "description": "Only events starting on or after this date, in the event's own local time. A date (2026-10-24) or a relative date such as \"today\", \"+7 days\" or \"-1 month\".", "default": "" }, "startDateTo": { "title": "Start date to", "type": "string", "description": "Only events starting on or before this date, in the event's own local time. A date (2026-11-30) or a relative date such as \"+30 days\". With search terms and no dates, the next 30 days are searched.", "default": "" }, "eventFormat": { "title": "Event format", "enum": [ "ALL", "IN_PERSON", "ONLINE" ], "type": "string", "description": "In-person events, online events, or both.", "default": "ALL" }, "location": { "title": "Location", "type": "string", "description": "Optional city, e.g. \"Canberra, ACT, Australia\". Search terms are searched together with the city, and every event is checked against its venue: same city kept, nearby places in the same region kept and marked REGION_MATCH, everything else (including events with no venue) dropped. Include the region or country to tell same-named cities apart. Facebook's logged-out search is shallow for a single city — add organizer Pages for depth.", "default": "" }, "locationUrl": { "title": "Facebook city URL or ID", "type": "string", "description": "Optional and advanced. A Facebook city page or events-explore URL ending in the city's numeric ID (e.g. https://www.facebook.com/events/explore/canberra-australian-capital-territory/106270089409734/), or just the ID. Passed to Facebook's own search filter and matched EXACTLY against each venue's city.", "default": "" }, "listOnly": { "title": "Fast list only (skip event pages)", "type": "boolean", "description": "Off (recommended): every event's own page is read, so each row carries its description, end time, venue address and coordinates, organizer and co-hosts, ticket link, cover image and attendance count, and the location filter can check the venue. On: a fast list of event IDs and names (plus dates and cities for Page events) without reading event pages; a location filter then cannot check venues. Direct event URLs are always read.", "default": false }, "maxConcurrency": { "title": "Event pages in parallel", "minimum": 1, "maximum": 30, "type": "integer", "description": "How many event pages are read at the same time. Lower it if you see rate-limit warnings.", "default": 10 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Datacenter proxy is used by default. Apify Residential proxy is not supported and fails the run — use your own residential provider under \"Custom proxy URLs\" if you need one.", "default": { "useApifyProxy": true } }, "debug": { "title": "Debug log", "type": "boolean", "description": "Log every request outcome. For troubleshooting.", "default": false } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }