> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/search_google_shopping

# search_google_shopping

> Google Shopping results for a product in a country: title, price, seller, rating, reviews and link. ₹0.29 per page; a result that finds nothing is ₹0.

## What it does

What Google Shopping shows for a product keyword in a country: data.shopping[] with about forty offers, each with title, source (the seller), price as shown, rating and ratingCount, imageUrl, productId, position and the Google link. gl picks the country and hl the language; page asks for the next forty.

Use it to see the price range and the sellers for a product, or where a brand's product sits against others on Google; for Amazon use [`search_amazon`](https://parel.si/docs/tools/search_amazon.md), for one store's catalogue [`get_shopify_products`](https://parel.si/docs/tools/get_shopify_products.md), for organic search results [`search_web`](https://parel.si/docs/tools/search_web.md). Prices are as Google shows them, with the currency symbol, and some offers repeat across sellers. Flat price per page. One to three seconds.

India: gl "in" for prices in rupees from Indian sellers.

## Inputs

Generated from the contract captured from staging on 2026-11-17.

| Field | Type | Required | Description |
|---|---|---|---|
| `q` | string | yes | The product search, as you would type it into Google Shopping. |
| `gl` | string | no | Two-letter country code ("in"). Default us. |
| `hl` | string | no | Language code ("en", "hi"). Default en. |
| `page` | integer | no | Which page of forty. Default 1.; min 1 |
| `location` | string | no | A city or region to search from, as Google names it ("Mumbai, Maharashtra, India"). |

## What drives the cost

Flat per page of about forty offers; page 2, 3… for more. A result that finds nothing is `class: "ok_free"`, ₹0. The timeout is 30 seconds.

## Price today

| | |
|---|---|
| Price today | **₹0.29** per page (`cost_paise: 29`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.44 (`hold_paise: 44`); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): `class: "ok_free"`, ₹0 |
| Timeout | 30 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "search_google_shopping"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "search_google_shopping"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |

## Request

```bash
curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"search_google_shopping","input":{"q":"running shoes","gl":"in","hl":"en"}}'
```

## What comes back

`data`, as the live check of 2026-11-17 recorded it, trimmed:

```json
{
  "searchParameters": {
    "q": "running shoes",
    "gl": "in",
    "hl": "en",
    "type": "shopping",
    "num": 40,
    "autocorrect": true,
    "page": 1,
    "engine": "google"
  },
  "shopping": [
    {
      "title": "Men's Puma FAST-R Nitro Elite 3 Road Running Shoes",
      "source": "PUMA India",
      "link": "https://www.google.com/search?ibp=oshop&q=running+shoes&prds=localAnnotatedOfferId:1,catalogid:3405128590118135510,gpcid:13776812173249506617,pvo:2,pvt:hg&gl=in&udm=28&pvorigin=2",
      "price": "₹23,999",
      "imageUrl": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcRuG4A7xTOOBrI4V7QPARVfGWCDX7D0r-9bZKB71Zk9UePV2OnayNp8DrsDmEE8Ixq3VyjZv841oT0evx4uqU5i_SnHX4ObsOfYW3wLsnUD_FFWIFUBxXPzNw",
      "rating": 4.7,
      "ratingCount": 118,
      "productId": "3405128590118135510",
      "position": 1
    },
    {
      "title": "Decathlon Men Textile Running Shoes",
      "source": "Decathlon Sports India",
      "link": "https://www.google.com/search?ibp=oshop&q=running+shoes&prds=localAnnotatedOfferId:1,catalogid:2735469024478415725,gpcid:5029531690578339607,pvo:2,pvt:hg&gl=in&udm=28&pvorigin=2",
      "price": "₹999",
      "imageUrl": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcR0ai0HT2PSL-uJUhZYv4vU0-ECEaJYRLYBJrwrv_ucRW3UG-vLfD1NI2rzA1Jap0rfT5rItsgNQK3MrS9UZPkqA5XUG06rtB73-cEpZRLne9464bG9neyCHg",
      "productId": "2735469024478415725",
      "position": 2
    },
    {
      "title": "ASICS GEL-Nimbus 28 Men's Running Shoes",
      "source": "Amazon.in",
      "link": "https://www.google.com/search?ibp=oshop&q=running+shoes&prds=localAnnotatedOfferId:1,catalogid:17215548452315548487,gpcid:5310959131376330242,pvo:2,pvt:hg&gl=in&udm=28&pvorigin=2",
      "price": "₹13,589",
      "imageUrl": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcTNnV0b0RBgc8DQlerTLvm4ZrmbbgB-p4vKiEvHWTfuYVtNst30PWWTSO51H2DGh2c-nOBQS0sjQVfD6uzjKYekJrf89DxaC_a3kkTu9MqBWT2xhzi-eeKG",
      "rating": 4.6,
      "ratingCount": 3300,
      "productId": "17215548452315548487",
      "position": 3
    }
  ]
}
```

## Notes

- Flat per page of about forty offers; page 2, 3… for more.
- price is a display string ("₹1,299.00"), not a number; some offers have no rating.
- Results are a snapshot of today's listings, with no price history.

## Siblings

- [`search_amazon`](https://parel.si/docs/tools/search_amazon.md)
- [`get_shopify_products`](https://parel.si/docs/tools/get_shopify_products.md)
- [`search_web`](https://parel.si/docs/tools/search_web.md)
