Google Events schema - cloro
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
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
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.
Navigate to header: Events structure Events structure
expanded
and
items
are always present.
| 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 |
Navigate to header: Event 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 |
Navigate to header: Ticket Ticket
source
,
link
and
officialSeller
are always present. The other fields are present only when Google shows them.
| 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.
Navigate to header: Price 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.
Navigate to header: Response example 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"
:
}
// …
]
}
}
}
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"
:
,
"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"
:
,
"officialSeller"
:
false
}
]
}
Was this page helpful?
Ask a question...