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

{
  "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:

{
  "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 → 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

curl -X POST "https://api.apify.com/v2/acts/<ACTOR_ID>/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.).