Google Events schema

The Google Search endpoint returns the events of Google’s events block as result.events, on desktop and mobile, with no flag and at no extra cost. events is omitted when the SERP has no events block.

Google shows the block in two layouts:

A carousel of event cards, on queries such as “events in new york this weekend”. Each card has a name, an image, a date, a venue and a city.
A list of ticket offers, on an artist’s queries (each row is a date of the tour: date, time, venue and city) and in the panel of a venue or a landmark (each row is an event: name, image and date). Each row has its ticket sellers, with their prices when Google shows them. The block can be in a section of the panel, open or closed.

Events ticket list in Google Search, with a tour date opened on its sellers

Every event the page holds is returned, including the ones the user sees by scrolling the carousel or under “More”, and every seller of a row, including the ones the user sees by opening it.

Events structure

Field	Type	Description
`expanded`	boolean	`true` if the block is open on the page; `false` when it sits in a closed section the user opens with a tap
`items`	array	The events, in page order. See below

Event

position is always present. The other fields are included only when Google shows them: a card has a title and a kgmid and no tickets, a tour date has no title, and a list row has no description.

Field	Type	Description
`position`	number	Position within the block (1-indexed)
`title`	string	Name of the event
`kgmid`	string	Google Knowledge Graph id of the event (`"/g/11zh1s6434"`). Use it to match an event across queries and devices, or to tell apart two events with the same name
`date`	string	Date label as shown (`"Sat, Nov 14"`, `"Tomorrow"`, `"Nov 19"`)
`dateTime`	string	Date line as shown, with the start time when Google shows one (`"Nov 14, 2:00 PM"`)
`venue`	string	Venue of the event
`location`	string	City or district of the venue (`"New York, NY"`)
`description`	string	Short description shown on the card (`"5K road race"`)
`thumbnail`	string	URL of Google’s image of the event. Omitted when the page inlines the image instead of linking it
`price`	object	Lowest price of the row’s tickets, the one the row shows after “from”. See Price
`tickets`	array	The row’s ticket sellers, in page order. See Ticket

Ticket

Field	Type	Description
`source`	string	Name of the seller (`"Ticketmaster"`, `"Bandsintown"`)
`link`	string	URL of the seller’s page for the event
`redirectLink`	string	Google’s `/goto` redirect for `link`. See Redirect links
`icon`	string	URL of the seller’s logo
`price`	object	The seller’s lowest price, when Google shows it. See Price
`priceWithFees`	object	The same price with fees, when Google shows it (`"£276 with fees"`). See Price
`officialSeller`	boolean	`true` when Google marks the seller as the official one

A row with many sellers can hold more links than cloro resolves for one page. A ticket whose link is not resolved has an empty link; pass its redirectLink to POST /v1/monitor/google/goto to get the destination.

Price

Field	Type	Description
`value`	number	Numeric price
`currency`	string	Currency symbol (`$`, `£`, `€`, `R$`)
`raw`	string	Price text as shown (`"£228"`, `"£276 with fees"`)

A free event’s price has only raw, the word Google shows ("Grátis"). Dates, times and prices are text as shown, in the language of the SERP.

Response example

A response to events in new york this weekend, on mobile:

{
  "success": true,
  "result": {
    "events": {
      "expanded": true,
      "items": [
        // …
        {
          "position": 4,
          "title": "Secrets From Below: An Underground Tour of NYC New York Tickets",
          "kgmid": "/g/11zh1s6434",
          "date": "Sat, Nov 14",
          "dateTime": "Nov 14, 2:00 PM",
          "venue": "The Fulton Center",
          "location": "New York, NY",
          "thumbnail": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSnPFph_UXXnz-nvf9NENBjyto1Znc4S04qob6hMyjkRXeajUlxyc-o-E3H7uQ6Y0ibyZLW_WmcynU-I7Y"
        }
        // …
      ]
    }
  }
}

A tour date, from ed sheeran tour in the United Kingdom:

{
  "position": 2,
  "date": "Oct 29",
  "dateTime": "Thu 20:00",
  "venue": "Seminole Hard Rock Hotel & Casino",
  "location": "Davie, FL",
  "price": { "value": 228, "currency": "£", "raw": "£228" },
  "tickets": [
    {
      "source": "Ticketmaster",
      "link": "https://www.ticketmaster.com/…",
      "redirectLink": "https://www.google.com/goto?url=CAES4wEB6zswFW5MrHH3GjFjSe6o…",
      "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",
      "price": { "value": 228, "currency": "£", "raw": "£228" },
      "priceWithFees": { "value": 276, "currency": "£", "raw": "£276 with fees" },
      "officialSeller": true
    },
    {
      "source": "Bandsintown",
      "link": "https://www.bandsintown.com/…",
      "redirectLink": "https://www.google.com/goto?url=CAESwgEB6zswFR9xlJ6IGQiP…",
      "icon": "https://encrypted-tbn2.gstatic.com/faviconV2?url=https://www.bandsintown.com/&client=TTD_EVENTS&type=FAVICON&size=32&fallback_opts=TYPE,SIZE,URL&nfrp=1",
      "officialSeller": false
    }
  ]
}

Overview

ChatGPT

Google

Perplexity

Google AI Mode

Bing AI Mode

Gemini

Google News

Async tasks

Utilities

Google Events schema

Events structure

Event

Ticket

Price

Response example

​Events structure

​Event

​Ticket

​Price

​Response example

Events structure

Event

Ticket

Price

Response example