🎭 Google Events Scraper | API for Claude, ChatGPT & Cursor (MCP)

Scrape Google Events with one API call — concerts, conferences, festivals, sports, theater, and virtual events. Built as a drop-in Google Events API for Claude, ChatGPT, Cursor, and other MCP-ready AI agents — and as a standard pay-per-page scraper for developers.

Pass any Google Events search query and get structured JSON back: event titles, dates, venues, addresses, ticket links (Ticketmaster, Eventbrite, Spotify, and more), venue ratings, map links, and Google's own filter chips. Localize by country and language. Filter by date (today / this week / weekend / month) and event type (virtual). Pay per page, no subscriptions.

---

🤖 Use with Claude, ChatGPT, Cursor & other AI agents (MCP)

This Actor is a first-class tool on the Apify MCP Server. Any MCP-compatible AI agent — Claude (Desktop, Web, Code), ChatGPT (via custom GPT or MCP bridge), Cursor, VS Code, Cline, Windsurf, Kilo Code, Opencode, Glama — can discover and call this Actor in natural language.

What an AI agent does with this:

User: "Find me family-friendly events in Brooklyn this weekend, with ticket links."

Agent → calls search-actors("google events") on the Apify MCP server → picks this Actor → calls it with {"q": "family events brooklyn", "location": "Brooklyn, NY", "advanced": "date:weekend", "max_pages": 2} → returns structured event JSON → summarizes for the user.

Quick setup — Claude Desktop

Add this to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": ["-y", "@apify/actors-mcp-server"],
      "env": {
        "APIFY_TOKEN": "YOUR_APIFY_API_TOKEN"
      }
    }
  }
}

Restart Claude Desktop. Then ask Claude something like "Search Google Events for tech meetups in San Francisco next week." — Claude will discover this Actor, ask permission to call it, and return structured results.

Quick setup — Cursor / VS Code / Cline / Windsurf

These editors support dynamic tool discovery, which means after the first call this Actor is registered as a named tool for the rest of the session — subsequent prompts skip the discovery step entirely.

Point your MCP client at:

https://mcp.apify.com

…with header Authorization: Bearer YOUR_APIFY_API_TOKEN. Full setup instructions: Apify MCP integration docs.

Quick setup — ChatGPT (and other static MCP clients)

ChatGPT, Claude Desktop (without dynamic discovery), Gemini CLI, and Amazon Q connect through the same https://mcp.apify.com endpoint and call this Actor via the generic call-actor tool — same result, just no session-level tool registration.

Use cases for AI agents

• 🤖 Event-discovery assistants — "Find me what's happening this weekend near {city}."
• 📅 Calendar copilots — Auto-suggest events that match the user's interests and free slots.
• 🎟️ Ticket-finding agents — "Cheapest tickets for {artist} in {city} this month."
• 🏢 Sales / lead-gen agents — Surface industry conferences and trade shows where prospects gather.
• 📊 Research agents — Aggregate event data across cities for market analysis or trend reports.

---

💡 What this Actor does

A Google Events Scraper that takes a search query and pulls structured event data straight from Google Events — titles, dates, venues, ticket links, addresses, descriptions, venue ratings, map links, and Google's own filter chips — and returns it as clean JSON.

Whether you're powering an AI agent through MCP, building an event-discovery app, monitoring competitor events, or aggregating concert and conference data into a dataset, this scraper handles the platform-side complexity so you don't have to.

✅ SEO benefit: Structured Google Events data lets businesses optimize event listing pages, monitor competition, and create data-rich content that boosts organic visibility.

---

📦 What data you get

Field	Description
🎭 Event details	Title, description, dates, times, and primary link
📅 Date & time	Start dates, full date/time ranges, "when" labels
📍 Location	Multi-line address, venue, map preview image + link
🎫 Ticket links	Sources (Ticketmaster, Eventbrite, Spotify, etc.) with URLs and link types
🏛️ Venue details	Name, rating, review count, link to venue's Google listing
🗺️ Map preview	Static map image URL + clickable Google Maps link
🎯 Hit chips	Filter chips offered by Google Events (date ranges, event types)
🔍 Filters	Additional filter groups for narrowing the search
📊 Search metadata	Total results, pages processed, pagination status

---

⚙️ Key features

✨ Comprehensive data coverage — Every event field Google Events returns: titles, descriptions, dates, locations, tickets, venues.

🔍 Advanced filtering — Filter by date (today, tomorrow, this week, weekend, this month, next month) and event type (virtual). Combine multiple filters in one call.

🌍 Localization — Country (gl) and language (hl) parameters localize results to any of 240+ countries and 200+ languages.

📄 Smart pagination — Set max_pages to fetch as many pages as you need, or 0 for unlimited. Pages are billed individually — you pay for what you actually fetch.

🎯 Hit-chips support — Use Google's native filter chips (date:today, event_type:Virtual-Event, etc.) to slice results the same way Google's UI does.

💰 Transparent pay-per-page pricing — $0.02 setup + $0.02 per page. No subscriptions, no minimums.

🛡️ Production-grade reliability — 99.9% success rate on live traffic, comprehensive error handling, schema-validated output.

🤖 MCP-ready — First-class tool on the Apify MCP Server for Claude, ChatGPT, Cursor, and any other MCP-compatible agent.

---

📖 Usage examples

Example 1: Basic search (events in New York)

{
  "q": "events in New York",
  "max_pages": 1
}

Example 2: Search with location and localization

{
  "q": "concerts",
  "location": "Austin, Texas, United States",
  "gl": "us",
  "hl": "en",
  "max_pages": 1
}

Example 3: Today's events (single hit chip)

{
  "q": "sports events",
  "location": "Los Angeles, CA",
  "advanced": "date:today",
  "max_pages": 1
}

Example 3b: Today's virtual events (multiple hit chips, comma-separated)

{
  "q": "concerts",
  "advanced": "event_type:Virtual-Event,date:today",
  "max_pages": 1
}

Example 3c: Multiple hit chips as an array

{
  "q": "conferences",
  "advanced": ["date:today", "event_type:Virtual-Event"],
  "max_pages": 1
}

Example 4: Pagination (multiple pages)

{
  "q": "music festivals",
  "location": "California, United States",
  "gl": "us",
  "hl": "en",
  "max_pages": 2
}

Example 5: Comprehensive search (every parameter)

{
  "q": "theater shows",
  "location": "New York, NY",
  "gl": "us",
  "hl": "en",
  "advanced": ["date:month", "event_type:Virtual-Event"],
  "max_pages": 2
}

---

🔍 Input parameters

Parameter	Type	Required	Default	Description
q	string	✅ Yes	—	Search query (e.g., "concerts in New York", "tech conferences this week").
location	string	❌	—	Geographic location to bias results toward (e.g., "Austin, Texas, United States").
gl	string	❌	—	Country code (ISO 3166-1 alpha-2, lowercase). See country table below.
hl	string	❌	—	Language code (ISO 639-1, lowercase). See language table below.
advanced	string or array	❌	—	Hit-chip filters (string, comma-separated string, or array). See hit-chips section below.
max_pages	integer	❌	1	Pages to fetch. 0 = unlimited. Each page billed separately.
output_file	string	❌	auto-generated	Optional JSON filename for local runs (ignored when run on the Apify platform).

---

🌍 Country codes (gl parameter)

The gl parameter accepts ISO 3166-1 alpha-2 country codes (lowercase). Most common:

Code	Country	Code	Country	Code	Country
us	United States	uk / gb	United Kingdom	ca	Canada
au	Australia	de	Germany	fr	France
it	Italy	es	Spain	nl	Netherlands
be	Belgium	at	Austria	ch	Switzerland
se	Sweden	no	Norway	dk	Denmark
fi	Finland	pl	Poland	cz	Czech Republic
ie	Ireland	pt	Portugal	gr	Greece
jp	Japan	kr	South Korea	cn	China
tw	Taiwan	hk	Hong Kong	sg	Singapore
my	Malaysia	th	Thailand	id	Indonesia
ph	Philippines	vn	Vietnam	in	India
nz	New Zealand	za	South Africa	br	Brazil
mx	Mexico	ar	Argentina	cl	Chile
co	Colombia	pe	Peru	ve	Venezuela

240+ country codes are supported. Pick the closest from the dropdown in the input schema.

---

🌐 Language codes (hl parameter)

The hl parameter accepts ISO 639-1 language codes (lowercase). Most common:

Code	Language	Code	Language	Code	Language
en	English	es	Spanish	fr	French
de	German	it	Italian	pt	Portuguese
ru	Russian	ja	Japanese	ko	Korean
zh	Chinese	zh-cn	Chinese (Simplified)	zh-tw	Chinese (Traditional)
ar	Arabic	hi	Hindi	th	Thai
vi	Vietnamese	id	Indonesian	ms	Malay
tl	Filipino	nl	Dutch	pl	Polish
tr	Turkish	cs	Czech	sv	Swedish
da	Danish	fi	Finnish	no	Norwegian
hu	Hungarian	ro	Romanian	bg	Bulgarian

200+ language codes are supported. Pick the closest from the dropdown.

---

🎯 Advanced filters (hit chips)

The advanced parameter accepts Google Events hit-chips — the filter pills you see at the top of the events results UI. Pass a single token, a comma-separated string, or an array.

Date filters

Token	Meaning
date:today	Events happening today
date:tomorrow	Events happening tomorrow
date:week	Events this week
date:weekend	Events this weekend
date:next_week	Events next week
date:month	Events this month
date:next_month	Events next month

⚠️ The token for "this month" is date:month, not date:thismonth. Using the wrong token causes the run to exit gracefully at start (before any charge) with a clear error.

Event-type filter

Token	Meaning
event_type:Virtual-Event	Virtual / online events only

Combining filters

{ "advanced": "event_type:Virtual-Event,date:today" }
{ "advanced": ["date:weekend", "event_type:Virtual-Event"] }

---

📊 Output format

One dataset item is pushed per page of results — so a 3-page run produces 3 dataset items. Each item has the same shape:

{
  "search_parameters": {
    "q": "events in New York",
    "location": null,
    "gl": null,
    "hl": null,
    "advanced": null,
    "max_pages": 1,
    "applied_hit_chips": null
  },
  "search_metadata": {
    "total_results": 10,
    "events_count": 10,
    "hit_chips_count": 0,
    "filters_count": 0,
    "pages_processed": 1,
    "max_pages_set": 1,
    "pagination_limit_reached": true
  },
  "search_timestamp": "2026-05-11T10:30:00.123456",
  "page_number": 1,
  "events": [
    {
      "title": "Funk Tribu",
      "date": {
        "start_date": "Nov 14",
        "when": "Fri, Nov 14, 10 PM – Sat, Nov 15, 1 AM"
      },
      "address": [
        "Avant Gardner, 140 Stewart Ave",
        "Brooklyn, NY"
      ],
      "link": "https://open.spotify.com/concert/5FXK8DRwn1wnBPbdW6r7hb",
      "event_location_map": {
        "image": "https://www.google.com/maps/vt/data=...",
        "link": "https://www.google.com/maps/place/..."
      },
      "description": "Find tickets for Funk Tribu at Park Slope Brooklyn Warehouse in New York City on 11/14/2025 at 10:00 PM",
      "ticket_info": [
        { "source": "Spotify.com", "link": "https://open.spotify.com/concert/...", "link_type": "tickets" },
        { "source": "Ticketmaster.com", "link": "https://ticketmaster.com/...", "link_type": "tickets" }
      ],
      "venue": {
        "name": "Avant Gardner",
        "rating": 4.1,
        "reviews": 4378,
        "link": "https://www.google.com/search?q=Avant+Gardner&..."
      }
    }
  ],
  "hit_chips": [],
  "filters": []
}

Top-level fields

• search_parameters — The exact input that produced this page.
• search_metadata — Counts and pagination status for the run.
• search_timestamp — ISO 8601 timestamp when this page was fetched.
• page_number — 1-indexed page number.
• events — Array of event objects on this page (see below).
• hit_chips — Available filter chips (typically only on page 1).
• filters — Secondary filter groups (typically only on page 1).

Event fields

• title — Event display title.
• date.start_date / date.when — Short date label and full date/time range.
• address — Array of address lines.
• link — Primary event landing link.
• event_location_map — Map preview image URL + Google Maps link.
• description — Free-text event description.
• ticket_info — Array of ticket-provider links with source name and link type.
• venue — Venue name, rating, review count, and Google listing link.

---

💸 Pricing

This Actor uses Apify's pay-per-event model:

Event	Price	When charged
Setup	$0.02	Once per run, at start
Page processed	$0.02	Per page of results successfully fetched and stored

Examples:

• 1 page: $0.02 setup + $0.02 page = $0.04
• 5 pages: $0.02 setup + $0.10 pages = $0.12
• 20 pages: $0.02 setup + $0.40 pages = $0.42

A pre-run funds check makes sure you can afford the maximum possible cost of the run before any work begins. If you don't have enough budget, the Actor exits gracefully with a friendly message before any charge.

---

🎯 Use cases

• 🤖 AI agents (MCP) — Plug into Claude, ChatGPT, Cursor and let the agent discover & call this tool natively.
• 📅 Event-discovery apps — Build event-aggregation platforms with up-to-date Google Events data.
• 📊 Market research — Analyze event trends, popularity, and venue saturation across cities.
• 🏢 Competitive analysis — Monitor competitors' event listings, ticket availability, and pricing.
• 🎫 Ticket-comparison tools — Pull multi-source ticket links (Ticketmaster, Eventbrite, Spotify, etc.) for every event.
• 📈 Lead generation — Identify trade shows and conferences where target customers will be.
• ✍️ Content creation — Generate event-round-up articles for local-events SEO content.
• 🌐 Virtual-event discovery — Filter on event_type:Virtual-Event to find online-only events.

---

❓ FAQ

Q1. How do I get started? Provide a q (search query). That's the only required parameter. Run the Actor and it returns structured JSON.

Q2. Is q required? Yes. Everything else is optional.

Q3. Can I filter results by date? Yes — use advanced with date:today, date:week, date:weekend, date:month, date:next_week, date:next_month, etc. See the hit-chips section above.

Q4. How do I search for virtual events only? Pass "advanced": "event_type:Virtual-Event". Combine with a date filter for today's virtual events: "event_type:Virtual-Event,date:today".

Q5. Can I use multiple filters at once? Yes — as a comma-separated string ("date:today,event_type:Virtual-Event") or as an array (["date:today", "event_type:Virtual-Event"]).

Q6. How does pagination work? Set max_pages to the number of pages you want. 0 means unlimited (fetch all available pages). Each page is billed separately.

Q7. Can I search in different countries and languages? Yes — gl (country code) and hl (language code). 240+ countries and 200+ languages are supported.

Q8. What format does the scraper return? Structured JSON. Each page of results is pushed as a separate dataset item. Results can be exported as JSON, CSV, Excel, or accessed via Apify's API.

Q9. Does this work with AI agents through MCP? Yes — see the Use with Claude, ChatGPT, Cursor & other AI agents (MCP) section near the top. MCP-compatible clients can discover and call this Actor natively.

Q10. How do I use the location parameter? Pass a human-readable location string: "Austin, Texas, United States", "London, England, United Kingdom", "New York, NY".

Q11. What if my search returns no results? search_metadata.events_count is 0 and events is an empty array. The Actor still completes successfully — you're only charged the setup fee in that case.

---

📝 Technical notes

• Results are sorted by Google Events' default relevance ordering.
• The q parameter is required and must be non-empty.
• Invalid hit-chip tokens are caught at run start, before any charges are applied — the Actor exits gracefully with a clear error message.
• Each page is pushed as its own dataset item, so per-page billing matches actual deliverables exactly.
• All output is JSON-serialized and schema-validated before being pushed.
• Pagination stops automatically once Google Events has no more results, even if max_pages is higher.
• location, gl, and hl are optional but recommended for sharper localization.
• Ticket info includes links from multiple sources (Ticketmaster, Eventbrite, Spotify, AXS, SeatGeek, and more) when available.
• Venue rating and review counts are included when Google has them for that venue.

---

🚀 Ready to scrape Google Events?

Whether you're wiring this up as an MCP tool for Claude, ChatGPT, or Cursor — or pulling event data directly through Apify's API — you'll have clean, structured Google Events results in minutes. Click Try for free to run your first search.

Python + MCP example: Apify-Google-Events-API on GitHub

Made with ❤️

---

Last Updated: 2026.06.10