> ## 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 stores schema

> Schema for Google's Stores block returned by the Google Search endpoint: the merchants listed on a shopping SERP, with each merchant's page, title, description, price range and rating.

The [Google Search endpoint](https://cloro.dev/docs/api-reference/endpoint/monitor-google.md) returns Google's Stores block, a list of merchants shown on shopping queries ("air fryer", "running shoes men"), as `result.stores`, on desktop and mobile, with no flag and at no extra cost. `stores` is omitted when the SERP has no Stores block. Google shows the block in EU countries.

`items` holds every merchant of the block, in page order: the 2 that Google shows, then the ones behind "Show more", with `expanded: false`.

Text fields are as Google shows them, in the language of the SERP. Some merchants show a price range, a rating or both in place of the description.

## Desktop

![Stores block in Google Search on desktop](https://mintcdn.com/cloro/1vkTBOm_Y2kj_6LI/images/google/search-stores-desktop.webp?fit=max\&auto=format\&n=1vkTBOm_Y2kj_6LI\&q=85\&s=e4939a76c0965b3b857cfb88ad6a9e76)

Stores block in Google Search on desktop

A response to `air fryer` in Ireland, on desktop, shortened with `// …`:

```json theme={null}
{
  "success": true,
  "result": {
    "stores": {
      "items": [
        {
          "position": 1,
          "merchant": "Ninja Ireland",
          "link": "https://www.ninjakitchen.ie/collections/air-fryers",
          "expanded": true,
          "title": "Air Fryers",
          "description": "Ninja Air Fryers help you cook using little to no oil. Enjoy healthier meals in a flash, with extra-crispy results – from chunky chips and roasted ...",
          "redirectLink": "https://www.google.com/goto?url=CAESbwHEIkXXZOfflesd-UKC5jQ883mP…"
        },
        {
          "position": 2,
          "merchant": "Currys",
          "link": "https://www.currys.ie/appliances/small-kitchen-appliances/health-fryers/air-fryers",
          "expanded": true,
          "title": "Great Air Fryer Offers & Deals",
          "description": "Find the perfect Air Fryer including Ninja models in our Health Fryers range here at Currys. Shop online for delivery or order & collect.",
          "redirectLink": "https://www.google.com/goto?url=CAESjwEBxCJF11sJ8J53qYCjpg3CKPFZ…"
        },
        {
          "position": 3,
          "merchant": "Anthony Ryans Galway",
          "link": "https://www.anthonyryans.com/collections/air-fryers-fryers",
          "expanded": false,
          "title": "Air Fryers & Fryers",
          "description": "Kitchen Appliances that Make Life Simpler - Air Fryers, Grills, Sandwich Makers & Slow Cookers Discover a world of culinary ...",
          "redirectLink": "https://www.google.com/goto?url=CAESdwHEIkXX_BnXne9qqS4kJPrKzeGy…"
        },
        // …
        {
          "position": 5,
          "merchant": "Amazon.ie",
          "link": "https://www.amazon.ie/b?ie=UTF8&node=94817505031",
          "expanded": false,
          "title": "Air Fryers: Home & Kitchen",
          "description": "Ninja MAX Dual Zone Digital Air Fryer, 9.5L, Stone Gold DZ400UKSTGD | 6 functions: Air Fry, Max Crisp, Roast, Bake, Reheat & Dehydrate. Non-Stick, Dishwasher ...",
          "redirectLink": "https://www.google.com/goto?url=CAESbQHEIkXXIP_f6Il0WPduoy_pn7AE…"
        }
      ]
    }
  }
}
```

## Mobile

![Stores block in Google Search on mobile](https://mintcdn.com/cloro/1vkTBOm_Y2kj_6LI/images/google/search-stores-mobile.webp?fit=max\&auto=format\&n=1vkTBOm_Y2kj_6LI\&q=85\&s=abeeb7b8a9a996e3c5b064015a7925e2)

Stores block in Google Search on mobile

A response to `air fryer` in Ireland, on mobile, shortened with `// …`:

```json theme={null}
{
  "success": true,
  "result": {
    "stores": {
      "items": [
        {
          "position": 1,
          "merchant": "Ninja Ireland",
          "link": "https://www.ninjakitchen.ie/collections/air-fryers",
          "expanded": true,
          "title": "Air Fryers",
          "description": "Ninja Air Fryers help you cook using little to no oil. Enjoy healthier meals in a flash, with extra-crispy results – from chunky chips and roasted ...",
          "redirectLink": "https://www.google.com/goto?url=CAESbwHEIkXXQs8q1ycdB72Xbn_P_Kr1…"
        },
        // …
        {
          "position": 5,
          "merchant": "Very Ireland",
          "link": "https://www.very.ie/browse/appliances-cooking-appliances-air-fryers",
          "expanded": false,
          "title": "Air Fryers | Dual Basket & Large Air Fryers | Ninja & Tower",
          "description": "Shop air fryers at Very Ireland from Ninja, Tower, Philips and Salter. Choose single, dual basket and large air fryers for quick, ...",
          "redirectLink": "https://www.google.com/goto?url=CAESgAEBxCJF1zfwOwQPtbR4s7D3pce6…"
        }
      ]
    }
  }
}
```

## Stores structure

| Field | Type | Description |
| - | - | - |
| `items` | array | The merchants, in page order. See below |

### Store

`position`, `merchant`, `link` and `expanded` are always present. Every other field is included only when Google shows it.

| Field | Type | Description |
| - | - | - |
| `position` | number | Position in page order (1-indexed) |
| `merchant` | string | Merchant name as shown ("Currys", "Amazon.ie") |
| `link` | string | URL of the merchant's page |
| `expanded` | boolean | `true` if the page shows the merchant without a click |
| `redirectLink` | string | Google's `/goto` redirect for `link`. See [Redirect links](https://cloro.dev/docs/api-reference/endpoint/google/resolve-goto.md). |
| `title` | string | Title of the merchant's page |
| `description` | string | Text under the title |
| `priceRange` | string | Price range as shown, in the language of the SERP |
| `rating` | number | Rating (`4.5`) |
| `reviews` | string | Number of reviews as shown |


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