Pricing

Rating

Developer

Actor stats

Categories

Share

🎭 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

⚙️ 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

🌍 Country codes (gl parameter)

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

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:

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

⚠️ 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

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:

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 ❤️

n8n integration

Available as an n8n community node, n8n-nodes-google-events-api. In n8n: Settings, Community Nodes, install n8n-nodes-google-events-api, then use it in any workflow (it also works as an AI Agent tool).

Featured Tasks

Ready-to-run examples that show this API solving a specific problem. Each opens its own setup so you can run it on your account in one click.

• Find concerts and festivals in Austin this weekend - weekend-filtered live events with dates, venues, and ticket links.
• Track tech conferences in San Francisco - upcoming conferences with venues and registration links for event marketers.
• Aggregate local sports events for a city app - one run returns a city's games with dates, venues, and ticket links as JSON.

Last Updated: 2026.06.19