> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usegoro.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Shopping search

> Live Google Shopping listings for a query: product title, merchant, price, product id, image URL, the listing link and the position it held, localized by countr

Live Google Shopping listings for a query: product title, merchant, price, product id, image URL, the listing link and the position it held, localized by country and language, with pagination.

<Note>Use to compare prices for a product across merchants, to watch how a listing ranks on Google Shopping, or to snapshot what a category sells for in a given country. Use amazon.search when you only care about Amazon.</Note>

## Price

**\$0.0105 per result.** That is the rate you pay for each result the call returns, so the total depends on how many it produces.

Billing follows actual usage, so a call that returns fewer results costs less. `discover` and `inspect` also return a ceiling for your specific request, which is a maximum you will never be charged above.

## Input

| Field        | Type                                          | Required | Notes                                                                                                                                                    |
| ------------ | --------------------------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `num`        | `10`, `20`, `30`, `40`, `50`, `100`           |          | COSTS EXTRA. Results requested per page. Google returns roughly double this and stops near 40, and every returned listing is billed. Defaults to `"10"`. |
| `query`      | `string`                                      | yes      | The product or category to search for, for example "running shoes".                                                                                      |
| `country`    | `string`                                      |          | Two letter country code to search in, for example us, gb, de, fr, ro. Defaults to `"us"`.                                                                |
| `queries`    | `array`                                       |          | Overrides query when present. Limited to one entry: send one call per query so the price stays proportional to the request.                              |
| `language`   | `string`                                      |          | Two letter language code, for example en, de, fr, es, ro. Defaults to `"en"`.                                                                            |
| `max_pages`  | `integer`                                     |          | COSTS EXTRA, linearly. Pages to scrape. This is the field the price is sized on. Defaults to `1`.                                                        |
| `date_range` | `anytime`, `qdr:h`, `qdr:d`, `qdr:w`, `qdr:m` |          | Restrict to listings seen in the last hour, day, week or month. Defaults to `"anytime"`.                                                                 |

<Note>
  Goro forwards your input to the underlying tool unchanged, so any field the
  tool accepts works here even if it is not listed above.
</Note>

## Example

```bash theme={null}
curl -X POST https://api.usegoro.ai/v1/run \
  -H "Authorization: Bearer $GORO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"shopping.search","input":{"query":"example","max_pages":3}}'
```

## Response

One row of the response. Values are illustrative.

```json theme={null}
{
  "link": "https://www.google.com/search?ibp=oshop&q=running+shoes&prds=productid:16078491969622180360&gl=us&udm=28",
  "price": "$150.00",
  "query": "running shoes",
  "title": "Nike Air Max 270 Men's Shoes",
  "source": "Nike.com",
  "imageUrl": "https://example.com/media/sample.jpg",
  "position": 1,
  "productId": "16078491969622180360"
}
```