{ "openapi": "3.0.1", "info": { "title": "๐ŸŽ‰ Facebook Events Scraper โ€” Organizer & Contact Details โœจ", "description": "Scrapes events from any public Facebook page, group, or search result, capturing event titles, dates, locations, hosts, attendance counts, descriptions, and URLs. Ideal for market research, local event tracking, trend analysis, and automated data extraction at scale", "version": "0.1", "x-build-id": "RTKSiQgobJVIFfRZo" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapio~facebook-events-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapio-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/scrapio~facebook-events-scraper/runs": { "post": { "operationId": "runs-sync-scrapio-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/scrapio~facebook-events-scraper/run-sync": { "post": { "operationId": "run-sync-scrapio-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": "๐Ÿ’ญ Think like your audience: words they'd type into Facebook search.\n\nโœ… Examples: ๐ŸŽท jazz night ยท ๐Ÿƒ running club ยท ๐Ÿ’ป tech meetups ยท ๐ŸŽจ art fair ยท ๐Ÿท wine tasting ยท ๐ŸŽค stand-up comedy.\n\n๐Ÿ“Œ One query per line โ€” each line is its own search theme.\n\n๐Ÿ“‹ Got a long list? Paste it in for a bulk run โ€” every query is processed in order.\n\n๐Ÿš€ Sharper queries โ†’ cleaner matches โ†’ happier exports!", "items": { "type": "string" } }, "maxEvents": { "title": "๐Ÿ“Œ Max events per query", "minimum": 1, "maximum": 1000, "type": "integer", "description": "๐ŸŽฏ Set your ceiling: stop after this many events for **each** keyword.\n\nโฌ‡๏ธ Lower = โšก faster runs & ๐Ÿ’ฐ lower spend (great for testing).\n\nโฌ†๏ธ Higher = ๐Ÿ“š broader coverage & richer datasets (great for production).\n\n๐Ÿ“Š Allowed: **1 โ€“ 1000** ยท ๐ŸŒฑ Default **10** is a safe, friendly starting point.", "default": 10 }, "enrichOrganizerContact": { "title": "๐Ÿ“‡ Enrich organizer contact & business details", "type": "boolean", "description": "๐Ÿ“ž ๐Ÿ“ง ๐ŸŒ When ON, the Actor fetches the organizer's own Facebook Page once per unique host and extracts email, phone, website, follower count, business category, and verified-badge status.\n\n๐Ÿง‘ Only applies when the organizer resolves to a real Facebook **Page** (not a personal profile) โ€” those stay honestly `null`, never guessed.\n\nโœ… Default: **ON**.", "default": true }, "checkOrganizerAdsLibrary": { "title": "๐Ÿ“ข Check organizer's Facebook Ads Library activity", "type": "boolean", "description": "๐Ÿ” When ON, the Actor searches Facebook's public Ads Library for the organizer's Page and reports whether it's **currently running ads** โ€” a strong buying-intent signal for B2B outreach.\n\n๐ŸŽฏ This is a **best-effort fuzzy match** (by Page ID when known, otherwise by name similarity) โ€” a real match confidence (`confirmed_id_match` / `high_name_match` / `medium_name_match` / `no_match`) is always reported alongside the flag so you can judge reliability yourself. Never a guessed true/false.\n\nโœ… Default: **ON**.", "default": true }, "proxyConfiguration": { "title": "๐Ÿ”Œ Proxy configuration (recommended)", "type": "object", "description": "๐ŸŒ Route traffic through Apify Proxy to dodge blocks and reduce failed pages.\n\n๐Ÿ  **Residential IPs** usually work best with Facebook and are used automatically as the sensible default when you leave this untouched.\n\n๐ŸŽ›๏ธ Make an explicit choice here (including turning proxy fully OFF) and the Actor will respect it instead of silently overriding you.\n\n๐Ÿ’ก **Tip:** For larger campaigns or production workloads, keep proxy ON. โœ…" } } }, "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 } } } } } } } } } }