> ## Documentation Index
> Fetch the complete documentation index at: https://cloro.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Events schema

> Schema for the events of Google's events block returned by the Google Search endpoint: name, date, time, venue, city, image, price and ticket sellers.

The [Google Search endpoint](https://cloro.dev/docs/api-reference/endpoint/monitor-google.md) 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.

![Events carousel in Google Search](https://mintcdn.com/cloro/PZPqGJzFe70qshKt/images/google/search-events.webp?fit=max\&auto=format\&n=PZPqGJzFe70qshKt\&q=85\&s=4f48a4f0dbd46b1d5aebf70366ca54c3)

Events carousel in Google Search

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](https://mintcdn.com/cloro/PZPqGJzFe70qshKt/images/google/search-events-list.webp?fit=max\&auto=format\&n=PZPqGJzFe70qshKt\&q=85\&s=ae53652199628928a266c77bdb1505d8)

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](#price) |
| `tickets` | array | The row's ticket sellers, in page order. See [Ticket](#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](https://cloro.dev/docs/api-reference/endpoint/google/resolve-goto.md) |
| `icon` | string | URL of the seller's logo |
| `price` | object | The seller's lowest price, when Google shows it. See [Price](#price) |
| `priceWithFees` | object | The same price with fees, when Google shows it (`"£276 with fees"`). See [Price](#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`](https://cloro.dev/docs/api-reference/endpoint/google/resolve-goto#resolve-a-link) 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:

```json theme={null}
{
  "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:

```json theme={null}
{
  "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
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.