{
  "openapi": "3.0.1",
  "info": {
    "title": "Google Events | Scrape Google Events for AI Agents",
    "description": "Google Events API for Claude, ChatGPT, Cursor & other MCP-ready AI agents. Scrape Google Events search results — concerts, conferences, festivals, sports, theater, virtual events — with dates, venues, ticket links & locations. Filter by date, event type, country, language. Pay per page.",
    "version": "0.0",
    "x-build-id": "K53exKysxRN9T3PjF"
  },
  "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": {
          "mode": {
            "title": "Mode",
            "enum": [
              "events",
              "sport_events"
            ],
            "type": "string",
            "description": "events (default): event listings for a place, such as concerts, festivals, shows and conferences. sport_events: upcoming fixtures for the club, league or competition named in q, for example 'Chelsea', 'Premier League', 'Harlequins' or 'NBA'. Google removed sport from its event listings in November 2026, so sports-worded searches in events mode return nothing; Sport Event Mode reads Google's fixtures block instead and returns each game in the same event shape.",
            "default": "events"
          },
          "q": {
            "title": "Search Query",
            "minLength": 1,
            "type": "string",
            "description": "Search query for events. Examples: 'concerts in Austin', 'tech conferences in Chicago', 'festivals in Portland'. Tip: name the city plainly here and put the state or precise place in the Location field. Including a state abbreviation in the query itself (e.g. 'Festivals in Portland, OR') reliably returns nothing. In Sport Event Mode, give a club, league or competition name only ('Chelsea', 'Premier League', 'NBA'); city-shaped sport queries such as 'football in London' return nothing."
          },
          "location": {
            "title": "Location",
            "type": "string",
            "description": "Geographic location to bias event results toward (e.g. 'Austin, Texas, United States', 'New York, NY', 'London, United Kingdom'). Optional — improves relevance when the search query itself isn't location-specific."
          },
          "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, e.g. 'us', 'gb', 'de', 'fr', 'jp'). Optional. Applies to Sport Event Mode and to the search-results fallback; the primary event listing surface returns English, US-formatted labels regardless of this value."
          },
          "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, e.g. 'en', 'es', 'fr', 'de', 'ja'). Optional. Applies to Sport Event Mode and to the search-results fallback. A non-English value moves the localized search-results lookup ahead of the primary listing surface, which only answers in English."
          },
          "advanced": {
            "title": "Date Filter",
            "type": "string",
            "description": "Optional date filter. Supported tokens: date:today, date:tomorrow, date:week (this week), date:weekend (this weekend), date:next_week (Google's weeks run Sunday to Saturday), date:month (this month - note 'date:month', not 'date:thismonth'), date:next_month. The filter is applied by naming the window in the search query, the only date mechanism Google still honors for event listings; one date token takes effect per run (the first listed). event_type:Virtual-Event is rejected at the start of the run before any charge: Google's listings no longer distinguish virtual events, so it would return misleading results."
          },
          "include_details": {
            "title": "Include details",
            "type": "boolean",
            "description": "Events mode only. Fetch the full description and venue details (type, description) for each event listing: one extra lookup per event, at most 10 per run, billed per detailed event. Off by default. Ticket links, prices and venue links come with every listing at no extra cost.",
            "default": false
          },
          "max_pages": {
            "title": "Maximum Pages",
            "minimum": 0,
            "type": "integer",
            "description": "Retained for backward compatibility. Event listings are returned as a single batch of up to 10 on one page, so any value above 1 is clamped to 1 and you are charged for one 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
                  },
                  "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}