Google Events schema - cloro

Google

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"

:

"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

}

]

}

Was this page helpful?

Ask a question...

Google Search endpoint

Navigate to header: Price

Navigate to header: Ticket

Redirect links

POST /v1/monitor/google/goto

Navigate to header: Events structure

Navigate to header: Event

Navigate to header: Response example