Google Events API

/search?engine=google_events API endpoint allows you to scrape the results from the Google Events search engine via our SerpApi service. Head to the playground for a live and interactive demo.

API Parameters

Search Query

q

Required

Parameter defines the query you want to search. To search for events in a specific location, just include the location inside your search query (e.g. Events in Austin, TX).

Geographic Location

location

Optional

Parameter defines from where you want the search to originate. If several locations match the location requested, we'll pick the most popular one. Head to the /locations.json API if you need more precise control. The location and uule parameters can't be used together. It is recommended to specify location at the city level in order to simulate a real user’s search. If location is omitted, the search may take on the location of the proxy.

uule

Optional

Parameter is the Google encoded location you want to use for the search. uule and location parameters can't be used together.

Localization

gl

Optional

Parameter defines the country to use for the Google Events search. It's a two-letter country code. (e.g., us for the United States, uk for United Kingdom, or fr for France). Head to the Google countries page for a full list of supported Google countries.

hl

Optional

Parameter defines the language to use for the Google Events search. It's a two-letter language code. (e.g., en for English, es for Spanish, or fr for French). Head to the Google languages page for a full list of supported Google languages.

Pagination

start

Optional

Parameter defines the result offset. It skips the given number of results. It's used for pagination. (e.g., 0 (default) is the first page of results, 10 is the 2nd page of results, 20 is the 3rd page of results, etc.).

Advanced Filters

htichips

Optional

Parameter allows the use of different filters.

date:today - Today's Events
date:tomorrow - Tomorrow's Events
date:week - This Week's Events
date:today - Today's Weekend's Events
date:next_week - Next Week's Events
date:month - This Month's Events
date:next_month - Next Month's Events
event_type:Virtual-Event - Online Events

You can also mix different kinds of filters by separating them with a comma.
event_type:Virtual-Event,date:today Today's Online Events

Serpapi Parameters

engine

Required

Set parameter to google_events to use the Google Events API engine.

no_cache

Optional

Parameter will force SerpApi to fetch the Google Events results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to false (default) to allow results from the cache, or true to disallow results from the cache. no_cache and async parameters should not be used together.

async

Optional

Parameter defines the way you want to submit your search to SerpApi. It can be set to false (default) to open an HTTP connection and keep it open until you got your search results, or true to just submit your search to SerpApi and retrieve them later. In this case, you'll need to use our Searches Archive API to retrieve your results. async and no_cache parameters should not be used together. async should not be used on accounts with Ludicrous Speed enabled.

api_key

Required

Parameter defines the SerpApi private key to use.

output

Optional

Parameter defines the final output you want. It can be set to json (default) to get a structured JSON of the results, or html to get the raw html retrieved.

API Results

JSON Results

JSON output includes structured data for events results and more.

A search status is accessible through search_metadata.status. It flows this way: Processing -> Success || Error. If a search has failed, error will contain an error message. search_metadata.id is the search ID inside SerpApi.

HTML Results

HTML output is useful to debug JSON results or support features not supported yet by SerpApi.
HTML output gives you the raw HTML results from Google Events.

API Examples

Google Events search results for q: Events in Austin

The Google Events Results API allows a user to scrape events results from a Google Events page. SerpApi is able to make sense of this information and extract title, date, address, link, ticket_info, venue, thumbnail and more. To get started, you can try these searches: "best festivals" or "family friendly events". You can also add a location to your search query for more specific searches. For example, "concerts in Chicago".

Google Events search results for q: Events in Austin

JSON Example

{
  "search_metadata": {
    "id": "60df19b4de9834038dc25992",
    "status": "Success",
    "json_endpoint": "https://serpapi.com/searches/5138407ff8f7bc59/60df19b4de9834038dc25992.json",
    "created_at": "2021-07-02 13:50:44 UTC",
    "processed_at": "2021-07-02 13:50:44 UTC",
    "google_events_url": "https://www.google.com/search?q=events+in+austin&ibp=htl;events&hl=en",
    "raw_html_file": "https://serpapi.com/searches/5138407ff8f7bc59/60df19b4de9834038dc25992.html",
    "total_time_taken": 1.96
  },
  "search_parameters": {
    "q": "events in austin",
    "engine": "google_events"
  },
  "search_information": {
    "events_results_state": "Results for exact spelling"
  },
  "events_results": [
    {
      "title": "2021 Austin City Limits Music Festival",
      "date": {
        "start_date": "Oct 1",
        "when": "Oct 1 – 10"
      },
      "address": [
        "Zilker Park, 2207 Lou Neff Rd",
        "Austin, TX"
      ],
      "link": "https://www.austintexas.org/event/austin-city-limits-music-festival/350781/",
      "description": "One of the country's largest celebrations of live music, this two weekend, six-day festival brings the magic of the famed public TV series \"Austin City Limits\" outside the studio and into Austin's...",
      "ticket_info": [
        {
          "source": "Mileycyrus.com",
          "link": "https://mileycyrus.com/events/451575",
          "link_type": "tickets"
        },
        {
          "source": "Livenation.lat",
          "link": "https://www.livenation.lat/show/975308/austin-city-limits-music-festival/texas/2021-10-01/en",
          "link_type": "tickets"
        },
        {
          "source": "Fgtix.com",
          "link": "https://on.fgtix.com/trk/aclwk1tm",
          "link_type": "tickets"
        },
        {
          "source": "Stubhub.it",
          "link": "https://www.stubhub.it/austin-city-limits-festival-acl-austin-tickets-10-1-2021/event/104853922/",
          "link_type": "tickets"
        },
        {
          "source": "Visit Austin",
          "link": "https://www.austintexas.org/event/austin-city-limits-music-festival/350781/",
          "link_type": "more info"
        }
      ],
      "venue": {
        "name": "Zilker Park",
        "rating": 4.8,
        "reviews": 837,
        "link": "https://www.google.com/search?q=Zilker+Park&ludocid=11191514603003015866&ibp=gwp%3B0,7"
      },
      "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcS8mRlkCYd_eqWXP6BjfIHI8_m35omm6PkpHEYS9jFoq1wz3O4ra2i8mz4&s"
    },
    {
      "title": "Bob Schneider Independence Bash & Fireworks",
      "date": {
        "start_date": "Jul 3",
        "when": "Tomorrow, 6 – 11 PM"
      },
      "address": [
        "Nutty Brown Amphitheatre, 12225 US-290",
        "Austin, TX"
      ],
      "link": "https://www.kxan.com/calendar/?_escaped_fragment_=%2Fshow%2F%3Fser%3DDuo%2520Works#!/details/Bob-Schneider-Independence-Bash-Fireworks/9085010/2021-07-03T18",
      "event_location_map": {
        "image": "https://www.google.com/maps/vt/data=tPdtfApMc71-IhFYDnuyzvCdkjhQ2lznP686R6voTS7DrH68fbibFoziwCCgj2879RtewNl6XpbLSppBWCE17woHtECPBh3DV3sIk9SNnrYjpSRcTD0",
        "link": "https://www.google.com/maps/place//data=!4m2!3m1!1s0x865b466d1e9dfbb5:0xe87ac225766538e?sa=X",
        "serpapi_link": "https://serpapi.com/search.json?data=%214m2%213m1%211s0x865b466d1e9dfbb5%3A0xe87ac225766538e&engine=google_maps&google_domain=google.com&hl=en&q=events+in+austin&type=place"
      },
      "description": "Nutty Brown Amphitheatre Presents Bob Schneider for the Independence Bash featuring a FIREWORKS show!",
      "ticket_info": [
        {
          "source": "Seatgeek.com",
          "link": "https://seatgeek.com/bob-schneider-with-del-castillo-tickets/austin-texas-nutty-brown-cafe-2021-07-03-6-pm/concert/5404610?utm_source=google&utm_medium=event-interface",
          "link_type": "tickets"
        },
        {
          "source": "Songkick.com",
          "link": "https://www.songkick.com/concerts/39833125-bob-schneider-at-nutty-brown-cafe-and-amphitheatre?utm_medium=organic&utm_source=microformat",
          "link_type": "tickets"
        },
        {
          "source": "Eventbrite.com",
          "link": "https://www.eventbrite.com/e/bob-schneider-independence-bash-fireworks-tickets-154165576389",
          "link_type": "tickets"
        },
        {
          "source": "Gigrover.com",
          "link": "https://gigrover.com/eventtickets/bob-schneider-with-del-castillo-at-nutty-brown-cafe-on-Saturday-2021-07-03-06-00-pm/5404610",
          "link_type": "tickets"
        },
        {
          "source": "Stayhappening.com",
          "link": "https://stayhappening.com/e/bob-schneider-independence-bash-andamp-fireworks-E3LUSE3P22JO",
          "link_type": "tickets"
        }
      ],
      "venue": {
        "name": "Nutty Brown Amphitheatre",
        "rating": 4.4,
        "reviews": 544,
        "link": "https://www.google.com/search?q=Nutty+Brown+Amphitheatre&ludocid=1046994701882119054&ibp=gwp%3B0,7"
      },
      "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRhrQ4EhNEUekTwo45eeVZHa7LrVO7K1o_XqJJaXavWDbu7HlHPE9M6pBA&s"
    },
    {
      "title": "Eddie Griffin: Live in Austin",
      "date": {
        "start_date": "Jul 2",
        "when": "Today, 6:30 – 8:30 PM"
      },
      "address": [
        "Vulcan Gas Company, 418 E 6th St",
        "Austin, TX"
      ],
      "link": "https://do512.com/events/2021/7/2/eddie-griffin-live-in-austin-night-one-early-show-tickets",
      "event_location_map": {
        "image": "https://www.google.com/maps/vt/data=Et4atoigxQwjqCJa8dvci69n2_Oa2qUxJ2hYt3HLCwbaG-Gs8MasPh8BU_8Syqa62MYu5LvL6pVglnVhEVww0IHmQzsXHKSAFWVpMzH0Q0QlIkUapOc",
        "link": "https://www.google.com/maps/place//data=!4m2!3m1!1s0x8644b5a6519ff471:0xacc5be3d777cbe65?sa=X",
        "serpapi_link": "https://serpapi.com/search.json?data=%214m2%213m1%211s0x8644b5a6519ff471%3A0xacc5be3d777cbe65&engine=google_maps&google_domain=google.com&hl=en&q=events+in+austin&type=place"
      },
      "description": "Are you ready to see a comedy legend live in your backyard? No. We’re not going into your backyard. Eddie Griffin is coming to Austin. For a fun ass night, full of laughter. This is your chance to...",
      "ticket_info": [
        {
          "source": "Blcomedy.com",
          "link": "https://www.blcomedy.com/events/eddie-griffin-live-in-austin-sat-late",
          "link_type": "tickets"
        },
        {
          "source": "Awin1.com",
          "link": "https://www.awin1.com/cread.php?awinmid=11989&awinaffid=272951&ued=https://www.blcomedy.com/events/eddie-griffin-live-in-austin-sat-late",
          "link_type": "tickets"
        },
        {
          "source": "Do512",
          "link": "https://do512.com/events/2021/7/2/eddie-griffin-live-in-austin-night-one-late-show-tickets",
          "link_type": "more info"
        },
        {
          "source": "6th Street",
          "link": "https://6street.com/facebook-events/eddie-griffin-live-in-austin-friday-saturday-2/",
          "link_type": "more info"
        },
        {
          "source": "Dead-Frog",
          "link": "https://www.dead-frog.com/live-comedy/event/797877",
          "link_type": "more info"
        }
      ],
      "venue": {
        "name": "Vulcan Gas Company",
        "rating": 4.2,
        "reviews": 180,
        "link": "https://www.google.com/search?q=Vulcan+Gas+Company&ludocid=12449565916142550629&ibp=gwp%3B0,7"
      },
      "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ7pMbs_ijVD2Ndh-y3qXTFdbRVW3RKnexO7CJcv7dzsABnxrUMQjB7GVo&s"
    },
    ...
  ]
}

Google Events search results for q: Events in Chicago,  htichips: event_type:Virtual-Event,date:today

The Google Events Results API allows advanced filtering to get the results you specifically filter.
For example, the parameters above provide only today's online events.

Google Events search results for q: Events in Chicago,  htichips: event_type:Virtual-Event,date:today

JSON Example

{
  "search_metadata": {
    "id": "63401715e7d08a25e1a7cbf0",
    "status": "Success",
    "json_endpoint": "https://serpapi.com/searches/f721c4de919ae9f7/63401715e7d08a25e1a7cbf0.json",
    "created_at": "2022-10-07 12:09:57 UTC",
    "processed_at": "2022-10-07 12:09:58 UTC",
    "google_events_url": "https://www.google.com/search?q=Events+in+Chicago&ibp=htl;events&hl=en&htichips=event_type:Virtual-Event,date:today",
    "raw_html_file": "https://serpapi.com/searches/f721c4de919ae9f7/63401715e7d08a25e1a7cbf0.html",
    "total_time_taken": 8.87
  },
  "search_parameters": {
    "q": "Events in Chicago",
    "engine": "google_events",
    "htichips": "event_type:Virtual-Event,date:today"
  },
  "search_information": {
    "events_results_state": "Results for exact spelling"
  },
  "events_results": [
    {
      "title": "Chicago, IL - Build your branded custom app in 30...",
      "date": {
        "start_date": "Oct 7",
        "when": "Fri, Oct 7, 7 – 8 AM"
      },
      "address": [
        "Hosted by Software Architect"
      ],
      "link": "https://allevents.in/online/chicago-il-build-your-branded-custom-app-in-30-minutes-with-no-coding/10000404585264417",
      "description": "Build custom app for your business. Use push notifications to share #coupons, #deals, or holidays to engage your customers for free. About this Event Easily build your custom app Boost your sales...",
      "ticket_info": [
        {
          "source": "AllEvents.in",
          "link": "https://allevents.in/online/chicago-il-build-your-branded-custom-app-in-30-minutes-with-no-coding/10000404585264417",
          "link_type": "more info"
        }
      ],
      "thumbnail": "https://encrypted-tbn2.gstatic.com/faviconV2?url=https://allevents.in&client=HORIZON&size=96&type=FAVICON&fallback_opts=TYPE,SIZE,URL&nfrp=2"
    },
    {
      "title": "Chicago Date Night | Video Speed Dating",
      "date": {
        "start_date": "Oct 7",
        "when": "Fri, Oct 7, 4 – 5 PM"
      },
      "address": [
        "Hosted by Singles Speed Dating"
      ],
      "link": "https://www.meetup.com/speed-dating/events/287657912/",
      "description": "Chicago date night! Your matches will be based on your age and gender preference. This is an online event. We use Filteroff for our virtual events. You can join the event on the web...",
      "ticket_info": [
        {
          "source": "Meetup",
          "link": "https://www.meetup.com/speed-dating/events/287657912/",
          "link_type": "more info"
        }
      ],
      "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQktBWaJyjBvKoQJnEdKjOoolnq6BO_YAj8eQSWWSfOqCu08WU4kddGV6I&s"
    },
    {
      "title": "Presentation Skills-Professional 1 Day Virtual...",
      "date": {
        "start_date": "Oct 7",
        "when": "Fri, Oct 7, 7 AM – 3 PM"
      },
      "address": [
        "Hosted by Mangates"
      ],
      "link": "https://www.eventbrite.com/e/presentation-skills-professional-1-day-virtual-training-in-chicago-il-tickets-144735970183",
      "description": "Catering to the demands of busy professionals, our virtual training programs are as effective as face-to-face learning.",
      "ticket_info": [
        {
          "source": "Eventbrite.comFrom $445.00",
          "link": "https://www.eventbrite.com/e/presentation-skills-professional-1-day-virtual-training-in-chicago-il-tickets-144735970183",
          "link_type": "tickets"
        }
      ],
      "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRDLwrkpm_mwDtWUgjK2LeJOA4NAfCCN0UMXH_ZPdUWB1LFzYTQnRfxQyo&s"
    },
    ...
  ]
}