# 🎟️ Google Events Scraper (`api-empire/google-events-scraper`) Actor 🎟️ Google Events Scraper automates discovery of Google Events dataβ€”dates, locations, titles & moreβ€”at scale. πŸš€ Perfect for event marketing, leads, analytics & competitive research. ⚑ Fast, reliable, and scraper-ready. - **URL**: https://apify.com/api-empire/google-events-scraper.md - **Developed by:** [API Empire](https://apify.com/api-empire) (community) - **Categories:** Automation, Lead generation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.99 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 🎟️ Google Events Scraper Turn **Google Events** into clean, structured JSON. This Actor searches Google's Events vertical and returns rich event data β€” **concerts, festivals, conferences, sports, theater and virtual events** β€” complete with dates, full date/time ranges, venue names & addresses, venue ratings & review counts, map previews & map links, and **outbound ticket links** (Ticketmaster, Eventbrite, Spotify, AXS, SeatGeek and more). No public Google Events API exists β€” this Actor talks to the same endpoint the Google app uses, so it's fast, lightweight and future-proof. --- ### ✨ Why Choose Us? - πŸ”Ž **Bulk queries** β€” scrape many searches in one run, not just one. - πŸ›‘οΈ **Smart proxy ladder** β€” starts **direct** (cheap & fast) and only escalates to **datacenter β†’ residential** when Google pushes back, then sticks with what works. - πŸ’Ύ **Live saving** β€” every page is written to your dataset the moment it's scraped. A crash never loses collected data. - 🧱 **Resilient parsing** β€” graceful per-field fallbacks survive Google's CSS rotations. - 🌍 **Localized** β€” country (`gl`) + language (`hl`) + location bias. - 🎚️ **Date & type filters** β€” today, this weekend, next month, virtual-only, and more. - πŸ“Š **Per-section output** β€” each dataset row is one page of results with its own metadata. --- ### πŸš€ Key Features | Feature | Details | |--------|---------| | Event details | Title, description, start date, full when-range, relative date | | Venue | Name, address lines, rating, review count, Google Maps link | | Media | Map preview tile image + event image | | Ticket links | First genuine outbound ticket/info link, redirect-unwrapped | | Pagination | Up to N pages per query (10 events/page), or unlimited | | Localization | `gl` country, `hl` language, `location` bias | | Filters | Google hit-chips folded into the query as natural language | | Proxy | Direct β†’ Datacenter β†’ Residential automatic fallback | --- ### πŸ“₯ Input | Field | Type | Description | |-------|------|-------------| | `searchQueries` | array | πŸ”Ž Bulk list of Google Events searches. | | `q` | string | πŸ” Optional single query (merged with the list). | | `location` | string | πŸ“ Location bias, e.g. `"South Bend, Indiana"`. | | `gl` | string | 🌍 Country code (ISO 3166-1 alpha-2). | | `hl` | string | πŸ—£οΈ Language code (ISO 639-1). | | `advanced` | string | 🎚️ Hit-chip filters (see below). | | `maxPages` | integer | πŸ“„ Pages per query (`0` = unlimited). Default `3`. | | `proxyConfiguration` | object | πŸ›‘οΈ Proxy settings (default: no proxy). | **Allowed `advanced` tokens** (single or comma-separated): `date:today`, `date:tomorrow`, `date:week`, `date:weekend`, `date:next_week`, `date:month`, `date:next_month`, `event_type:Virtual-Event`. #### Example input ```json { "searchQueries": ["events in South Bend Indiana"], "location": "South Bend, Indiana", "gl": "us", "hl": "en", "advanced": "date:today", "maxPages": 3, "proxyConfiguration": { "useApifyProxy": false } } ```` *** ### πŸ“€ Output Each dataset item is **one page (section)** of results: ```json { "query": "events in South Bend Indiana", "search_parameters": { "q": "events in South Bend Indiana", "location": "South Bend, Indiana", "gl": "us", "hl": "en", "advanced": "date:today", "max_pages": 3, "applied_hit_chips": ["date:today"] }, "search_metadata": { "total_results": 9, "events_count": 9, "pages_processed": 1, "max_pages_set": 3, "pagination_limit_reached": false }, "search_timestamp": "2026-06-07T12:37:26.639434+00:00", "page_number": 1, "events": [ { "title": "Full Metal Sunday - Killswitch Engage with Machine Head and Havok", "date": { "start_date": "Jun 7", "when": "Sun, Jun 7, 5:00 – 6:30 PM", "description": "Tomorrow", "venue": { "name": "Four Winds Field at Coveleski Stadium", "rating": 4.7, "reviews": 2756, "link": "https://www.google.com/maps/place/..." } }, "address": ["Four Winds Field at Coveleski Stadium", "501 W South St, South Bend, IN"], "link": "https://open.spotify.com/concert/45ww5UaMfcSXvVE1wgXG79", "event_location_map": { "image": "https://www.google.com/maps/vt/data=...", "link": "https://www.google.com/maps/place/...", "venue": { "...": "..." } }, "description": "Find tickets for Iron Reagan at Four Winds Field ...", "image": "https://www.google.com/maps/vt/data=...", "venue": { "name": "Four Winds Field at Coveleski Stadium", "rating": 4.7, "reviews": 2756, "link": "https://www.google.com/maps/place/..." } } ], "hit_chips": [], "filters": [] } ``` *** ### πŸš€ How to Use (Apify Console) 1. Log in at [console.apify.com](https://console.apify.com) β†’ **Actors**. 2. Open **🎟️ Google Events Scraper**. 3. Enter your **search queries**, optional location / country / language / filters. 4. Click **Start**. 5. Watch the live logs as events stream in. 🎟️ 6. Open the **Output** / **Storage** tab when the run finishes. 7. Export to **JSON / CSV / XLSX**. ### πŸ€– Use via API ```bash curl -X POST "https://api.apify.com/v2/acts//run-sync-get-dataset-items?token=$APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"searchQueries":["concerts in New York"],"gl":"us","hl":"en","maxPages":2}' ``` *** ### 🎯 Best Use Cases - πŸ€– AI agents & copilots discovering local events for users. - 🎫 Ticket-finding and price-comparison tools. - πŸ“ˆ Market research & trend analysis across cities. - πŸ“° Local-events SEO content and roundups. - πŸ’» Virtual-event discovery (`event_type:Virtual-Event`). *** ### πŸ’΅ Pricing This Actor uses the **Pay-per-event** model. The primary billable event is **`row_result`** β€” charged once for every result page pushed to the dataset (each page holds up to ~10 events). Set `maxPages` to cap your spend. Runs that aren't monetized simply skip charging. *** ### ❓ FAQ **Does it need a proxy?** No. It connects directly by default and only escalates to a datacenter, then residential proxy if Google blocks a request. **Why is the event image sometimes a map tile?** Google loads the hero photo with JavaScript after page render, so it isn't in the static HTML. When absent, the Actor falls back to the venue's map preview tile β€” exactly what Google itself does. **Can I filter by date?** Yes β€” use `advanced` (e.g. `date:weekend`, `date:next_month`). **Can I scrape many cities at once?** Yes β€” add multiple `searchQueries`. *** ### πŸ›Ÿ Support & Feedback Found an issue or want a new field? Open an issue on the Actor's page β€” feedback is welcome and acted on. > Data is collected only from publicly available Google search results. You are responsible for compliant use (target ToS, GDPR/CCPA, etc.). # Actor input Schema ## `searchQueries` (type: `array`): One or more things you'd type into the Google Events search bar. Add as many as you like β€” they run in bulk. Examples: 'concerts in New York', 'tech conferences this week', 'theater shows in Chicago'. ## `q` (type: `string`): A single search query. Use this if you prefer one query instead of the bulk list above. It is merged with 'Search Queries'. ## `location` (type: `string`): Geographic location to bias results toward (e.g. 'Austin, Texas, United States', 'New York, NY', 'London, United Kingdom'). Optional β€” improves relevance when the query isn't location-specific. ## `gl` (type: `string`): Country for localization (ISO 3166-1 alpha-2, lowercase). Optional. ## `hl` (type: `string`): Interface language for results (ISO 639-1, lowercase). Optional. ## `advanced` (type: `string`): Optional Google Events hit-chips. Single token or comma-separated combo. Allowed: date:today, date:tomorrow, date:week, date:weekend, date:next\_week, date:month, date:next\_month, event\_type:Virtual-Event. Example: 'event\_type:Virtual-Event,date:today'. Invalid tokens stop the run before any work. ## `maxPages` (type: `integer`): How many pages of results to fetch per query (10 events per page). Set 0 for no limit (fetch all available pages). Default: 3. ## `proxyConfiguration` (type: `object`): By default the Actor connects DIRECTLY (no proxy). If Google blocks a request it automatically falls back to a datacenter proxy, then to a sticky residential proxy. Configure your preferred Apify proxy here to seed that fallback. ## Actor input object example ```json { "searchQueries": [ "events in South Bend Indiana" ], "location": "South Bend, Indiana", "gl": "us", "hl": "en", "advanced": "date:today", "maxPages": 3, "proxyConfiguration": { "useApifyProxy": false } } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchQueries": [ "events in South Bend Indiana" ], "location": "South Bend, Indiana", "advanced": "date:today", "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("api-empire/google-events-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchQueries": ["events in South Bend Indiana"], "location": "South Bend, Indiana", "advanced": "date:today", "proxyConfiguration": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("api-empire/google-events-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchQueries": [ "events in South Bend Indiana" ], "location": "South Bend, Indiana", "advanced": "date:today", "proxyConfiguration": { "useApifyProxy": false } }' | apify call api-empire/google-events-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=api-empire/google-events-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "🎟️ Google Events Scraper", "description": "🎟️ Google Events Scraper automates discovery of Google Events dataβ€”dates, locations, titles & moreβ€”at scale. πŸš€ Perfect for event marketing, leads, analytics & competitive research. ⚑ Fast, reliable, and scraper-ready.", "version": "0.1", "x-build-id": "rz735DZqkGOsfzTEh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api-empire~google-events-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api-empire-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/api-empire~google-events-scraper/runs": { "post": { "operationId": "runs-sync-api-empire-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/api-empire~google-events-scraper/run-sync": { "post": { "operationId": "run-sync-api-empire-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", "properties": { "searchQueries": { "title": "πŸ”Ž Search Queries (bulk)", "type": "array", "description": "One or more things you'd type into the Google Events search bar. Add as many as you like β€” they run in bulk. Examples: 'concerts in New York', 'tech conferences this week', 'theater shows in Chicago'.", "items": { "type": "string" } }, "q": { "title": "πŸ” Single Search Query (optional)", "type": "string", "description": "A single search query. Use this if you prefer one query instead of the bulk list above. It is merged with 'Search Queries'." }, "location": { "title": "πŸ“ Location", "type": "string", "description": "Geographic location to bias results toward (e.g. 'Austin, Texas, United States', 'New York, NY', 'London, United Kingdom'). Optional β€” improves relevance when the query isn't location-specific." }, "gl": { "title": "🌍 Country", "enum": [ "us", "gb", "ca", "au", "de", "fr", "es", "it", "nl", "br", "mx", "in", "jp", "kr", "sg", "ae", "za", "ie", "nz", "se", "no", "dk", "fi", "pl", "pt", "ch", "at", "be" ], "type": "string", "description": "Country for localization (ISO 3166-1 alpha-2, lowercase). Optional.", "default": "us" }, "hl": { "title": "πŸ—£οΈ Language", "enum": [ "en", "es", "fr", "de", "it", "pt", "nl", "ru", "ja", "ko", "zh", "ar", "hi", "tr", "pl", "sv", "da", "fi", "no" ], "type": "string", "description": "Interface language for results (ISO 639-1, lowercase). Optional.", "default": "en" }, "advanced": { "title": "🎚️ Advanced Date / Type Filters", "type": "string", "description": "Optional Google Events hit-chips. Single token or comma-separated combo. Allowed: date:today, date:tomorrow, date:week, date:weekend, date:next_week, date:month, date:next_month, event_type:Virtual-Event. Example: 'event_type:Virtual-Event,date:today'. Invalid tokens stop the run before any work." }, "maxPages": { "title": "πŸ“„ Max Pages per Query", "minimum": 0, "type": "integer", "description": "How many pages of results to fetch per query (10 events per page). Set 0 for no limit (fetch all available pages). Default: 3.", "default": 3 }, "proxyConfiguration": { "title": "πŸ›‘οΈ Proxy Configuration", "type": "object", "description": "By default the Actor connects DIRECTLY (no proxy). If Google blocks a request it automatically falls back to a datacenter proxy, then to a sticky residential proxy. Configure your preferred Apify proxy here to seed that fallback.", "default": { "useApifyProxy": 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 } } }, "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 } } } } } } } } } } ```