{
"openapi": "3.0.1",
"info": {
"title": "Facebook Events Scraper",
"description": "Scrape public Facebook events with full details: dates, venue, address, GPS, tickets, hosts, going and interested counts, recurring dates. From event links, pages, groups, cities or keyword search with city, date and category filters. No login.",
"version": "0.0",
"x-build-id": "Vy6ms2mUddIrgh1s4"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/calm_builder~facebook-events-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-calm_builder-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/calm_builder~facebook-events-scraper/runs": {
"post": {
"operationId": "runs-sync-calm_builder-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/calm_builder~facebook-events-scraper/run-sync": {
"post": {
"operationId": "run-sync-calm_builder-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": {
"startUrls": {
"title": "Facebook links",
"type": "array",
"description": "One link per line. Any mix of:
• an event: https://www.facebook.com/events/1234567890
• a page or profile (collects its events): https://www.facebook.com/pagename
• a public group (collects its events): https://www.facebook.com/groups/groupname
• a city's events page: https://www.facebook.com/events/explore/london-united-kingdom/106078429431815/",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"searchQueries": {
"title": "Search terms",
"type": "array",
"description": "Find events by keyword, for example jazz or tech meetup. Each term is searched in every city below (or worldwide when no city is set).",
"items": {
"type": "string"
}
},
"locations": {
"title": "Cities",
"type": "array",
"description": "City names such as London or Paris, France. With search terms, each term is searched in each city. Without search terms, every upcoming event Facebook lists for the city is collected.",
"items": {
"type": "string"
}
},
"maxEvents": {
"title": "Maximum events per source",
"minimum": 1,
"maximum": 10000,
"type": "integer",
"description": "Stop after this many events from each link, each search term in each city, and each city.",
"default": 50
},
"eventTime": {
"title": "Page and group events",
"enum": [
"upcoming",
"past",
"all"
],
"type": "string",
"description": "Which of a page's or group's events to collect. Searches and cities always return upcoming events.",
"default": "upcoming"
},
"startDateFrom": {
"title": "Starting on or after",
"type": "string",
"description": "Keep only events that start on or after this date, for example 2026-11-01, today or +7 days."
},
"startDateTo": {
"title": "Starting on or before",
"type": "string",
"description": "Keep only events that start on or before this date, for example 2026-11-30 or +1 month."
},
"categories": {
"title": "Categories (search only)",
"type": "array",
"description": "Search only events in these Facebook categories. Applies to search terms.",
"items": {
"type": "string",
"enum": [
"Classics",
"Comedy",
"Crafts",
"Dance",
"Drinks",
"Fitness & workouts",
"Foods",
"Games",
"Gardening",
"Health & medical",
"Healthy living and self-care",
"Home and garden",
"Music and audio",
"Parties",
"Professional networking",
"Religions",
"Shopping",
"Social issues",
"Sports",
"TV and films",
"Theatre",
"Visual arts"
]
}
},
"eventFormat": {
"title": "Event format",
"enum": [
"any",
"online",
"inPerson"
],
"type": "string",
"description": "Keep online events, in-person events, or both.",
"default": "any"
},
"includeCanceled": {
"title": "Include cancelled events",
"type": "boolean",
"description": "Also save events the organiser has cancelled (marked isCanceled). Off by default.",
"default": false
},
"monitoringMode": {
"title": "Only new events since the last run",
"type": "boolean",
"description": "For scheduled runs: save only events that earlier runs of this Actor did not save from the same source, so you are charged for new events only. The first run saves everything as usual.",
"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
}
}
}
}
}
}
}
}
}
}