---
title: "Search Google Shopping"
method: GET
path: "/v1/google/shopping/search"
tags: ["Google Shopping"]
---

# Search Google Shopping

`GET /v1/google/shopping/search`

Search Google Shopping for products.

Requires browser rendering due to dynamic JS-loaded content.

## Query parameters

- `q` string, required — Product search query
- `gl` string — Country code
- `hl` string — Language code
- `min_price` integer, nullable — Minimum price
- `max_price` integer, nullable — Maximum price
- `sort_by` string, nullable — Sort: price_low, price_high, rating, reviews
- `free_shipping` boolean — Free shipping filter
- `on_sale` boolean — On sale filter
- `start` integer — Pagination offset

## Response `200`

Successful Response

- ShoppingSearchResponse — Response for GET /api/v1/shopping/search.
  - `results` ShoppingProductResult[]
    - `position` integer, nullable
    - `product_id` string, nullable
    - `title` string, required
    - `price` ShoppingPrice — Product price.
      - `value` number, nullable
      - `currency` string, nullable
      - `extracted` string, nullable
    - `old_price` string, nullable
    - `old_price_extracted` number, nullable
    - `on_sale` boolean
    - `tag` string, nullable
    - `rating` number, nullable
    - `reviews` string, nullable
    - `reviews_count` integer, nullable
    - `source` string, nullable
    - `source_icon` string, nullable
    - `thumbnail` string, nullable
    - `link` string, nullable
    - `click_link` string, nullable
    - `page_token` string, nullable
    - `delivery` string, nullable
    - `return_policy` string, nullable
    - `extensions` string[]
  - `filters` ShoppingFilter[]
    - `name` string, required
    - `options` ShoppingFilterOption[]
      - `label` string, required
      - `value` string, nullable
      - `type` string, nullable
      - `aria_label` string, nullable
  - `ads` ShoppingProductResult[]
    - `position` integer, nullable
    - `product_id` string, nullable
    - `title` string, required
    - `price` ShoppingPrice — Product price.
      - `value` number, nullable
      - `currency` string, nullable
      - `extracted` string, nullable
    - `old_price` string, nullable
    - `old_price_extracted` number, nullable
    - `on_sale` boolean
    - `tag` string, nullable
    - `rating` number, nullable
    - `reviews` string, nullable
    - `reviews_count` integer, nullable
    - `source` string, nullable
    - `source_icon` string, nullable
    - `thumbnail` string, nullable
    - `link` string, nullable
    - `click_link` string, nullable
    - `page_token` string, nullable
    - `delivery` string, nullable
    - `return_policy` string, nullable
    - `extensions` string[]
  - `pagination` Pagination, required — Pagination metadata.
    - `current` union
      - integer
      - string
    - `next` string, nullable
    - `total_results` integer, nullable
    - `total_pages` integer, nullable
    - `page_no` object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/scrapebadger/apis/scrapebadger-account-api.md) · [All operations](https://skmtc.net/scrapebadger/apis/scrapebadger-account-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scrapebadger/scrapebadger-account-api/revisions/4a1ef8777baf/schema)