{ "openapi": "3.0.1", "info": { "title": "Google Events API - Access Google Events Data", "description": "Extract event data from Google Events including titles, dates, locations, ticket information, and venue details. Supports advanced filtering (date ranges, virtual events), localization (country/language), and pagination. Structured JSON for event discovery, market research, and event platforms.", "version": "0.0", "x-build-id": "0gEIjvD8dGK77D4sk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/johnvc~google-events-api---access-google-events-data/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-johnvc-google-events-api---access-google-events-data", "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/johnvc~google-events-api---access-google-events-data/runs": { "post": { "operationId": "runs-sync-johnvc-google-events-api---access-google-events-data", "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/johnvc~google-events-api---access-google-events-data/run-sync": { "post": { "operationId": "run-sync-johnvc-google-events-api---access-google-events-data", "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": [ "q" ], "properties": { "q": { "title": "Search Query", "minLength": 1, "type": "string", "description": "Search query string for events (e.g., 'concerts in New York', 'sports events', 'theater shows'). Required." }, "location": { "title": "Location", "type": "string", "description": "Geographic location for localized event results (e.g., 'Austin, Texas, United States', 'New York, NY'). Optional. Helps narrow down events to a specific area." }, "gl": { "title": "Country Code", "enum": [ "ad", "ae", "af", "ag", "ai", "al", "am", "an", "ao", "aq", "ar", "as", "at", "au", "aw", "az", "ba", "bb", "bd", "be", "bf", "bg", "bh", "bi", "bj", "bm", "bn", "bo", "br", "bs", "bt", "bv", "bw", "by", "bz", "ca", "cc", "cd", "cf", "cg", "ch", "ci", "ck", "cl", "cm", "cn", "co", "cr", "cu", "cv", "cx", "cy", "cz", "de", "dj", "dk", "dm", "do", "dz", "ec", "ee", "eg", "eh", "er", "es", "et", "fi", "fj", "fk", "fm", "fo", "fr", "ga", "gb", "gd", "ge", "gf", "gg", "gh", "gi", "gl", "gm", "gn", "gp", "gq", "gr", "gs", "gt", "gu", "gw", "gy", "hk", "hm", "hn", "hr", "ht", "hu", "id", "ie", "il", "im", "in", "io", "iq", "ir", "is", "it", "je", "jm", "jo", "jp", "ke", "kg", "kh", "ki", "km", "kn", "kp", "kr", "kw", "ky", "kz", "la", "lb", "lc", "li", "lk", "lr", "ls", "lt", "lu", "lv", "ly", "ma", "mc", "md", "me", "mg", "mh", "mk", "ml", "mm", "mn", "mo", "mp", "mq", "mr", "ms", "mt", "mu", "mv", "mw", "mx", "my", "mz", "na", "nc", "ne", "nf", "ng", "ni", "nl", "no", "np", "nr", "nu", "nz", "om", "pa", "pe", "pf", "pg", "ph", "pk", "pl", "pm", "pn", "pr", "ps", "pt", "pw", "py", "qa", "re", "ro", "rs", "ru", "rw", "sa", "sb", "sc", "sd", "se", "sg", "sh", "si", "sj", "sk", "sl", "sm", "sn", "so", "sr", "st", "sv", "sy", "sz", "tc", "td", "tf", "tg", "th", "tj", "tk", "tl", "tm", "tn", "to", "tr", "tt", "tv", "tw", "tz", "ua", "ug", "uk", "um", "us", "uy", "uz", "va", "vc", "ve", "vg", "vi", "vn", "vu", "wf", "ws", "ye", "yt", "za", "zm", "zw" ], "type": "string", "description": "Country code for localization (ISO 3166-1 alpha-2, lowercase). Optional. Defaults based on search context if not specified. See https://serpapi.com/google-countries for complete list of valid codes." }, "hl": { "title": "Language Code", "enum": [ "en", "es", "fr", "de", "it", "pt", "ru", "ja", "ko", "zh", "zh-cn", "zh-tw", "ar", "hi", "th", "vi", "id", "ms", "tl", "nl", "pl", "tr", "cs", "sv", "da", "fi", "no", "hu", "ro", "bg", "hr", "sk", "sl", "et", "lv", "lt", "el", "he", "fa", "ur", "bn", "ta", "te", "ml", "kn", "gu", "pa", "mr", "ne", "si", "my", "km", "lo", "ka", "hy", "az", "kk", "ky", "uz", "mn", "be", "uk", "mk", "sq", "sr", "bs", "is", "ga", "cy", "mt", "eu", "ca", "gl", "pt-br", "es-mx", "es-ar", "es-cl", "es-co", "es-pe", "es-ve", "es-ec", "es-bo", "es-py", "es-uy", "es-cr", "es-pa", "es-ni", "es-hn", "es-sv", "es-gt", "es-do", "es-cu", "es-pr", "en-us", "en-gb", "en-ca", "en-au", "en-nz", "en-ie", "en-za", "en-in", "en-sg", "en-my", "en-ph", "fr-fr", "fr-ca", "fr-be", "fr-ch", "fr-lu", "de-de", "de-at", "de-ch", "it-it", "it-ch", "pt-pt", "nl-nl", "nl-be", "ru-ru", "ru-ua", "ru-by", "ru-kz", "ja-jp", "ko-kr", "zh-hk", "ar-sa", "ar-ae", "ar-eg", "ar-ma", "ar-dz", "ar-tn", "ar-ly", "ar-sd", "ar-ye", "ar-jo", "ar-lb", "ar-sy", "ar-iq", "ar-kw", "ar-qa", "ar-bh", "ar-om", "hi-in", "th-th", "vi-vn", "id-id", "ms-my", "tl-ph", "pl-pl", "tr-tr", "cs-cz", "sv-se", "da-dk", "fi-fi", "no-no", "hu-hu", "ro-ro", "bg-bg", "hr-hr", "sk-sk", "sl-si", "et-ee", "lv-lv", "lt-lt", "el-gr", "he-il", "fa-ir", "ur-pk", "bn-bd", "ta-in", "te-in", "ml-in", "kn-in", "gu-in", "pa-in", "mr-in", "ne-np", "si-lk", "my-mm", "km-kh", "lo-la", "ka-ge", "hy-am", "az-az", "kk-kz", "ky-kg", "uz-uz", "mn-mn", "be-by", "uk-ua", "mk-mk", "sq-al", "sr-rs", "bs-ba", "is-is", "ga-ie", "cy-gb", "mt-mt", "eu-es", "ca-es", "gl-es" ], "type": "string", "description": "Language code for localization (ISO 639-1, lowercase). Optional. Defaults based on country if not specified. See https://serpapi.com/google-languages for complete list of valid codes." }, "advanced": { "title": "Advanced Filters (Hit Chips)", "type": "string", "description": "Advanced filters for Google Events (hit chips / htichips). Invalid tokens are rejected at run start (before any charges). Single filters or comma-separated combinations. Allowed tokens only: date:today (today), date:tomorrow, date:week (this week), date:weekend (this weekend), date:next_week, date:month (this month — not date:thismonth), date:next_month, event_type:Virtual-Event (online). Example combinations: event_type:Virtual-Event,date:today. Optional." }, "max_pages": { "title": "Maximum Pages", "minimum": 0, "type": "integer", "description": "Maximum number of pages to fetch. Set to 0 for no limit (fetch all available pages). Default: 1. Each page is charged separately at $0.02 per page.", "default": 1 }, "output_file": { "title": "Output File", "type": "string", "description": "Optional filename to save results as JSON. If not provided, will auto-generate based on query and timestamp." } } }, "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 } } } } } } } } } }