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

# search_google_images

> Google Images results for a keyword: image, source page, title and size. ₹0.29 per call; a result that finds nothing is ₹0.

## What it does

Google Images results for a query in a market: data with up to ten images, each with the image link, its size, a title and the page it comes from; gl and hl set the country and language, timeframe keeps to recent images.

Use it to see how a product or brand appears visually, find packaging and creative, or check where an image is used; for text results use [`search_web`](https://parel.si/docs/tools/search_web.md), for a page's screenshot [`screenshot_page`](https://parel.si/docs/tools/screenshot_page.md). Flat price per call for up to ten results. One to three seconds.

India: gl "in".

## Inputs

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

| Field | Type | Required | Description |
|---|---|---|---|
| `gl` | string | no | Two-letter country code ("in"). |
| `hl` | string | no | Two-letter language code ("en"). |
| `limit` | integer | no | How many images, up to 10. Default 10.; min 1, max 10 |
| `query` | string | yes | The image search ("mamaearth onion shampoo bottle"). |
| `location` | string | no | A place to localise results ("Mumbai, Maharashtra, India"). |
| `timeframe` | string | no | 1h, 1d, 7d, 1y or all. |
| `autocorrect` | boolean | no | Google's spelling correction, default true. |

## What drives the cost

Flat per call for up to ten images; limit above 10 is refused as invalid_input (free). A result that finds nothing is `class: "ok_free"`, ₹0. The timeout is 30 seconds.

## Price today

| | |
|---|---|
| Price today | **₹0.29** per call (`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 | 44 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "search_google_images"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "search_google_images"` |
| 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_images","input":{"gl":"in","limit":10,"query":"mamaearth onion shampoo"}}'
```

## What comes back

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

```json
{
  "items": [
    {
      "height": 1000,
      "position": 1,
      "source": "www.amazon.in",
      "sourceUrl": "https://www.amazon.in/Mamaearth-Shampoo-Control-Growth-Keratin/dp/B0CCL1QW5C",
      "thumbnailUrl": "(picture link removed)",
      "title": "Buy Mamaearth Onion Shampoo for Hair Growth and Hair Fall Control with Onion and Plant Keratin | Reduces Hair Fall | Strengthens & Smoothens Hair | ...",
      "url": "https://m.media-amazon.com/images/I/514OxZHyroL._AC_UF1000,1000_QL80_.jpg",
      "width": 853
    },
    {
      "height": 4206,
      "position": 2,
      "source": "mamaearth.in",
      "sourceUrl": "https://mamaearth.in/products/mamaearth-onion-shampoo-for-hair-growth-hair-fall-control-with-onion-plant-keratin-600-ml?srsltid=AYCX9vIV4OK0AJSA5FJpq2mvVtxSGQnTW4dJPdafyCox33KUdNUKMaPV",
      "thumbnailUrl": "(picture link removed)",
      "title": "Mamaearth Onion Shampoo for Hair Growth & Hair Fall Control with Onion & Plant Keratin - 600 ml",
      "url": "https://mamaearth.in/cdn/shop/files/A_-ROSEMARY_SHAMPOO_1000ml_1.jpg?v=1780644881",
      "width": 970
    },
    {
      "height": 1200,
      "position": 3,
      "source": "mamaearth.in",
      "sourceUrl": "https://mamaearth.in/products/mamaearth-onion-shampoo-for-hair-growth-hair-fall-control-with-onion-oil-plant-keratin-180-ml?srsltid=AYCX9vIn6qtAiqBGY8bu7I9wvKCldK2sRiwZ10amecc7Gg2wWRedsYW2",
      "thumbnailUrl": "(picture link removed)",
      "title": "Onion and Plant Keratin Shampoo for Hair Growth -180ml Pack",
      "url": "https://mamaearth.in/cdn/shop/files/1_48.jpg?v=1777974674",
      "width": 1200
    }
  ]
}
```

## Notes

- Flat per call for up to ten images; limit above 10 is refused as invalid_input (free).
- Image links point at the source sites, which can change; the page link is the stable one.
- gl in and hl en or hi for Indian results.

## Siblings

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