Google Local Pack schema - cloro

Google

Google Local Pack schema

Schema for Google’s local pack (map-backed 3-pack) returned by the Google Search endpoint, including ratings, category, address, phone, and hours.

Google’s local pack (the “3-pack”) is the map-backed block of local businesses shown for local-intent queries such as

best pizza in new york city

or

plumbers in houston

. The

Google Search endpoint

returns it as

result.localResults

, one entry per place — no separate API call. For use cases, pricing context, and copy-paste examples, see the

Local Pack API

page on the product site.

Local pack (Businesses) on the Google SERP

localResults

is omitted from

result

when the module is absent — treat it as optional rather than expecting an empty array.

The pack only exposes its visible places (typically 3). When Google renders a “More places” / “More businesses” control, the response also includes

result.localResultsMoreLink

— the absolute URL of Google’s expanded

Local Finder

for the query. The expanded list is not embedded in this response; follow that link to retrieve it.

Google’s separate hotels/travel pack is a distinct module and is not surfaced in

localResults

.

Navigate to header: Place structure Place structure

Desktop and mobile (

device: "mobile"

) return the same fields.

position

and

title

are always present. Every other field is included only when Google renders it for that place, so field availability varies by query (restaurant packs tend to carry

price

; service packs tend to carry

yearsInBusiness

,

phone

, and

hours

).

Field Type Description
position number Position within the pack (1-indexed)
title string Business name as displayed on the SERP
placeId string Google entity id for the place (e.g. "/g/11bw4ws2mt" )
cid string Google’s numeric place id (CID) as a decimal string. https://maps.google.com/?cid=<cid> opens the place. Not sent for the newer layout that most German, French, Spanish, Italian, Danish and Polish SERPs use.
link string Google viewer URL for the place: the page that opens when you click the place on the SERP. For a place listed by another supplier , that supplier’s page.
redirectLink string Google’s redirect that link was resolved from, when Google served one
rating number Rating as displayed by Google
ratingScale number Scale of rating ( 5 or 10 ), when the card shows it. Without it, rating is out of 5.
reviews string Review count as displayed by Google (e.g. "26K" ). Free-form string — not normalized to a number.
price string Price band as displayed by Google (e.g. "$10–20" ). Currency symbol matches the locale.
type string Business category (e.g. "Pizza" , "Plumber" )
yearsInBusiness string Years-in-business badge, when shown (typical on service-style packs)
address string Street address or locality as displayed on the SERP
phone string Phone number. Desktop gives it as Google displays it ( "(702) 777-3777" ); mobile gives the number from the card’s Call button ( "+17027773777" ). When the card does not show it, it comes from the place data in the page, in the format Google uses for the language. Not sent for the newer layout.
hours string Opening-hours text as displayed (e.g. "Open · Closes 11 PM" , "Open 24 hours" )
description string Trailing snippet — a review quote or a service-options line
links object Action links, when rendered. See Links below.
supplier object The site that lists the place. Only in the EU places unit .

Navigate to header: Links Links

On desktop, service-style packs (plumbers, salons, dentists, …) render each place with action buttons. On mobile, most packs do. The buttons arrive in

links

:

Field Type Description
website string The business’s own website URL
directions string Absolute Google Maps directions URL

Each key is included only when Google rendered that button, with one exception: when the card has no website button,

website

comes from the place data in the page. On desktop, restaurant packs render places as plain buttons, so their

links

has only that

website

, if Google has one. The newer layout that most German and French SERPs use carries no

links

object. Use

link

to open those places.

Navigate to header: EU places unit EU places unit

In the EU, Google often shows a list of suppliers (Google, TheFork, UberEats, …) instead of the local pack, each with its own places.

localResults

returns the places of every supplier, open or collapsed, in page order. The same business can appear once per supplier.

EU places unit in Google Search: Google open, Lieferando collapsed

Each place carries

supplier

:

Field Type Description
name string Supplier name ( "TheFork" )
expanded boolean true if this supplier is open on the page
domain string Supplier’s domain ( "www.thefork.com" )
link string The supplier’s “See more on …” page
redirectLink string Google’s redirect that link was resolved from, when Google served one

Places from suppliers other than Google have no

placeId

.

localResultsMoreLink

is present only when Google is the open supplier.

Navigate to header: Response examples Response examples

Navigate to header: Restaurant pack Restaurant pack

A response to

best pizza in new york city

:

{

"success"

:

true

,

"result"

: {

"localResults"

: [

{

"position"

:

1

,

"title"

:

"Joe's Pizza Broadway"

,

"placeId"

:

"/g/11bw4ws2mt"

,

"cid"

:

"4280570365733019477"

,

"link"

:

"https://www.google.com/searchviewer/10?svid=CAwSHRIbCgNwdnESFENnMHZaeTh4TVdKM05IZHpNbTEwGAo"

,

"rating"

:

4.4

,

"reviews"

:

"26K"

,

"price"

:

"$10–20"

,

"type"

:

"Pizza"

,

"address"

:

"1435 Broadway"

,

"description"

:

"

\"

Fast service, great atmosphere, and truly scrumptious pizza.

\"

"

},

{

"position"

:

2

,

"title"

:

"John's of Bleecker Street"

,

"placeId"

:

"/g/11b8zbnw8g"

,

"cid"

:

"4740722753943719540"

,

"link"

:

"https://www.google.com/searchviewer/10?svid=CAwSHRIbCgNwdnESFENnMHZaeTh4TVdJNGVtSnVkemhuGAo"

,

"rating"

:

4.6

,

"reviews"

:

"8.4K"

,

"price"

:

"$10–20"

,

"type"

:

"Pizza"

,

"address"

:

"278 Bleecker St"

,

"description"

:

"

\"

Funky fun vibes, efficient and polite staff, DELICIOUS pizza.

\"

"

}

],

"localResultsMoreLink"

:

"https://www.google.com/search?q=best\+pizza\+in\+new\+york\+city&udm=1"

}

}

Navigate to header: Service pack Service pack

A response to

plumbers in houston

:

{

"success"

:

true

,

"result"

: {

"localResults"

: [

{

"position"

:

1

,

"title"

:

"Village Plumbing, Air & Electric"

,

"placeId"

:

"/g/1td7nq1l"

,

"cid"

:

"9249000149373724197"

,

"link"

:

"https://www.google.com/searchviewer/10?svid=CAwSGxIZCgNwdnESEkNnc3ZaeTh4ZEdRM2JuRXhiQRgK"

,

"rating"

:

4.8

,

"reviews"

:

"10K"

,

"type"

:

"Plumber"

,

"yearsInBusiness"

:

"80+ years in business"

,

"address"

:

"Houston, TX"

,

"phone"

:

"(281) 344-2270"

,

"hours"

:

"Open · Closes 8 PM"

,

"description"

:

"Online estimates · Onsite services not available"

,

"links"

: {

"website"

:

"https://villageplumbing.com/"

,

"directions"

:

"https://www.google.com/maps/dir//Village\+Plumbing,\+Air\+%26\+Electric"

}

},

{

"position"

:

2

,

"title"

:

"Cooper Plumbing | Houston Plumber"

,

"placeId"

:

"/g/11h511y417"

,

"cid"

:

"9006747343253938931"

,

"link"

:

"https://www.google.com/searchviewer/10?svid=CAwSHRIbCgNwdnESFENnMHZaeTh4TVdnMU1URjVOREUzGAo"

,

"rating"

:

4.9

,

"reviews"

:

"550"

,

"type"

:

"Plumber"

,

"yearsInBusiness"

:

"10+ years in business"

,

"address"

:

"Houston, TX"

,

"phone"

:

"(832) 441-9683"

,

"hours"

:

"Open 24 hours"

,

"description"

:

"Onsite services not available"

,

"links"

: {

"website"

:

"https://www.cooperplumbinghouston.com/"

,

"directions"

:

"https://www.google.com/maps/dir//Cooper\+Plumbing"

}

}

],

"localResultsMoreLink"

:

"https://www.google.com/search?q=plumbers\+in\+houston&udm=1"

}

}

Navigate to header: EU pack EU pack

A response to

restaurante lisboa

(

country: "PT"

): six places, three from Google (open) then three from TheFork (collapsed). The first and the last are shown:

{

"success"

:

true

,

"result"

: {

"localResults"

: [

{

"position"

:

1

,

"title"

:

"A Nossa Casa"

,

"placeId"

:

"/g/11f9z8g95f"

,

"link"

:

"https://www.google.com/searchviewer/10?svid=CCYSESoPCg0vZy8xMWY5ejhnOTVmGAo"

,

"rating"

:

4.8

,

"ratingScale"

:

5

,

"reviews"

:

"2,6 mil"

,

"type"

:

"Restaurante"

,

"address"

:

"R. da Atalaia 31"

,

"hours"

:

"Fechado ⋅ Abre às 18:30"

,

"supplier"

: {

"name"

:

"Google"

,

"expanded"

:

true

,

"domain"

:

"www.google.com"

,

"link"

:

"https://www.google.com/search?q=restaurante\+lisboa&gl=pt&hl=pt-PT&udm=local"

}

},

// … places 2 to 5 …

{

"position"

:

6

,

"title"

:

"SUD Lisboa Terrazza"

,

"link"

:

"https://www.thefork.pt/restaurante/sud-lisboa-terrazza-r640703"

,

"redirectLink"

:

"https://www.google.com/goto?url=CAESiAEBxCJF11xWwrCCLPD7xjkKy6nZlk87\_W2u8idbAHAkMPmEMZ5sQmsshesG7G5RtvWna8OCFCu\_l70AcyV21Qmjwn6BOJm9OxkrrxLq6LXvlUiz9H6gkfzj3m5oaGF5g-Ie\_9nM1yCLEYJg-K8dv2EzTzwQF33i5XRXs6d7ZmNH3u0HiimlMtmy"

,

"rating"

:

9.3

,

"ratingScale"

:

10

,

"reviews"

:

"3,5 mil"

,

"type"

:

"Marisco"

,

"address"

:

"Avenida Brasília - Pavilhão Poente (ao lado do MAAT), 1300-598 Lisboa"

,

"hours"

:

"Fechado ⋅ Abre às 12:00"

,

"supplier"

: {

"name"

:

"TheFork"

,

"expanded"

:

false

,

"domain"

:

"www.thefork.pt"

,

"link"

:

"https://www.thefork.pt/restaurantes/lisboa-c665920"

,

"redirectLink"

:

"https://www.google.com/goto?url=CAESbwHEIkXXe34Rl\_ehhT28MOepQJZZR3cMWRERG-ovpi6QtDcdRbH7-8LNPWvx2HFOTdcsLbP6WgNdquprImUhfGl7mKFsYBNQ\_woBvbjUhZ5XHqlASBgaQD8gihn68CU4yZVXzXrXl-m5XDXLPO6\_RA"

}

}

],

"localResultsMoreLink"

:

"https://www.google.com/search?q=restaurante\+lisboa&gl=pt&hl=pt-PT&udm=local"

}

}

Was this page helpful?

Ask a question...

Google Search endpoint

Local Pack API

Local Finder

Navigate to header: EU places unit

redirect

Navigate to header: Links

Navigate to header: Place structure

Navigate to header: Response examples

Navigate to header: Restaurant pack

Navigate to header: Service pack

Navigate to header: EU pack