Google Local Pack schema - cloro
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"
:
,
"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"
:
,
"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"
:
,
"link"
:
"https://www.thefork.pt/restaurantes/lisboa-c665920"
,
"redirectLink"
:
}
}
],
"localResultsMoreLink"
:
"https://www.google.com/search?q=restaurante\+lisboa&gl=pt&hl=pt-PT&udm=local"
}
}
Was this page helpful?
Ask a question...
Navigate to header: EU places unit
Navigate to header: Place structure
Navigate to header: Response examples
Navigate to header: Restaurant pack