---
title: "Scrape Google Shopping product listings"
method: POST
path: "/goods/google-shopping"
tags: ["Plugins"]
---

# Scrape Google Shopping product listings

`POST /goods/google-shopping`

## Request

- Base URL: `https://api.scrapeunblocker.com`
- URL: `https://api.scrapeunblocker.com/goods/google-shopping`
- Auth: API key in header `x-scrapeunblocker-key`

Runs the Google Shopping vertical (`udm=28`) for `q` and returns the product cards as JSON: `title`, `price`, `currency`, `originalPrice`, `discount`, `merchant`, `rating` and `reviewCount`. Set `proxy_country`/`gl` to target a market (prices/merchants are region-specific) and `min_price`/`max_price` to filter. One render returns the first page of products (v1). Note: Google Shopping exposes no per-product URL, so `url` is omitted and `image` is best-effort.

## Query parameters

- `q` string, required: Product search term, e.g. 'wireless headphones'.
- `gl` string: Market of search, ISO-2, e.g. 'us', 'de'. Sets prices/merchants.
- `min_price` integer, nullable: Minimum price filter (whole units, gl currency).
- `max_price` integer, nullable: Maximum price filter (whole units, gl currency).
- `max_results` integer: How many products to return (v1: first page).
- `proxy_country` string, nullable: Proxy country the request is sent from (ISO-2, e.g. 'US', 'DE'). Prices/merchants are market-specific.

## Response `200`

JSON with a `products` array plus the query and count.

- unknown

## Other responses

- `403`: Blocked by Google CAPTCHA after retries - try another proxy_country.
- `422`: Validation Error
- `502`: No products collected (upstream block or no matches), or the call did not finish in time.

---

[API](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api.md) · [All operations](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/revisions/c02f1254cc47?raw)