Google Events API
Our Google Events API allows you to scrape results from Google's mobile events search vertical (udm=54), the events listing Google shows for queries like events in Austin on mobile devices. Google currently serves this vertical for US English searches only, so every search is fetched with hl=en and gl=us; target a location through the search query itself, including international ones (e.g. events in Paris), or with the location and uule parameters. The exact Google URL fetched for each search is available in search_metadata.google_events_url.
The API endpoint is https://serpapi.com/search?engine=google_events
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.
uule
Optional
Parameter is the Google encoded location you want to use for the search.
uule and location parameters can't be used together.
Head to UULE Generator if you need to convert a location or GPS coordinates to uule parameter, and vice versa.
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.
output
Optional
Parameter defines the format of the result. It can be set to json (default) to get a structured JSON of the results, html to get the raw HTML retrieved, or md to get a markdown-formatted version optimized for LLMs and AI agents.
json_restrictor
Optional
Parameter defines the fields you want to include in the output, reducing payload size for faster response. See the JSON Restrictor documentation for more details.
API Results
JSON Results
JSON output includes structured data for events results.
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 yet supported by SerpApi. It gives you the raw HTML results from Google Events.
Markdown Results
Markdown output is optimized for LLMs and AI agents. It provides most of the same informational content as JSON
in a token-efficient format using tables, markdown links, and YAML frontmatter.
To access, use the output=md parameter, the /search.md endpoint, or request header Accept: text/markdown.
API Examples
Google Events search results for q: Events in Austin
The Google Events Results API allows a user to scrape events results from the Google Events vertical. SerpApi is able to make sense of this information and extract title, date, address, ticket_info, venue, thumbnail, price 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": "6aa1ead4c413a73bf959a284",
"status": "Success",
"json_endpoint": "https://serpapi.com/searches/2obCHr4bLasBW8O_n7ZVzWTsL8tasiTl3hBX2wghAXI/6aa1ead4c413a73bf959a284.json",
"created_at": "2026-09-09 23:25:08 UTC",
"processed_at": "2026-09-09 23:25:08 UTC",
"google_events_url": "https://www.google.com/search?q=Events+in+Austin&udm=54&hl=en&gl=us",
"raw_html_file": "https://serpapi.com/searches/2obCHr4bLasBW8O_n7ZVzWTsL8tasiTl3hBX2wghAXI/6aa1ead4c413a73bf959a284.html",
"total_time_taken": 0.89
},
"search_parameters": {
"q": "Events in Austin",
"engine": "google_events"
},
"search_information": {
"events_results_state": "Results for exact spelling"
},
"events_map": {
"image": "https://www.google.com/maps/vt/data=KBvhx80C8ZBGppTnyECafg_l6Yc8Ij_Pu5rIpYNaCjmkazyYnDOZRkk3jSHGVSYf3b2UkDLgS9Wzyo_iLP4YMKCm704Qpe0SqMLw5jd5QDhdyX65-ad4-XRjpIAOPQ6Dd0S3A0nhrJOB2733lhUgJSOcujStqfU0IWr3THf8bReaLYhZAxGxY9eAXvNjea1LssmnF3cVuhhQPkwFtEMvoK2HD3IT1SC6IXZpb6IPNRIIw3iq7XOUF1OwU9sHJ-HBOzcF9pt5aowWkKtolrP2OYqD3SoL6x8D0hDBjWpXI_qIuznFWRguYs14nCIoTK-gFd_olL34fvDKOmm5MzZp29xQhMAYxri1GZ3VDlJJ7nrLnX-jLqV8pUEEsF39jp6gS7oJ74TKul5mTEYriiS6-cpiD6-MRdlnafMOFkPtBKq2uZM8YeAYn89lTKfK_s39hgGrByK-RHwqKsOfWIVMPm3UTSgTtJUuahhGh0k4-qov6fdNQwFcyYkFSuktuBp_uMinGW1wYTtHc8rmOpDuBAopu9_y4Ou8WF_Qg2px2OPwhtNt-XTec9l1cUFV_YveJDhbKiDvVgZDQZ_GnbSrO3ya2mdWlS-P4CF8LCknXWWHgwrXWQH8MeEyvRdoCpxNxxWnR3I555-C2YjeZ5C50hJvuKlGKc1eXHsfzoywV1Equ8X-FcUzBVCA9mi0uUVq9DhDzzQf7855ghqco8a_oad2feoM27xryz5Y75f0EPJS6loUCBIH9rVejBGCkmgbupDo7edtima7_wH20mHqJuRqHSTaxrV2bYbC4CmqVITdfTqpgPumPrVkmt0IGw9mNM1xFqCmxZWB4ti3kTLTrtRw3KG00ovMcUQiXP75ezNwALg9_GXFg3Dnjqg7y1ooqhYd4LLocS6F5FC3PeTuFi4r86euc3Z-A8X16h8ySziF-sH8gHxHV0x_BV7wqUerEdUb5wl2dWzm0UoIjUfaUYlxxZV9NZdou2-0_QtP_L3dk7mryXmf3xvbWAonP4YOTrjdPdCeVy1LQTCf0Dya-KS5i1A1Hcv7mtbLy7sZwbMnKYdZHNNi7huzdvWL0iNxmbfrYytsUK3X3nU2W8vwRJQkNEENqPZpOLizNaHZ--XX_TEsREmAlAyMgU1i0kYTxipulY72TONPhouesIDBConGfsIlIu3XntlDvcLJ_SzVKhKtaAdznUXfPYceQ0S5lykiegtuG9nXVAFG6Jp_PLXptK-a90smOlfGm9LbHd55Fd-NO50x3B_52ExgG01zuEhO_zsNDjggU7230iYF55JyYAXxEkIUiTta6izOYhxmS5ilk9wscC4HhWQmErIqdHsAfZQh5jUyb27c_iH-wMvB-b1BYObb_1lbTb_RqyVPZd8X1CrwCnlH3JgQodweyiIVeDMv0GK6THbZHq239KSZwHYAUXufDlSZ-8P35QW38uUjMWnLK6cx6mXYPDSO4yJxy__PnfZHYH6D0yEitm3nr3OjNtZ6ZDGaUflOJHzsBOoEqQ9MN_CYo1v6bNSSQnmWlUSU7sPA5qQExpxp9o5EH6_-Ohixv_RMYL-1hh1rp_qSm6vE1jKzEXTV5xvFuiN1DVqc9JmGe2IlRUUxovisrtWxhWXvv67sjrnN_sP_rvOonWHjLL1qFC8opW65RvZQH8odud48mOBnOXYfM15UtvcuSPW756a_EUX6TPGVGiKaneN6r5vAVbAiHjFxJdqbb6FgJYxP3lFVdxmz__q0ADd_yrNswLT5SRMi6wV2ofDcuJ_UeDYW62mpcfyZaXD_I55CU3TkMOKWksFvSUgV8xThd10fi54pbDddhk-9-6QmGd7GKEslxrY16VmuaJ7-_cFEZWG_z9-HTn1tmLjBA18vecjHHvg4vtVeEh7hcbqGCbZxa4-JpIpagCE-8TFBy8RGYXrEwojdJL_a1mHHAuCMPcMakkXTIh_y6mUwrcGkutHKDW7E6BlgoUcBQuoCqgpeK2kpOd2rHQWttPS5YxtePdqMqkIzk30pyXV4WQPYVPx4f78u8X_Cw3XdeB2HhmlQsv9cTP3Gt1oz072ZSpY5ne3gFbksSffD0PGzAPjcHMK4VLYWwWEjpn4J_9SnNEkuJRJhmg_Yx6DVvf6sZKUkcFZ8f0vT9GIgM5El31n3Z6MWHhTykembq7-ivgMtolAXaPufWr0hyfz8s4oylLfHjpVaZBAhg5JtZGj234NNcFXdxyXnH5o9DR-o0INEX_OTPmEb1DC_NNTX89Gb7j5ty1OzEuVBoFgtQDPrKvLi34wkHAbCP9__nvJF1vIMbJxYK3watBeRZHoTXkYaiOApnl2thcOsjFflntdewT-haGOYjRbFV4-4WZE_9meu4YdnhnLgbYaiFshk9HA7K9S292qPJyhwsB6aXDOBNOrg5hI",
"gps_coordinates": {
"latitude": 30.28397399248833,
"longitude": -97.81402587890625
},
"zoom": 10
},
"events_results": [
{
"title": "ACL Live Tour",
"type": "Emo puppet show",
"date": {
"start_date": "Sep 10",
"when": "Sep 10, 8:30 PM"
},
"venue": {
"name": "Austin City Limits Live (ACL Live & 3TEN ACL Live)",
"link": "https://www.google.com/search?q=Austin+City+Limits+Live+%28ACL+Live+%26+3TEN+ACL+Live%29&ludocid=5268262189183100567&gl=us&hl=en&ibp=gwp;0,7",
"serpapi_link": "https://serpapi.com/search.json?device=desktop&engine=google&google_domain=google.com&ludocid=5268262189183100567&q=Austin+City+Limits+Live+%28ACL+Live+%26+3TEN+ACL+Live%29"
},
"address": [
"Austin City Limits Live (ACL Live & 3TEN ACL Live)",
"Austin, TX"
],
"event_location_map": {
"image": "https://www.google.com/maps/vt/data=5AIlNFJXHLHRVwO5qEp8hN5GTaXj7RPoXc5g_tjUQTqNlmW1xdLmK0xG5ydc0lcEVVxgUp0luSbdZznje79T6uHwkQ4GPnEkXSuk63ZYpfVn8t6kaWk4CiDmohZjVOli0CeuGZqLDBmUGfKibdCYB1FDiSfoV8lWFAIv37U4nQU2",
"link": "https://maps.google.com/?cid=5268262189183100567",
"serpapi_link": "https://serpapi.com/search.json?data_cid=5268262189183100567&engine=google_maps&google_domain=google.com&hl=en&type=search"
},
"ticket_info": [
{
"source": "axs.com",
"link": "https://www.axs.com/events/1513751?cid=aff_google",
"link_type": "tickets"
}
],
"thumbnail": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSFCIcsgrIUkQTUiEfTMZwEQoWBc-m2oNSLtlG3WZ97ZNQW1lMdXLB5h0qbfPytic-qnmoJNkR3FZEkcwU"
},
{
"title": "Boots and Hearts West: Shaboozey Tickets",
"type": "Country hip-hop concert",
"date": {
"start_date": "Sep 11",
"when": "Sep 11, 8:00 PM"
},
"venue": {
"name": "Austin City Limits Live (ACL Live & 3TEN ACL Live)",
"link": "https://www.google.com/search?q=Austin+City+Limits+Live+%28ACL+Live+%26+3TEN+ACL+Live%29&ludocid=5268262189183100567&gl=us&hl=en&ibp=gwp;0,7",
"serpapi_link": "https://serpapi.com/search.json?device=desktop&engine=google&google_domain=google.com&ludocid=5268262189183100567&q=Austin+City+Limits+Live+%28ACL+Live+%26+3TEN+ACL+Live%29"
},
"address": [
"Austin City Limits Live (ACL Live & 3TEN ACL Live)",
"Austin, TX"
],
"event_location_map": {
"link": "https://maps.google.com/?cid=5268262189183100567",
"serpapi_link": "https://serpapi.com/search.json?data_cid=5268262189183100567&engine=google_maps&google_domain=google.com&hl=en&type=search"
},
"thumbnail": "https://serpapi.com/searches/6aa1ead4c413a73bf959a284/images/yO_QATk2NRzgy5Yz65Xt0HQ83u15wKc70vKBHso8niM.jpeg"
},
"..."
]
}
JSON Structure Overview
{
"events_map": {
"image": "String - Link to the map image showing all events",
"gps_coordinates": {
"latitude": "Float - Latitude of the map center (Google's resolved locality for the query)",
"longitude": "Float - Longitude of the map center"
},
"zoom": "Integer - Zoom level of the map"
},
"events_results": [
{
"title": "String - Title of the event",
"type": "String - Type of the event (e.g. Annual carnival, Concert)",
"date": {
"start_date": "String - Start date of the event (e.g. Oct 9)",
"when": "String - Full date and time of the event (e.g. Oct 9, 2026, 10:00 AM)"
},
"venue": {
"name": "String - Name of the venue",
"link": "String - Google search link to the venue's knowledge panel",
"serpapi_link": "String - SerpApi link to fetch the venue's knowledge panel with the Google Search API"
},
"address": [
"String - Venue and location lines of the event"
],
"event_location_map": {
"image": "String - Link to the map image of the venue",
"link": "String - Google Maps link to the venue",
"serpapi_link": "String - SerpApi link to fetch the venue with the Google Maps API"
},
"ticket_info": [
{
"source": "String - Domain of the ticket seller",
"link": "String - Link to buy tickets or get more information",
"link_type": "String - Type of the link (e.g. tickets)"
},
...
],
"price": "String - Starting ticket price of the event (e.g. $22)",
"extracted_price": "Float - Starting ticket price as a number",
"thumbnail": "String - Thumbnail image of the event"
},
...
]
}