{ "openapi": "3.0.1", "info": { "title": "Facebook Events Scraper", "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": "vZQRmah5Z5sn2dZH2" }, "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": "πŸ’­ 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 }, "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 β€” enable **Use Apify Proxy** and pick groups that match your plan.\n\nβš™οΈ If proxy setup fails, the run may continue without a proxy (less reliable, but it keeps moving).\n\nπŸ’‘ **Tip:** For larger campaigns or production workloads, always run with 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 } } } } } } } } } }