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

# Search Google Shopping

`GET /google/shopping`

## Request

- Base URL: `https://scrappa.co/api`
- URL: `https://scrappa.co/api/google/shopping`
- Auth: API key in header `X-API-KEY`

Returns normalized product cards from Google Shopping.

`next_start` is the next offset to try and does not guarantee that another page has results.

## Query parameters

- `q` string, required
- `gl` string, nullable
- `hl` string, nullable
- `location` string, nullable
- `uule` string, nullable
- `start` integer, nullable
- `device` 'desktop' | 'mobile' | 'tablet' | 'null', nullable
- `small_business` boolean, nullable
- `shoprs` string, nullable

## Response `200`

- object
  - `search_parameters` object, required
    - `q` string, required
    - `gl` string, required
    - `hl` string, required
    - `start` integer, required
    - `device` string, required
    - `small_business` boolean
    - `location` string
    - `uule` string
    - `shoprs` string
  - `shopping_results` object[], required
    - `position` integer, required
    - `title` string, required
    - `product_id` string
    - `link` string
    - `price` string
    - `extracted_price` number
    - `source` string
    - `delivery` string
    - `thumbnail` string
    - `badges` string[]
    - `rating` number
    - `reviews` integer
  - `pagination` object, required
    - `current_page` integer, required
    - `start` integer, required
    - `previous_start` integer
    - `next_start` integer

## Other responses

- `401`: Unauthorized - API key is missing or invalid
- `422`: The query, locale, location, device, pagination, or Shopping filters are invalid.
- `503`: The upstream service is temporarily unavailable. Please retry shortly.

---

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