Google Event Details API
API Overview
Our Google Event Details API allows you to scrape the full details of a single Google event, including its title, date, address, ticket_info, venue, description, local_map and other relevant data.
Pass an event_token from the events_results of the Google Search API to retrieve the details of that event.
Event tokens are time-sensitive. For the most complete results (e.g., ticket information), use the event_token soon after it is retrieved.
How to Get Event Tokens
Google shows an events module for searches with event intent. For example: events in austin, concerts near me, or concerts in miami.
Run such a query through the Google Search API and each event in events_results will include an event_token and a ready-made serpapi_event_details_link pointing to this API.
Whether the events module appears (and which events it lists) can vary with the location, gl and hl parameters of the search.
API Parameters
Search Query
event_token
Required
Parameter defines the event token for the event you want to retrieve details for. The token is returned as event_token in the events_results of Google Search API results.
Localization
gl
Optional
Parameter defines the country to use for the Google Event Details search. It's a two-letter country code. (e.g., us for the United States, uk for United Kingdom, or fr for France). Defaults to us. Head to the Google countries page for a full list of supported Google countries.
The country sets the date and time format and the currency of prices, and can change which ticket sellers are listed. It doesn't need to match the event's location: for example, with us, prices for an event in London are converted to US dollars.
Some fields depend on the country: date.start_date isn't available for most European countries (e.g. de or fr), and the venue's description may be missing for some others.
hl
Optional
Parameter defines the language to use for the Google Event Details search. It's a two or three-letter language code. (e.g., en for English, es for Spanish, or fr for French), optionally followed by a two-letter or three-digit region code (e.g., en-gb for British English, or es-419 for Latin American Spanish). Defaults to en. Head to the Google languages page for a full list of supported Google languages.
The language applies to the text Google writes for the event, such as dates, venue types and venue descriptions.
Google often doesn't provide the event's "About" section and the venue's description in languages other than English, so description, description_source and the venue's description may be missing when hl isn't en.
Advanced Parameters
nearby_places
Optional
Parameter for fetching the nearby_places section (places near the event venue). It can be set to 1 or true.
When enabled, up to 10 places near the event venue will be returned.
similar_events
Optional
Parameter for fetching the similar_events section (other events related to this one). It can be set to 1 or true.
When enabled, a list of similar events will be returned, each with its own event_token.
Similar events are sourced from Google's event data and may be returned even when the event card doesn't display the section.
Serpapi Parameters
no_cache
Optional
Parameter will force SerpApi to fetch the Google Event Details 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 event details.
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 Event Details.
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 Event Details for a Billy Idol concert
The Google Event Details API allows a user to scrape the details of a single event from Google. SerpApi is able to make sense of this information and extract title, date, address, ticket_info, venue, description, local_map, nearby_places, similar_events, search_results and more. To get started, retrieve an event_token from the events_results of the Google Search API, or follow the serpapi_event_details_link provided with each event.
{
"search_metadata": {
"id": "6aa26451c413a78d90deec05",
"status": "Success",
"json_endpoint": "https://serpapi.com/searches/2G5QK2bwVAQyRD2_5ihysWDVioF07TV4EhnxqIOWd9k/6aa26451c413a78d90deec05.json",
"markdown_endpoint": "https://serpapi.com/searches/2G5QK2bwVAQyRD2_5ihysWDVioF07TV4EhnxqIOWd9k/6aa26451c413a78d90deec05.md",
"created_at": "2026-09-10 08:03:29 UTC",
"processed_at": "2026-09-10 08:03:29 UTC",
"google_event_details_url": "https://www.google.com/async/callback:8243?fc=EqIICuIHQUppVDR0SjRUa2NneFN5cVRRdVN6ODdxZ1p...&fcv=3&yv=3&cs=1&hl=en&gl=us&async=_fmt:pc",
"raw_html_file": "https://serpapi.com/searches/2G5QK2bwVAQyRD2_5ihysWDVioF07TV4EhnxqIOWd9k/6aa26451c413a78d90deec05.html",
"prettify_html_file": "https://serpapi.com/searches/2G5QK2bwVAQyRD2_5ihysWDVioF07TV4EhnxqIOWd9k/6aa26451c413a78d90deec05.prettify",
"total_time_taken": 0.95
},
"search_parameters": {
"event_token": "EqIICuIHQUppVDR0SjRUa2NneFN5cVRRdVN6ODdxZ1pPRGlN...",
"engine": "google_event_details",
"gl": "us",
"hl": "en",
"nearby_places": true,
"similar_events": true,
"search_results": true
},
"event_details": {
"title": "Billy Idol",
"price": "From $81",
"extracted_price": 81,
"date": {
"start_date": "Sep 5",
"when": "Sat, Sep 5, 2026, 8:00 PM"
},
"address": [
"Fontainebleau Las Vegas, 2777 S Las Vegas Blvd, Las Vegas, NV 89109"
],
"local_map": {
"image": "https://www.google.com/maps/vt/data=30Sh8hzC5FzGvFoe3iIeorUmtCcH57wJc-oe9BmpI5mDi3s0uQoW9rXZpTMMJttKDikFcPSXWdd5URaQAf_IsnBoCQpKlrN_jk5FL99LWLN5zpVh6HRRglL-w294QcT8kCk8CqAT43Im18POmwOpAK1-49Dpd93yvmQ73pgH6xiE",
"link": "https://maps.google.com/maps?fc=EqIICuIHQUppVDR0SjRUa2NneFN5cVRRdVN6ODdxZ1pPRGlNeVFXZEVLd21HNS0xNzdUTU01WVBFMUdKcXpzRUcyOTVoN0FMTGthcTBobW9UbEVrcGxZaWpnMnpLLXQxcW5xaXlMRXBscENVUzVwZUxRTG5DeVBWOTdYeUdSTU9PQnMyZlA0ODdyLTlwY1ZMVm5kcHZjZFFJVXJZWnB1N2ZIZ3BoTGQ3ZzRUTFRwOXRSTDVIMjlmdnBEaGZpYlF1bG9rOEtEQjd3TlZTeVl3VGFXYlVHMjE3aUZTZlJyT2ZTektPU19vUGZ3VHlrOW8ydTRTRTMzQ0hkRVVyOXZHaUxIc2N3UUJ0djFqcWdVcDI1TGRud3p5ZERBcXdOYlBQZGVzOFFlSms2aEpINHZWb1RrWFhqQk9Bb0VFSFMzUkRCYVM1Q3g3UThjTVJENnNkMFdzUWNCWEJ4S0NOOUdoZWhTaUpSdThNU0JTemJGQnhBUGFWQVFKaXpGNERXbTNhdXowMFJ0cTBITkNXem5KcTRsZllxekFCMWZlNW1TVmhIN0VjeXNzN1ZBVHo3RGF5MHFKa2dpQ21OSVlhaFVtenMyOVh1aUpVWEdzQW9JSDhIc0NYRU5YQl9nUks5YjBnSGJTaGFpN1VHaE5kb2U4dHdVRE41eXBVbGVYVUpUaG5EZ0F5Zll5SzBXcHdPZkV2UGx0ZDAxVFZKc3JfWkxvMERpX0kxODFhVlBLNlg2OGNIdkFfV1pEUU9yYzVpUEFLVVQ0TTFpS0U0MUI3bEhaX3NfbkY5V2dGUFZVZFlwaFNidlRtWlRXbG1pcHZiaWVRWTJqRXQ2SWdyZUFQVG1HWnJvZUhfcWthZ3ZJc3NCU2VvLWxHTjZDeWVrdkhiZmZKdmhuazZMVWRVWmRQVUFULVZlUDZXVy1HUUhycHRDTlBYODVjZzVfNndRNVNPOGljbmY1WFNEX1FwMWRZdGxqQjMxbXFqVEl5WXg2LWM1OU9zR1BlWnl0RDY1WmU3ZFdIY3hPQndQdE1ZcHRtaExTQ3c3d195akF3MWVMVHI3V3pZa2NycWJjVTlZWUJCaWNueG41SmZDYmtzOV94R2lQNHlncXRnbFZZcFI2YjNJTmhmVkNhdTVsV2hub1ZOeVludkxUSWZtSlUybW82TUllY2tST1RfZWthUnlkNHZ0SnMxTmhZeGN4MTdXcTVWNlFJczFDTmdWWU5JSVMtRXA5cUJFUGNBbEJhSC1JLUM2QXl3LS0xOFNLVzBEc0IyTml6ZXhTVzN0aTVtZDBDOEtZQnBOUGpwMkxOT1lmU1ZqSUNFSk83NldpdxIXMmNHTWFzbU5LZk9icHRRUGtjbUtnQTQaIkFEc3I5ZlFldFNqcnFWeHB1LVdOZlRZWUVGeUJFN182NHc&fcv=3&cs=1&um=1&ie=UTF-8&fb=1&gl=us&sa=X&ftid=0x80c8c57ddfb701f5:0xd02b955c78c33b74",
"serpapi_google_maps_link": "https://serpapi.com/search.json?engine=google_maps&google_domain=google.com&hl=en&place_id=ChIJ9QG3333FyIARdDvDeFyVK9A"
},
"description": "All Ages Event Doors 7:00 PM / Show 8:00 PM Re-entry allowed. Entry/re-entry cutoff approximately 15 minutes before end of show. Supporting acts are subject to change without notice. No refunds or exchanges. Taxes required by Nevada law are added to the purchase of each ticket at time of checkout.",
"ticket_info": [
{
"source": "Ticketmaster",
"source_icon": "https://encrypted-tbn3.gstatic.com/faviconV2?url=https://www.ticketmaster.com/&client=TTD_EVENTS&type=FAVICON&size=32&fallback_opts=TYPE,SIZE,URL&nfrp=1",
"link": "https://www.google.com/goto?url=CAES5wEB6zswFXs9CdAGq1ltGhHxD-ASNnJG_kZzPs9eM0SUEDtjiesvX5mCuUS-epMkbIc_Jxirs23Fd9UXwyRuaPw_zoisFhRN4ECTmB3hi_F3mWr0OdGur1ASXzLRYwwmGkZZSN92Me584Uiwq4EIGhbUgyfUrz8pNZHUPespxYQPMoK9o9gHkPY7ACR0nMBYFHWsBb92x98SwGGp4vJ7SE1zTmnmzcZV-8xYfX2qA3no_u0ezNXmFcTp28DnXspMZ60TsjKsiMYU4KXn0ce9RCWAYRVcjVaoKzuvz87yFyuv4Axz8LswELM"
},
{
"source": "Go Tickets",
"source_icon": "https://encrypted-tbn1.gstatic.com/faviconV2?url=https://gotickets.com/&client=TTD_EVENTS&type=FAVICON&size=32&fallback_opts=TYPE,SIZE,URL&nfrp=1",
"link": "https://www.google.com/goto?url=CAES5QEB6zswFYnttip7oTCGF37XzVPLGebPaHUJjmFtozlgS3Yrgv8rp3UtjVq-5zjk1BvcEHpQaAv4vBlGCEd_5CMLorD2XaKNlLRoY3Ir2CUNkARNWL_BKWU2SsmiFv3MeOtpXy9lQ9vhxWItdDDg0MFz-XJnjvj6_SxnVeTFa3XCZ_CN3OegvKiqWGgbsYJIs_JVyNrPjnUvpkPm1m8aWoe12WxTF1xqYH1B92QjHX1u7FdTyDDHsYVL1eKZrWiE52P_Xklv9eV7lFNrdkNgmUHkBKTwEoEZqaQG5BH7aJGFK30TBK48"
},
"..."
],
"venue": {
"name": "Fontainebleau Las Vegas",
"type": "5-star hotel",
"thumbnail": "https://lh3.googleusercontent.com/grass-cs/ACvplmOc_8wkiuv7QOAN5nNzpS87x41xvQcrTIaJI7XxmSi1gmF9cYnyNGHfteMZRYeqksGyS8D1IKvkZ2p0rswr-NkhltbNwE8vMqlkhdrMUn1kIxS6nOQWa4_htu5si89Mym56Lh2k1A=s148-w148-h148-n-k-no",
"rating": 4.4,
"reviews": 10000,
"link": "https://www.fontainebleaulasvegas.com/"
},
"thumbnail": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSyxVPLZSAnm1Ixc1xq9xUYMnimyPAnhSid-RXwYC8Ub6brZck9Rin7GwU-k_eHOeg52Doyr8dsUZ3a-C0",
"nearby_places": [
{
"title": "Mother Wolf Las Vegas",
"type": "Italian",
"rating": 4.5,
"reviews": 874,
"price": "$100+",
"link": "https://www.google.com/search?sca_esv=1f9121a7cdf920c7&hl=en&cs=1&output=search&q=Mother+Wolf+Las+Vegas&ludocid=13497242728161290190&ibp=gwp;0,7&lsig=AB86z5VdlkpzRIkWrxS0iGwd3sWQ",
"ludocid": "13497242728161290190",
"lsig": "AB86z5VdlkpzRIkWrxS0iGwd3sWQ",
"serpapi_google_link": "https://serpapi.com/search.json?device=desktop&engine=google&google_domain=google.com&lsig=AB86z5VdlkpzRIkWrxS0iGwd3sWQ&ludocid=13497242728161290190&q=Mother+Wolf+Las+Vegas",
"open_state": "Closed · Opens 5 PM",
"location": "Las Vegas, NV",
"thumbnail": "https://lh3.googleusercontent.com/grass-cs/ACvplmOk4X-nfn-Bt9bF76IWXsmXLe7cj258gHd3wlAjUUVWe2fgJ3EiqRCR-bv92bpcA6cz1VJKFjsYawAKK9UlBJKVPpjvW0K7Vn1xKVVL7QR3ymRvYwUYuxCTA5cmTeCV1fMrLr4=s148-w148-h148-n-k-no"
},
{
"title": "Cantina Contramar",
"type": "Mexican",
"rating": 4.3,
"reviews": 85,
"price": "$100+",
"link": "https://www.google.com/search?sca_esv=1f9121a7cdf920c7&hl=en&cs=1&output=search&q=Cantina+Contramar&ludocid=9557567542065746948&ibp=gwp;0,7&lsig=AB86z5Xew_NvV--Ae3QtQMB2Hx6t",
"ludocid": "9557567542065746948",
"lsig": "AB86z5Xew_NvV--Ae3QtQMB2Hx6t",
"serpapi_google_link": "https://serpapi.com/search.json?device=desktop&engine=google&google_domain=google.com&lsig=AB86z5Xew_NvV--Ae3QtQMB2Hx6t&ludocid=9557567542065746948&q=Cantina+Contramar",
"open_state": "Closed · Opens 5 PM",
"location": "Las Vegas, NV",
"thumbnail": "https://lh3.googleusercontent.com/grass-cs/ACvplmPxXfWDwYzNK4RmwFQM3XiCSmPra_WPsBS06DwT4F5BcRgvbj5l6yNejSmXLfscGu4KyzL7IGKWxUF4j6-jreOflPOJ-fLgV-mkYI1Aj0HX1tibWqEdKgvAXonWR2KnY0IXX_IOS3sp-1RS=s148-w148-h148-n-k-no"
},
"..."
],
"similar_events": [
{
"title": "BILLY IDOL - MARYLAND HEIGHTS, MO",
"date": {
"start_date": "Today",
"when": "Thu 6:30 PM"
},
"venue": "Hollywood Casino Amphitheater",
"location": "Maryland Heights, MO",
"link": "https://www.ticketmaster.com/billy-idol-its-a-nice-day-maryland-heights-missouri-09-10-2026/event/06006481880C5E66?utm_medium=affiliate&utm_source=5128861-Google%20Events",
"thumbnail": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRUVm7u2mvpeoxcbmTa1fwci-zXPgBRqzz4WraGnzODgHt-ZLZ_8MsRPjdOdmzGvk4MhxD1KI4sJPeuZzc",
"event_token": "ErYCCvcBQUppVDR0SnRJa3YyWktqb0tPaEUzc0J4RGFVNEhl...",
"serpapi_event_details_link": "https://serpapi.com/search.json?engine=google_event_details&event_token=ErYCCvcBQUppVDR0SnRJa3YyWktqb0tPaEUzc0J4RGFVNEhl..."
},
{
"title": "Billy Idol",
"date": {
"start_date": "Today",
"when": "Thu 8:00 PM"
},
"venue": "Acrisure Amphitheater",
"location": "Grand Rapids, MI",
"link": "https://www.ticketmaster.com/pitbull-premiums-party-decks-4tops-lounge-grand-rapids-michigan-09-10-2026/event/080065012403349B?utm_medium=affiliate&utm_source=5128861-Google%20Events",
"thumbnail": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQ77EvCAuA2Y-VW2rqpVwG4HYfu_dJnuvvdNFhA_g4QR7zhTM2rjMh1mSHj-cuIFnlEnENo1xl6ffETXTo",
"event_token": "EosCCswBQUppVDR0SXB1dGZhMjZqVjRRYUhvdnFhZE9QT1BY...",
"serpapi_event_details_link": "https://serpapi.com/search.json?engine=google_event_details&event_token=EosCCswBQUppVDR0SXB1dGZhMjZqVjRRYUhvdnFhZE9QT1BY..."
},
"..."
],
"search_results": [
{
"title": "Billy Idol: Hot In The City Tickets Sep 05, 2026 Las Vegas, NV",
"link": "https://www.google.com/goto?url=CAESogEB6zswFZ1PwSBivsYqAqpqSB1KExk7eS8wFJEuE2w0Jky1m_Vno5ETQo2p8wc2fNJ1YzauFo6pgwO3edRVchLr5fZuvJ7-GIoTsH3r6BxYMwzlH_eQoY8uzGxo8RR5POT8OK8XpTXpSCuU9HtaIcBzyYG4Uedpbdjt9SrCAfWIkiVfozRFUPSazqMvDWBEGDbnm0tG12ugRwq7Ha20gZQhqSM",
"displayed_link": "https://www.ticketmaster.com › ... › Rock › Billy Idol",
"snippet": "Buy Billy Idol: Hot In The City tickets at the Fontainebleau Las Vegas ... Sat • Sep 05, 2026 • 8:00 PMFontainebleau Las Vegas, Las Vegas, NV. More Info."
},
{
"title": "Billy Idol",
"link": "https://www.google.com/goto?url=CAESdwHrOzAVlQm0_gv6wmK_7to7qykR3_tFMoNOV-QfOfbbCjvmRfd6PBYmZW_wvH4qJE3ieTH2xTxK-RrjU0C1Vl029e0VjN9c3rnzDZLrFHP2znxhCchN1_KgvPC2VcliYnDO1DUPRngNF02BDI2MNZQEQVJiEOhm",
"displayed_link": "https://www.fontainebleaulasvegas.com › entertainment",
"snippet": "Singer, songwriter, musician, and actor Billy Idol will be coming to BleauLive Theater for 5 dates: August 28 & 29, and September 2, 4, & 5."
},
"..."
]
}
}
JSON Structure Overview
{
"event_details": {
"title": "String - Title of the event",
"price": "String - Starting ticket price of the event (e.g. From $81)",
"extracted_price": "Float - Starting ticket price as a float",
"date": {
"start_date": "String - Start date of the event (e.g. Sep 5)",
"when": "String - Full date and time of the event"
},
"address": [
"String - Address lines of the event location"
],
"local_map": {
"image": "String - Link to the map thumbnail image of the event location",
"link": "String - Link to the Google Maps place of the event location",
"serpapi_google_maps_link": "String - SerpApi link to fetch the place with the Google Maps API"
},
"description": "String - Description of the event",
"description_source": "String - Link to the source of the description",
"ticket_info": [
{
"source": "String - Name of the ticket seller",
"source_icon": "String - Icon of the ticket seller",
"link": "String - Link to buy tickets or get more information",
"price": "String - Ticket price for this seller",
"extracted_price": "Float - Ticket price as a float"
},
...
],
"venue": {
"name": "String - Name of the venue",
"type": "String - Type of the venue (e.g. Concert hall, 5-star hotel)",
"description": "String - Description of the venue",
"thumbnail": "String - Thumbnail of the venue",
"rating": "Float - Rating of the venue",
"reviews": "Integer - Number of reviews of the venue",
"link": "String - Link to the venue's website"
},
"thumbnail": "String - Thumbnail image of the event",
"nearby_places": [ // Requires the `nearby_places` parameter
{
"title": "String - Name of the place",
"type": "String - Type of the place (e.g. Italian, Bar)",
"rating": "Float - Rating of the place",
"reviews": "Integer - Number of reviews of the place",
"price": "String - Price range of the place (e.g. $20–30)",
"link": "String - Link to the Google search for this place",
"ludocid": "String - Google CID of the place",
"lsig": "String - Google lsig identifier of the place",
"serpapi_google_link": "String - SerpApi link to fetch this place with the Google Search API",
"open_state": "String - Opening state of the place (e.g. Open · Closes 10 PM)",
"location": "String - Location of the place (e.g. Las Vegas, NV)",
"thumbnail": "String - Thumbnail of the place"
},
...
],
"similar_events": [ // Requires the `similar_events` parameter
{
"title": "String - Title of the similar event",
"date": {
"start_date": "String - Start date of the event (e.g. Sep 10)",
"when": "String - Weekday and time of the event (e.g. Thu 6:30 PM)"
},
"venue": "String - Name of the venue",
"location": "String - Location of the event (e.g. Maryland Heights, MO)",
"link": "String - Link to the event page (e.g. ticket seller or event site)",
"thumbnail": "String - Thumbnail image of the event",
"event_token": "String - Token to fetch this event with this API",
"serpapi_event_details_link": "String - SerpApi link to fetch this event with the Google Event Details API"
},
...
],
"search_results": [ // Requires the `search_results` parameter
{
"title": "String - Title of the search result",
"link": "String - Link to the search result",
"displayed_link": "String - Displayed source URL of the search result",
"snippet": "String - Snippet text of the search result"
},
...
]
}
}