{ "openapi": "3.0.1", "info": { "title": "Google Events Scraper", "description": "Scrapes native Google Events results for any keyword and location, including exact Google document IDs, titles, calendar dates, displayed times, venues, addresses, event links, search context, and retrieval provenance. Uses source-page JSON-LD as an explicitly identified fallback.", "version": "3.2", "x-build-id": "eJ9aTCZLnDSffwn8c" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/searchapi~google-events-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-searchapi-google-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/searchapi~google-events-scraper/runs": { "post": { "operationId": "runs-sync-searchapi-google-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/searchapi~google-events-scraper/run-sync": { "post": { "operationId": "run-sync-searchapi-google-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": [ "query", "maxItems" ], "properties": { "query": { "title": "Search query", "type": "string", "description": "One event search, such as concerts, technology conferences, or yoga classes.", "default": "tech conferences" }, "queries": { "title": "Additional search queries", "type": "array", "description": "Optional additional searches processed in the same run. Duplicate queries are removed.", "items": { "type": "string" }, "default": [] }, "location": { "title": "Location", "type": "string", "description": "City, region, or country appended to every search, for example New York or London.", "default": "New York" }, "dateFilter": { "title": "Date filter", "enum": [ "any", "today", "tomorrow", "weekend", "week", "next_week", "month" ], "type": "string", "description": "Google Events date filter applied to every search.", "default": "any" }, "searchMode": { "title": "Search mode", "enum": [ "auto", "events", "web" ], "type": "string", "description": "Auto searches with the query as written, then retries with the word \"events\" when no Events pack is found. Google retired the dedicated events vertical, so all modes read the Events pack on the main Google Search page.", "default": "auto" }, "maxItems": { "title": "Maximum records", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of unique event records across all searches.", "default": 50 }, "maxPages": { "title": "Maximum load cycles", "minimum": 1, "maximum": 10, "type": "integer", "description": "Kept for saved inputs. The Events pack is a single carousel, so Google serves no further events on later result pages.", "default": 3 }, "gl": { "title": "Google country", "type": "string", "description": "Two-letter Google country code. Residential proxy country is aligned automatically when not explicitly set.", "default": "us" }, "hl": { "title": "Google language", "type": "string", "description": "Google interface language code.", "default": "en" }, "maxConcurrency": { "title": "Maximum concurrency", "minimum": 1, "maximum": 5, "type": "integer", "description": "Parallel event searches. Low defaults reduce Google rate accumulation while keeping multi-search runs fast.", "default": 2 }, "maxRequestRetries": { "title": "Maximum request retries", "minimum": 0, "maximum": 5, "type": "integer", "description": "Retries temporary network, proxy, and browser failures. Explicit CAPTCHA pages are never retried.", "default": 2 }, "navigationTimeoutSecs": { "title": "Navigation timeout", "minimum": 10, "maximum": 180, "type": "integer", "description": "Maximum time allowed for initial Google navigation.", "default": 45 }, "requestHandlerTimeoutSecs": { "title": "Request handler timeout", "minimum": 30, "maximum": 300, "type": "integer", "description": "Maximum time allowed to load and extract one search.", "default": 120 }, "resultsWaitSecs": { "title": "Results wait", "minimum": 3, "maximum": 60, "type": "integer", "description": "Maximum wait for event cards, an explicit empty result, or a block response.", "default": 15 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Google serves the server-rendered Events pack to the GOOGLE_SERP proxy group (plain-HTTP forwarding). Other groups use the slower browser transport, which Google often refuses.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "GOOGLE_SERP" ] } } } }, "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 } } } } } } } } } }