# Google Shopping API guide



## Choose a Google Shopping operation



Start with the object your task needs. The groups below use the current catalogue; open an endpoint to check accepted identifiers, filters, price and availability before retrieving.



### Reviews and offers



- [Google Shopping deals](https://www.monocrawl.com/docs/endpoints/google_shopping/deals) — Discounted products for a query on Google Shopping with sale and original price, discount and store.

- [Google Shopping reviews](https://www.monocrawl.com/docs/endpoints/google_shopping/reviews) — Retrieve product reviews from Google Shopping. Reviewer details and source review IDs can be absent. Slow results return HTTP 202 with task_id and status_url; poll that URL at zero retrieval credits. The original task is charged once and terminal failures are refunded. Requested depth remains subject to available source capacity.

- [Google Shopping sellers](https://www.monocrawl.com/docs/endpoints/google_shopping/sellers) — Retrieve Google Shopping merchant offers with source-reported prices and currency. Base price and total price are separate; missing amounts remain unknown. Slow results return HTTP 202 with task_id and status_url; poll that URL at zero retrieval credits. The original task is charged once and terminal failures are refunded.

- [Google Shopping store reviews](https://www.monocrawl.com/docs/endpoints/google_shopping/store-reviews) — Shopper reviews of an online store as shown on Google Shopping, with rating, text, author and date.



### Posts and media



- [Google Shopping price history](https://www.monocrawl.com/docs/endpoints/google_shopping/price-history) — Available historical prices by store for a Google Shopping product in the requested country. Current offer prices and store URLs may be absent; use google_shopping/sellers for current offers. Returns available histories in one response; coverage varies by product and country.



### Products and categories



- [Google Shopping product](https://www.monocrawl.com/docs/endpoints/google_shopping/product) — One Google Shopping product with its description, images, specification and rating. Queued task.



### Search and discovery



- [Google Shopping search](https://www.monocrawl.com/docs/endpoints/google_shopping/search) — Products for a query on Google Shopping with seller, price, currency and rating. Prepared as a queued task; a retry within fifteen minutes picks up the same result.



## Check fields and collection limits



Use the endpoint’s declared parameters and returned continuation. Filters from another platform do not automatically apply here. Preserve source identifiers, URLs and warnings; a successful page does not establish complete history. Published response schemas identify whether they come from a reviewed shaper or observed response shapes.



Agents can use `get_endpoint` for the current contract and `get_docs` with topic `platforms/google_shopping` to read this page. The [coverage guide](https://www.monocrawl.com/docs/data-availability) explains nulls and partial results, and the [production guide](https://www.monocrawl.com/docs/production-checklist) covers budgets and recovery.



## Endpoint reference

## google_shopping/deals

`GET /v1/google_shopping/deals`

Discounted products for a query on Google Shopping with sale and original price, discount and store.

*Google Shopping deals*

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Search terms — e.g. `laptop` |
| `location` | no | Country name (default United Kingdom) — e.g. `United Kingdom` |
| `language` | no | Language code — e.g. `en` |
| `min_price` | no | Lowest price — e.g. `100` |
| `max_price` | no | Highest price — e.g. `900` |
| `stores` | no | Store names, comma-separated — e.g. `argos,currys` |
| `limit` | no | Results, up to 120 — e.g. `40` |
| `page` | no | Page — e.g. `1` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `limit`: Bound the returned rows to what your task needs. A smaller limit does not necessarily reduce source calls or price; inspect the quote.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/google_shopping/deals?query=laptop" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "checked_at": "2026-09-01T12:00:00Z",
  "count": 0,
  "cursor": null,
  "has_more": false,
  "items": [
    {
      "currency": "example",
      "delivery": "example",
      "has_multiple_offers": false,
      "id": "example",
      "images": [],
      "on_sale": false,
      "original_price": 0,
      "platform": "example",
      "price": 0,
      "rank": 0,
      "rating": {
        "max": 0,
        "value": 0,
        "votes": 0
      },
      "return_policy": "example",
      "seller": "example",
      "title": "example",
      "type": "example",
      "url": "https://example.com/example"
    }
  ],
  "page": 0,
  "query": "example",
  "sponsored": []
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/google_shopping/deals#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/google_shopping/deals.json)


## google_shopping/price-history

`GET /v1/google_shopping/price-history`

Available historical prices by store for a Google Shopping product in the requested country. Current offer prices and store URLs may be absent; use google_shopping/sellers for current offers. Returns available histories in one response; coverage varies by product and country.

*Google Shopping price history*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | yes | Product id from google_shopping/search. Preserve its search country in location. — e.g. `catalogid:7310953537322941042,productid:2695666608789071335` |
| `location` | no | Country name (default United Kingdom). Use the same country as the product search. The documented product example uses United States. — e.g. `United States` |
| `language` | no | Language code — e.g. `en` |
| `page` | no | Omit or use 1. The current source returns available store histories in one response; continuation is not supported. — e.g. `1` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/google_shopping/price-history?id=catalogid%3A7310953537322941042%2Cproductid%3A2695666608789071335&location=United%20States" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "_meta": {
    "billing": {
      "charged": 0,
      "list_price": 0,
      "reason": "example"
    }
  },
  "_warnings": [
    "example"
  ],
  "count": 0,
  "has_more": false,
  "items": [],
  "page": 0,
  "product_id": "example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/google_shopping/price-history#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/google_shopping/price-history.json)


## google_shopping/product

`GET /v1/google_shopping/product`

One Google Shopping product with its description, images, specification and rating. Queued task.

*Google Shopping product*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | yes | Google Shopping product id from a search result — e.g. `1749519698216963169` |
| `location` | no | Location name — e.g. `United Kingdom` |
| `language` | no | Language code — e.g. `en` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 5 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/google_shopping/product?id=1749519698216963169" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "description": "example",
  "id": "example",
  "images": [],
  "platform": "example",
  "rating": {
    "value": 0
  },
  "title": "example",
  "url": "https://example.com/example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/google_shopping/product#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/google_shopping/product.json)


## google_shopping/reviews

`GET /v1/google_shopping/reviews`

Retrieve product reviews from Google Shopping. Reviewer details and source review IDs can be absent. Slow results return HTTP 202 with task_id and status_url; poll that URL at zero retrieval credits. The original task is charged once and terminal failures are refunded. Requested depth remains subject to available source capacity.

*Google Shopping reviews*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | yes | Google Shopping product gid (the gid on a google_shopping/search card) — e.g. `3896066944466806859` |
| `docid` | no | The card's docid, sent alongside for a precise match — e.g. `11901315168138976013` |
| `product_id` | no | The card's product id, sent alongside for a precise match — e.g. `4891805616949897996` |
| `location` | no | Location name — e.g. `United Kingdom` |
| `language` | no | Language code — e.g. `en` |
| `limit` | no | Requested reviews, 1–100 (default 20). Available source capacity can limit the maximum request. If no funded source can serve the requested depth, the API refuses it without a charge and reports the available limit; it does not silently reduce your request. — e.g. `20` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `limit`: Bound the returned rows to what your task needs. A smaller limit does not necessarily reduce source calls or price; inspect the quote.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 5 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/google_shopping/reviews?id=3896066944466806859" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "has_more": false,
  "items": [
    {
      "images": [],
      "platform": "example",
      "posted_at": "2026-09-01T12:00:00Z",
      "rating": {
        "max": 0,
        "value": 0,
        "votes": 0
      },
      "reviewer": {},
      "text": "example",
      "title": "example"
    }
  ],
  "product_id": "example",
  "rating": {
    "max": 0,
    "value": 0,
    "votes": 0
  },
  "reviews_count": 0
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/google_shopping/reviews#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/google_shopping/reviews.json)


## google_shopping/search

`GET /v1/google_shopping/search`

Products for a query on Google Shopping with seller, price, currency and rating. Prepared as a queued task; a retry within fifteen minutes picks up the same result.

*Google Shopping search*

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Search terms — e.g. `noise cancelling headphones` |
| `location` | no | Location name — e.g. `United Kingdom` |
| `language` | no | Language code — e.g. `en` |
| `limit` | no | Results, up to 100 — e.g. `20` |
| `cursor` | no | Return the previous response cursor unchanged, keeping query, location, language and limit unchanged. Continuation is source-specific and available only when a cursor is returned. Each request retains the normal price. |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `limit`: Bound the returned rows to what your task needs. A smaller limit does not necessarily reduce source calls or price; inspect the quote.
- `cursor`: Continue the same source traversal with the complete returned cursor. Saved-result retrieval and a new source page can have different prices; quote the next call.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 5 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/google_shopping/search?query=noise%20cancelling%20headphones" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "checked_at": "2026-09-01T12:00:00Z",
  "count": 0,
  "cursor": null,
  "has_more": false,
  "items": [
    {
      "currency": "example",
      "delivery": "example",
      "has_multiple_offers": false,
      "id": "example",
      "images": [],
      "on_sale": false,
      "original_price": 0,
      "platform": "example",
      "price": 0,
      "rank": 0,
      "rating": {
        "max": 0,
        "value": 0,
        "votes": 0
      },
      "return_policy": "example",
      "seller": "example",
      "title": "example",
      "type": "example",
      "url": "https://example.com/example"
    }
  ],
  "page": 0,
  "query": "example",
  "sponsored": []
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/google_shopping/search#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/google_shopping/search.json)


## google_shopping/sellers

`GET /v1/google_shopping/sellers`

Retrieve Google Shopping merchant offers with source-reported prices and currency. Base price and total price are separate; missing amounts remain unknown. Slow results return HTTP 202 with task_id and status_url; poll that URL at zero retrieval credits. The original task is charged once and terminal failures are refunded.

*Google Shopping sellers*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | yes | Google Shopping product id — e.g. `1234567890123456789` |
| `location` | no | Location name — e.g. `United Kingdom` |
| `language` | no | Language code — e.g. `en` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 5 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/google_shopping/sellers?id=1234567890123456789" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "has_more": false,
  "items": [
    {
      "condition": "example",
      "currency": "example",
      "id": "example",
      "merchant_id": "example",
      "on_sale": false,
      "payment_methods": [],
      "price": 0,
      "rating": {
        "max": 0,
        "value": 0,
        "votes": 0
      },
      "seller": "example",
      "shipping": "example",
      "title": "example",
      "url": "https://example.com/example"
    }
  ],
  "offers_count": 0,
  "page": 0,
  "product_id": "example",
  "title": "example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/google_shopping/sellers#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/google_shopping/sellers.json)


## google_shopping/store-reviews

`GET /v1/google_shopping/store-reviews`

Shopper reviews of an online store as shown on Google Shopping, with rating, text, author and date.

*Google Shopping store reviews*

| Parameter | Required | Description |
| --- | --- | --- |
| `domain` | yes | Store domain — e.g. `amazon.co.uk` |
| `location` | no | Country name (default United Kingdom) — e.g. `United Kingdom` |
| `language` | no | Language code — e.g. `en` |
| `limit` | no | Reviews, up to 100 — e.g. `20` |
| `cursor` | no | Cursor from the previous page |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `limit`: Bound the returned rows to what your task needs. A smaller limit does not necessarily reduce source calls or price; inspect the quote.
- `cursor`: Continue the same source traversal with the complete returned cursor. Saved-result retrieval and a new source page can have different prices; quote the next call.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/google_shopping/store-reviews?domain=amazon.co.uk" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "cursor": null,
  "dropped": 0,
  "has_more": false,
  "items": [
    {
      "images": [],
      "platform": "example",
      "posted_at": "2026-09-01T12:00:00Z",
      "rating": {
        "max": 0,
        "value": 0
      },
      "reviewer": {
        "avatar": "https://example.com/example",
        "name": "example"
      },
      "text": "example"
    }
  ],
  "store": "example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/google_shopping/store-reviews#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/google_shopping/store-reviews.json)