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
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.
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.
Advanced Filters
htichips
Optional
Parameter allows the use of different filters.date:today
- Today's Eventsdate:tomorrow
- Tomorrow's Eventsdate:week
- This Week's Eventsdate:today
- Today's Weekend's Eventsdate:next_week
- Next Week's Eventsdate:month
- This Month's Eventsdate:next_month
- Next Month's Eventsevent_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
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.
zero_trace
Optional
Enterprise only. Parameter enables ZeroTrace mode. It can be set to false
(default) or true
. Enable this mode to skip storing search parameters, search files, and search metadata on our servers. This may make debugging more difficult.
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".
{
"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.
{
"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"
},
...
]
}