{ "openapi": "3.0.1", "info": { "title": "Facebook Events Scraper: Comments & Engagement Insights", "description": "The Facebook Events Scraper extracts detailed event data from Facebook, including event names, dates, locations, descriptions, and attendee counts. Perfect for marketers, analysts, and researchers to track trends, discover local events, and analyze engagement across communities.", "version": "0.1", "x-build-id": "OIBpit7cs6adtgljv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api-empire~facebook-events-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api-empire-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/api-empire~facebook-events-scraper/runs": { "post": { "operationId": "runs-sync-api-empire-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/api-empire~facebook-events-scraper/run-sync": { "post": { "operationId": "run-sync-api-empire-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", "required": [ "searchQueries" ], "properties": { "searchQueries": { "title": "🔎 Search queries (required)", "type": "array", "description": "Words your audience would type into Facebook event search.\n\nExamples: jazz night · running club · tech meetups · art fair · wine tasting · stand-up comedy.\n\nOne query per line — every query is processed in order and results are merged into one dataset.", "items": { "type": "string" } }, "maxEvents": { "title": "📌 Max events per query", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Stop after this many events for EACH search query.\n\nLower = faster/cheaper test runs. Higher = broader coverage.\n\nAllowed: 1–1000. Default 10.", "default": 10 }, "minGoing": { "title": "✅ Minimum 'Going' count", "minimum": 0, "type": "integer", "description": "Only keep events where usersGoing is at least this number. Set 0 to disable this filter.\n\nDefault 0 (no filter).", "default": 0 }, "minInterested": { "title": "🌟 Minimum 'Interested' count", "minimum": 0, "type": "integer", "description": "Only keep events where usersInterested is at least this number. Set 0 to disable this filter.\n\nDefault 0 (no filter).", "default": 0 }, "fetchDiscussionComments": { "title": "💬 Attempt to fetch discussion comments", "type": "boolean", "description": "When enabled, the actor checks each event's own page (already fetched for enrichment, so this adds no extra page load unless comments are actually found) for a public discussion/comments feed and collects any comments it detects.\n\nHonest coverage note: Facebook does not expose a discussion feed on every public event the same way it does on posts — many events will legitimately come back with discussionCommentsAvailable=false and a null comments list. That is a correct, verified result, not a bug. See the README for measured coverage.\n\nDefault ON (the check itself is cheap even when no feed is found).", "default": true }, "maxDiscussionComments": { "title": "🗨️ Max discussion comments per event", "minimum": 0, "maximum": 200, "type": "integer", "description": "Cap on discussion comments collected per event, only relevant when a discussion feed is actually detected on that event (see fetchDiscussionComments above).\n\nAllowed: 0–200. Default 20.", "default": 20 }, "proxyConfiguration": { "title": "🔌 Proxy configuration", "type": "object", "description": "Shown for interface consistency with sibling actors, but Facebook requests in this actor always route through Apify's RESIDENTIAL proxy group -- this is enforced in code and is NOT overridable via this input (datacenter/no-proxy selections here are ignored). This is a deliberate reliability decision: Facebook blocks non-residential IPs aggressively." } } }, "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 } } } } } } } } } }