{ "openapi": "3.0.1", "info": { "title": "Facebook Events Scraper - Events & Organizers", "description": "Scrape Facebook Page events without login: event name, exact start and end times, description, venue, ticket link and cancelled status, plus the organizer behind every event with their Page name, URL and ID. Filter by date or upcoming only, with monitor mode for new events.", "version": "0.1", "x-build-id": "1erBeDSLzf3cYv6cp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapesage~facebook-events-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapesage-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/scrapesage~facebook-events-scraper/runs": { "post": { "operationId": "runs-sync-scrapesage-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/scrapesage~facebook-events-scraper/run-sync": { "post": { "operationId": "run-sync-scrapesage-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": { "pages": { "title": "Facebook pages", "type": "array", "description": "Page slugs or URLs whose events you want, e.g. natgeo or https://www.facebook.com/natgeo/. Facebook does not serve its event SEARCH to logged-out visitors, so this actor works from pages and event URLs.", "items": { "type": "string" } }, "eventUrls": { "title": "Event URLs or IDs", "type": "array", "description": "Specific events, e.g. https://www.facebook.com/events/1455908518036875/ or the bare numeric id.", "items": { "type": "string" } }, "includeEventDetails": { "title": "Include event details (exact times, description, tickets)", "type": "boolean", "description": "Opens each event to add the exact start and end timestamps, full description, ticket link and event kind - the fields the page listing does not carry. Billed as the eventDetail event.", "default": true }, "upcomingOnly": { "title": "Upcoming events only", "type": "boolean", "description": "Return only events starting in the future. Needs event details, which carry the real start timestamp. Note many Pages list only past events.", "default": false }, "excludeCanceled": { "title": "Exclude cancelled events", "type": "boolean", "description": "Drop events Facebook has marked cancelled.", "default": true }, "startAfter": { "title": "Starts after", "type": "string", "description": "Only events starting on or after this date (YYYY-MM-DD)." }, "startBefore": { "title": "Starts before", "type": "string", "description": "Only events starting on or before this date (YYYY-MM-DD)." }, "maxResults": { "title": "Maximum events", "minimum": 0, "type": "integer", "description": "Total events across all inputs. 0 means no limit (the run's time budget stops it safely).", "default": 100 }, "onlyNewEvents": { "title": "Monitor mode - only new events", "type": "boolean", "description": "Remembers events already returned for this target set and emits only unseen ones. Ideal on a schedule for tracking a venue or promoter roster.", "default": false }, "concurrency": { "title": "Concurrency", "minimum": 1, "maximum": 6, "type": "integer", "description": "Parallel event-detail fetches. Keep at 3 or below to respect the per-IP rate limits.", "default": 3 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "RESIDENTIAL is the tested default and strongly recommended.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }