> ## 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 top sights schema

> Schema for Google's top sights block returned by the Google Search endpoint: the sights of a city or a place, with rating, reviews, price, category, opening state, website and thumbnail.

The [Google Search endpoint](https://cloro.dev/docs/api-reference/endpoint/monitor-google.md) returns Google's "Top sights" block as `result.topSights`, on desktop and mobile, with no flag and at no extra cost. Google shows it on travel queries about a city or a place (`things to do in rome`, `cliffs of moher`): the sights to visit, each with a photo, its rating, category and ticket price, and a "More things to do" link. `topSights` is omitted when the SERP has no such block.

![Top sights in Google Search](https://mintcdn.com/cloro/Hi0cOfjdopAn9XhZ/images/google/search-top-sights.webp?fit=max\&auto=format\&n=Hi0cOfjdopAn9XhZ\&q=85\&s=2a6ae8194bba41209eaa06880a26f218)

Top sights in Google Search

Every sight of the block is returned in page order, including the ones behind the carousel's arrow. A sight has the fields of a [local pack place](https://cloro.dev/docs/api-reference/endpoint/google/local-pack.md#place-structure) that its card shows, and its `thumbnail`. Values are text as Google shows them, in the language of the SERP.

The sights are not in `localResults`. Other sections of the same result are not part of `topSights`: the events ("Events this weekend") are in [`events`](https://cloro.dev/docs/api-reference/endpoint/google/events), and the category sections ("Historical places", "Museums") and "Top experiences" tours are not returned.

## Layouts

### Top sights

A city query shows "Top sights in Rome" in the main column: a carousel of up to 20 sights, or a grid of four. Each tile shows the opening state (`hours`) and has a `cid` and a `link`. Mobile shows the same block, often with a map above it.

![Top sights on mobile in Google Search](https://mintcdn.com/cloro/Hi0cOfjdopAn9XhZ/images/google/search-top-sights-mobile.webp?fit=max\&auto=format\&n=Hi0cOfjdopAn9XhZ\&q=85\&s=667d561942f48c102d23371bee2b11e6)

Top sights on mobile

The block above, from `things to do in rome` in the United States, on mobile:

```json theme={null}
{
  "title": "Top sights in Rome",
  "items": [
    {
      "position": 1,
      "title": "Colosseum",
      "placeId": "/m/0d5qx",
      "cid": "2950359333223072708",
      "link": "https://www.google.com/searchviewer/10?svid=CCYSDCoKCggvbS8wZDVxeBgK",
      "rating": 4.8,
      "reviews": "512K",
      "price": "$19.89",
      "type": "Historical landmark",
      "hours": "Open",
      "thumbnail": "https://lh3.googleusercontent.com/grass-cs/…"
    },
    {
      "position": 2,
      "title": "Trevi Fountain",
      "placeId": "/m/01xgt5",
      "cid": "17759648132674796470",
      "link": "https://www.google.com/searchviewer/10?svid=CCYSDSoLCgkvbS8wMXhndDUYCg",
      "rating": 4.7,
      "reviews": "531K",
      "price": "$2.21",
      "type": "Fountain",
      "hours": "Open",
      "thumbnail": "https://lh3.googleusercontent.com/grass-cs/…"
    }
    // …
  ],
  "moreLink": "https://www.google.com/search?q=things+to+do+in+rome&…"
}
```

### Things to do

A query about a place (a landmark, an island, a region) shows "Things to do" in the main column: cards (four on most desktop pages, up to 20 on mobile), some with a "Website" link (`links`). Cards show no opening state and have no `cid` or `link`. On mobile, some city queries show their top sights as these cards.

![Things to do in Google Search](https://mintcdn.com/cloro/Hi0cOfjdopAn9XhZ/images/google/search-top-sights-things-to-do.webp?fit=max\&auto=format\&n=Hi0cOfjdopAn9XhZ\&q=85\&s=8310935eaa2a51ed793d7bdd94de29d7)

Things to do in Google Search

The block above, from `cliffs of moher` in Ireland:

```json theme={null}
{
  "title": "Things to do",
  "items": [
    {
      "position": 1,
      "title": "Lahinch Golf Club",
      "placeId": "/m/04vwskc",
      "rating": 4.7,
      "reviews": "1.3K",
      "type": "Golf club",
      "links": {
        "website": "http://www.lahinchgolf.com/",
        "redirectLink": "https://www.google.com/goto?url=…"
      },
      "thumbnail": "https://lh3.googleusercontent.com/grass-cs/…"
    },
    {
      "position": 2,
      "title": "Inisheer",
      "placeId": "/m/0694nv",
      "rating": 4.8,
      "reviews": "166",
      "type": "Island",
      "thumbnail": "https://lh3.googleusercontent.com/grass-cs/…"
    },
    {
      "position": 3,
      "title": "Doolin Cave",
      "placeId": "/m/0dn5s6",
      "rating": 4.7,
      "reviews": "2.7K",
      "price": "From €19.50",
      "type": "Tourist attraction",
      "links": {
        "website": "https://doolincave.ie/",
        "redirectLink": "https://www.google.com/goto?url=…"
      },
      "thumbnail": "https://lh3.googleusercontent.com/grass-cs/…"
    },
    {
      "position": 4,
      "title": "O'Brien's Tower",
      "placeId": "/m/0411dr1",
      "rating": 4.5,
      "reviews": "2.6K",
      "price": "From €9.00",
      "type": "Historical landmark",
      "thumbnail": "https://lh3.googleusercontent.com/grass-cs/…"
    }
  ],
  "moreLink": "https://www.google.com/search?q=Things+to+do+in+Cliffs+of+Moher&…"
}
```

### Side panel

On desktop, a place's panel on the right can show "Things to do" or "Things to do nearby". `topSights` returns it when the main column has no block. Its cards have the fields of the cards above. Some side panels show small cards whose photo Google embeds in the page; those sights have no `thumbnail`.

![Things to do nearby in the side panel of Google Search](https://mintcdn.com/cloro/Hi0cOfjdopAn9XhZ/images/google/search-top-sights-side-panel.webp?fit=max\&auto=format\&n=Hi0cOfjdopAn9XhZ\&q=85\&s=3270bde1ab847371378a5c8491db599e)

Things to do nearby in the side panel

The block above, from `table mountain` in South Africa:

```json theme={null}
{
  "title": "Things to do nearby",
  "items": [
    {
      "position": 1,
      "title": "Kirstenbosch National Botanical Garden",
      "placeId": "/m/03vv4w",
      "rating": 4.8,
      "reviews": "35K",
      "price": "R 270,00",
      "type": "Botanical garden",
      "thumbnail": "https://lh3.googleusercontent.com/grass-cs/…"
    },
    {
      "position": 2,
      "title": "V&A Waterfront",
      "placeId": "/m/02dl7n",
      "rating": 4.6,
      "reviews": "111K",
      "price": "Free",
      "type": "Shopping Centre",
      "thumbnail": "https://lh3.googleusercontent.com/grass-cs/…"
    }
    // …
  ],
  "moreLink": "https://www.google.com/search?q=Maclear%27s+Beacon&…"
}
```

## Top sights structure

| Field | Type | Description |
| - | - | - |
| `title` | string | Heading of the block as shown ("Top sights in Rome", "Things to do nearby") |
| `items` | array | The sights, in page order. See below |
| `moreLink` | string | The "More things to do" link: Google's search for more things to do (absolute URL) |

### Sight

`position` and `title` are always present. Every other field is included only when the sight's card shows it.

| Field | Type | Description |
| - | - | - |
| `position` | number | Position in the block (1-indexed) |
| `title` | string | Name of the sight as shown |
| `placeId` | string | Google entity id of the sight (`"/m/0d5qx"`), as on a local pack place |
| `cid` | string | Google's numeric place id (CID) as a decimal string. `https://maps.google.com/?cid=<cid>` opens the place. Tiles only |
| `link` | string | The sight's page in Google's viewer: the page that opens when you click the sight on the SERP. On tiles |
| `rating` | number | Rating as shown, out of 5 |
| `reviews` | string | Review count as shown (`"509K"`). Free-form string, not normalized to a number |
| `price` | string | Ticket price as shown (`"$20.16"`, `"Free"`, `"From €19.50"`), or the price range of a place to eat (`"$1–10"`) |
| `type` | string | Category as shown (`"Historical landmark"`) |
| `hours` | string | Opening state as shown (`"Open"`, `"Closed"`). Tiles only |
| `links` | object | `website`: the sight's website, from the card's "Website" link, and `redirectLink`: the Google redirect it was resolved from |
| `thumbnail` | string | URL of the sight's photo on Google's image server. Omitted when the page embeds the photo instead |

## Response example

A response to `things to do in rome` in the United States, on desktop: 20 sights.

```json theme={null}
{
  "success": true,
  "result": {
    "topSights": {
      "title": "Top sights in Rome",
      "items": [
        {
          "position": 1,
          "title": "Colosseum",
          "placeId": "/m/0d5qx",
          "cid": "2950359333223072708",
          "link": "https://www.google.com/searchviewer/10?svid=CCYSDCoKCggvbS8wZDVxeBgK",
          "rating": 4.8,
          "reviews": "509K",
          "price": "$20.16",
          "type": "Historical landmark",
          "hours": "Closed",
          "thumbnail": "https://lh3.googleusercontent.com/grass-cs/…"
        },
        {
          "position": 2,
          "title": "Trevi Fountain",
          "placeId": "/m/01xgt5",
          "cid": "17759648132674796470",
          "link": "https://www.google.com/searchviewer/10?svid=CCYSDSoLCgkvbS8wMXhndDUYCg",
          "rating": 4.7,
          "reviews": "528K",
          "price": "$2.24",
          "type": "Fountain",
          "hours": "Closed",
          "thumbnail": "https://lh3.googleusercontent.com/grass-cs/…"
        },
        // …
        {
          "position": 20,
          "title": "Piazza del Popolo",
          "placeId": "/m/09xnwr",
          "cid": "4895025766821938000",
          "link": "https://www.google.com/searchviewer/10?svid=CCYSDSoLCgkvbS8wOXhud3IYCg",
          "rating": 4.7,
          "reviews": "126K",
          "price": "Free",
          "type": "Plaza",
          "thumbnail": "https://lh3.googleusercontent.com/grass-cs/…"
        }
      ],
      "moreLink": "https://www.google.com/search?q=things+to+do+in+rome&…"
    }
  }
}
```


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