# FlashData Google Shopping API

Search Google Shopping for products and retrieve prices, merchants, ratings and product links in structured JSON.

Canonical reference: https://flashdata.dev/docs/sources/google_shopping
Reviewed: 2026-10-23

Endpoint: POST https://data.flashdata.dev/v1/queries/realtime
Authentication: X-API-Key: YOUR_API_KEY
Modes: [Realtime](https://flashdata.dev/docs/reference/realtime-and-async/reference.md#realtime) · [Async](https://flashdata.dev/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/docs/reference/batch-and-bulk/reference.md#batch)

Required source permission: google_shopping

Replace YOUR_API_KEY with an API key that has this source permission and available credits. Run requests on your server or agent host.

[Set up authentication](https://flashdata.dev/docs/guides/headers-and-authentication/reference.md)

[Choose and refine a Google search](https://flashdata.dev/docs/guides/google-search-guide/reference.md)

<a id="quickstart"></a>

## Send a request

### Python

```bash
python3 -m pip install requests
```

```python
import json

import requests

api_key = "YOUR_API_KEY"
payload = {
    "source": "google_shopping",
    "query": "mechanical keyboard",
    "params": {
        "gl": "us",
        "hl": "en",
        "num": 10,
        "page": 1,
    },
}

response = requests.post(
    "https://data.flashdata.dev/v1/queries/realtime",
    headers={"X-API-Key": api_key},
    json=payload,
    timeout=120,
)
response.raise_for_status()
print(json.dumps(response.json(), ensure_ascii=False, indent=2))
```

### Bash / cURL

```bash
api_key="YOUR_API_KEY"
curl --fail-with-body --max-time 120 --request POST "https://data.flashdata.dev/v1/queries/realtime" \
  --header "Content-Type: application/json" \
  --header "X-API-Key: $api_key" \
  --data-binary @- <<'FLASHDATA_JSON'
{
  "source": "google_shopping",
  "query": "mechanical keyboard",
  "params": {
    "gl": "us",
    "hl": "en",
    "num": 10,
    "page": 1
  }
}
FLASHDATA_JSON
```

<a id="parameters"></a>

## Parameters

<a id="parameters-group-0"></a>

### Request body

| Parameter | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | Yes | — | Set to google_shopping.  |
| <a id="parameter-query"></a> query | string | Yes | Not set | Search query. Supports Google search operators such as site: and intitle:. Min length: 1. Max length: 2000. |
| <a id="parameter-params"></a> params | object | No | {} | Settings for this request.  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | No | Not set | Async and batch only. Public HTTPS completion URL on port 443, up to 2,048 characters. No user credentials or URL fragment. Omit, use null or an empty string for no notification. In a batch, set this on each query, outside params.  |

<a id="parameters-group-1"></a>

### Country, language & location

| Parameter | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-gl"></a> params.gl | string | No | Not set | Two-letter country code, such as us, gb, de or sg. Set explicitly to select a country. Min length: 2. Max length: 2. Pattern: ^[A-Za-z]{2}$ |
| <a id="parameter-params-hl"></a> params.hl | string | No | Not set | Google interface language. Set explicitly to select a language. Min length: 1. Max length: 35. Pattern: ^[A-Za-z0-9-]+$ |
| <a id="parameter-params-location"></a> params.location | string | No | Not set | Requested search location, preferably a city, such as "London, England, United Kingdom". Availability depends on the search type. Min length: 1. Max length: 200. |

<a id="parameters-group-2"></a>

### Pagination

| Parameter | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-num"></a> params.num | integer | No | Not set | Requested result count. FlashData does not add a fixed default when omitted. The returned count can differ by query and search type. Minimum: 1. Maximum: 100. |
| <a id="parameter-params-page"></a> params.page | integer | No | Not set | Requested result page. Set explicitly. Each page is a separate API request. Minimum: 1. Maximum: 100. |

<a id="parameters-group-3"></a>

### Search filters

| Parameter | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-tbs"></a> params.tbs | string | No | Not set | Requested Google search filters, such as qdr:d for the past day or qdr:w for the past week. Availability depends on the search type. Min length: 1. Max length: 200. |
| <a id="parameter-params-autocorrect"></a> params.autocorrect | boolean | No | Not set | Request spelling correction with true or request it disabled with false. Applied behavior depends on the search type; omit to use Google's behavior.  |

<a id="response"></a>

## Read the result

Save the successful JSON response as response.json. Save this as read-response.py and run python read-response.py. It uses only Python's standard library and makes no new request.

### read-response.py

```python
import json
from pathlib import Path

response = json.loads(Path("response.json").read_text(encoding="utf-8-sig"))
if response.get("status") not in ("done", "completed") or not isinstance(response.get("results"), list):
    raise SystemExit("Expected completed result JSON; inspect the response or job status.")
if not response["results"]:
    print("[]")
    raise SystemExit(0)
result = response["results"][0]

output = [
    {"title": item.get("title"), "url": item.get("link"), "price": item.get("price"), "merchant": item.get("source")}
    for item in result.get("shopping", [])
]
print(json.dumps(output, ensure_ascii=False, indent=2))
```

## Sample response

Recorded example; fields and counts depend on the source and requested input.
```json
{
  "source": "google_shopping",
  "status": "done",
  "results": [
    {
      "searchParameters": {
        "q": "mechanical keyboard",
        "gl": "us",
        "hl": "en",
        "type": "shopping",
        "num": 40,
        "page": 1,
        "engine": "google"
      },
      "shopping": [
        {
          "title": "Keychron V1 Wired Custom Mechanical Keyboard barebone version 75% layout QMK/via programmable macro with Hot-swappable suppo",
          "source": "Keychron.com",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:4646494883927026855,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$69.99",
          "imageUrl": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcTmFH2V5iUcuY9yRuK1-vTVeyU3DJLVq_MomMlGTQnfiyxxBIB9ISDiXNuhtyWOBoDJNM1rCNvc07jUU4l1bilumAMkF8aHZ07__xTWQQw1dPRD8xAGCvk4",
          "rating": 4.8,
          "ratingCount": 336,
          "productId": "4646494883927026855",
          "position": 1
        },
        {
          "title": "Logitech POP Keys Wireless Mechanical Emoji Keyboard",
          "source": "Walmart - EXPO PLANET",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:1372105290382114078,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$73.00",
          "imageUrl": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcSyNZxBRz-l_Gn9tT9g-R0DuA_0FR4iJ2WoDCy73Y_i3aUpBIFM1LUmZIrg8gSJj_yGR8_d6CH90jhWGxU7vpOPS7x_ZueAB4AEwuShc98auOj5bG520t-t",
          "rating": 4.7,
          "ratingCount": 1000,
          "productId": "1372105290382114078",
          "position": 2
        },
        {
          "title": "GravaStar Mercury K1 Pro 75% Wireless Mechanical Gaming Keyboard",
          "source": "Gravastar",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:13608562084648114567,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$199.95",
          "imageUrl": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcR-TQsWbAOG7o1rBDqFMd6jm3jNAaOOF_3e2Jx1cX5at8vhXPbNNkZTw0WuZWVlx0uwbhj6QNniEGukqRQ8leJCa-Wxelxyw6k1BRFKL5LhiRIiwNJ4zjL1CA",
          "rating": 4.7,
          "ratingCount": 493,
          "productId": "13608562084648114567",
          "position": 3
        },
        {
          "title": "Ducky Origin Vintage Double Shot PBT Mechanical Keyboard Cherry MX",
          "source": "Mechanical Keyboards",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:5748030470703409769,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$79.00",
          "imageUrl": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcR3MvEHH5hEDMgHfOvxGhEeXTcpBdUp7ye1EoKASuls_-EgvFJp88_OZYnDP8jDV8QNL5suAx6dFjYqtS2ikuSQBwJOrlbeiVuEwk52O1U1OIMPwQnHHvg",
          "rating": 4.8,
          "ratingCount": 92,
          "productId": "5748030470703409769",
          "position": 4
        },
        {
          "title": "Womier DUO87 Mechanical Keyboard – Detachable Smart Display",
          "source": "Womier Keyboard",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:17875978550281416490,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$137.00",
          "imageUrl": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcR7iPiHCpJ_te1Mu7OVndFELO-RAkYPt28guxbhUl-Xt8z8Fme9KMhqmZpB5p11wKwvz0OzDl25G5yxCAK0SXx5kDPym_o7j1SIy0oI0UFkosNWWic77EbNgQ",
          "rating": 4.2,
          "ratingCount": 4,
          "productId": "17875978550281416490",
          "position": 5
        },
        {
          "title": "Redragon K686 Wireless Mechanical Keyboard",
          "source": "Redragon",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:15726725006224582620,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$74.99",
          "imageUrl": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcQJzhmsDaPvgtLa0aBhuEtFCjThX6HyE28H5ZBzHFjbqdfM0XL1Teb22C3EStFJRgL30XmZhKQ9NGu1qWzOkK3WAnQFQwaMbcf4SBWkQIe00ra64UmxKYDv",
          "rating": 4.8,
          "ratingCount": 274,
          "productId": "15726725006224582620",
          "position": 6
        },
        {
          "title": "RK ROYAL KLUDGE 96% Hot-Swappable",
          "source": "RK Royal Kludge",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:7810425084434324091,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$84.99",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcQXcsA8mNsVs1QqrU-f095AkcR4asufSiKuUZ2IYyNJR1GjRT6j1a1ppzkoyJrbzfHGwaKS6Msiui9rQknUptv6YSBBtt96rkzI__3nHSqBLRa_YFCEUAMRtg",
          "rating": 4.8,
          "ratingCount": 2500,
          "productId": "7810425084434324091",
          "position": 7
        },
        {
          "title": "Keychron C2 Pro 8K QMK Wired Custom Mechanical Keyboard",
          "source": "Walmart",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:11097985348358538808,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$54.88",
          "imageUrl": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcQC8__1QKAxZ-u1qhy6WgLv-tSffFGv9njl1GxL9nPJ9tl4OP7TE_zFY1czFKrZOWT9qc7HTd8yogde1bFEhWTkpR4_kFHzsyMUzPxT27WGzYOCQtXDPdc5",
          "rating": 4.8,
          "ratingCount": 187,
          "productId": "11097985348358538808",
          "position": 8
        },
        {
          "title": "SteelSeries Apex Pro Gen 3 Gaming Keyboard",
          "source": "Best Buy",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:11295917230918573865,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$224.99",
          "imageUrl": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcRmS27cBS2Ojl93EyGH0naNYSaS2dAk9iRM2jqWypvTDHOOYt59UBM0FSZqQAZrk5tNp5kgLOA3MfnonGc6UIPfibOAFnv0GArlhT7xNwbe5sT65CMzN1wFAA",
          "rating": 4.8,
          "ratingCount": 405,
          "productId": "11295917230918573865",
          "position": 9
        },
        {
          "title": "Akko MG108B Bun Wonderland Keyboard",
          "source": "Micro Center",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:18437200232403210249,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$95.99",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcSFovRuJomo7BV9V5hIZPo4s9P2C13fjwPMWiJexc0ho1-fT4h5-9qTI1yaxPM15VVjNmdSeika-Dd0Gx8DH0A6EUgsXvB52g",
          "rating": 4.9,
          "ratingCount": 33,
          "productId": "18437200232403210249",
          "position": 10
        },
        {
          "title": "LOFREE Flow Lite84 Keyboard",
          "source": "Lofree Official",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:13699470670831714421,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$99.00",
          "imageUrl": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcShd5tCq5fRvRYOQKIVKxw2QNXHjVqdGa7qcvTqD9xLefdokc_EJRvZkOWvssEsjCozhBOoy61ZHf11aAa45HywVirMm7VHCIdBg6PI3JkS6KH-XxwwgyuRBQ",
          "rating": 4.7,
          "ratingCount": 120,
          "productId": "13699470670831714421",
          "position": 11
        },
        {
          "title": "Aula F75 Pro Knob Side-Printed Mechanical Keyboard",
          "source": "AULA Official Store",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:17223130883498045915,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$73.90",
          "imageUrl": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcS-kyHNqVcYU7hN9XwqSaVTc-QEJteJJZ0Q3VHiLPaj9f5InmFeEi7NSxvfbv2CEGcceOgmvCrQjqpm3A1a0H1mH-wwpfTamq3PXo9XFib5RgsHYxExpnzp",
          "rating": 4.9,
          "ratingCount": 443,
          "productId": "17223130883498045915",
          "position": 12
        },
        {
          "title": "GravaStar Mercury K1 Gaming Wireless Keyboard",
          "source": "Gravastar",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:17971885565025398011,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$129.95",
          "imageUrl": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcRZ4UdtZK0Q-T419AFSrzRIOCP7uu6T0sXLVMajYJlNM-xjjJ_1gTKI53pItneB6E9mjGxHrNUwrz22hSB5vT_ZGcGcf1DpWEx74rM9LuGu",
          "rating": 4.8,
          "ratingCount": 872,
          "productId": "17971885565025398011",
          "position": 13
        },
        {
          "title": "Evoworks Evo80 Aluminum TKL Hotswap Wireless Keyboard Spray-coated Cream / HMX Azure / FR4",
          "source": "Mechanical Keyboards",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:12449886256735234372,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$169.99",
          "imageUrl": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcSvQkVcxw5FX4KsptWjZQ-u5L4cXl_Vn4VjnP96xn9WTjPzVvB6oJ8DJX6_7zTzkDZo5m-yDCG7XOwhbrE_ihgELrEvlA9faARE9KJoaJsSI1WyDOPRDQ7BIQ",
          "rating": 4.9,
          "ratingCount": 146,
          "productId": "12449886256735234372",
          "position": 14
        },
        {
          "title": "Keychron Q6 HE QMK Wireless Custom Keyboard",
          "source": "Keychron.com",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:7059410624114633005,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$249.99",
          "imageUrl": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcT-47odwzaroSeNthjWzQIqMc0i7s-Ydw2osWOYmhe55jWxvRyPj00mQ054eIwEC0dgxfA_JxTLUFbTLmOE2AXGtHrvkH5IZ0u7BsCEEzfLTxfIlqt15voRfw",
          "rating": 4.6,
          "ratingCount": 26,
          "productId": "7059410624114633005",
          "position": 15
        },
        {
          "title": "Redragon Dragonborn Gaming Keyboard",
          "source": "Target",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:18294942990556276862,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$39.99",
          "imageUrl": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcQl1_4nxXfyXYhpyjVviZvGzepUh4hD_cDT4Qo_3dl9senykXcBcAMz6m0xWMsJFFImWq7CygXvQSusb2qKKPZ1kzSPrXEB",
          "rating": 4.8,
          "ratingCount": 257,
          "productId": "18294942990556276862",
          "position": 16
        },
        {
          "title": "Razer BlackWidow V4 Pro Mechanical Gaming Keyboard",
          "source": "Razer.com",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:2090868471987316808,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$229.99",
          "imageUrl": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcSv0-_HICcUd_kG5NoXVBmgemk7NRsHCug6alxVx0V0yUBgxFvVnjrQTBgb4TF87S42jPTvpn1hCvtvZUFD_DSxxlDCrUrcV6O6QW1QYzj5oVgNGcjXiocevw",
          "rating": 4.9,
          "ratingCount": 113,
          "productId": "2090868471987316808",
          "position": 17
        },
        {
          "title": "HyperX Alloy Origins 65 Gaming Mechanical Keyboard",
          "source": "Walmart - Leos Warehaus Inc",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:10412508201090334370,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$64.99",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcTUVOTOgGvW1Xtg03YNlpsguGAzi2HdjOy6sa7XqK1hXLl3VGMp3kf8BTfg_ARBbzf0rb39MxyLyzg-O945NwsjKZKrketspt5vc9hC1TQIum_qSmdsKBjP",
          "rating": 4.8,
          "ratingCount": 676,
          "productId": "10412508201090334370",
          "position": 18
        },
        {
          "title": "ROYAL KLUDGE RK61 60% Gaming Mechanical Keyboard for FPS",
          "source": "RK Royal Kludge",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:4840064381012612290,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$54.99",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcRoKmrgHscv4CZUXnjOF-8vdcj4QLk3qgrDzxi6mk8c0qVHWnY3MMl8JoVNw_TrI7AG9SQvZZ0PqWGhT_eLc55RIU50n5kADJfQZMqun6m79ix_bttZX5vRmA",
          "rating": 4.5,
          "ratingCount": 1300,
          "productId": "4840064381012612290",
          "position": 19
        },
        {
          "title": "Keychron V1 Ultra 8K Wireless Mechanical Keyboard",
          "source": "Best Buy",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:12189697796227231637,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$114.99",
          "imageUrl": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcQk5Dkt_4UHtkpTM5VKGksa7MLWUUFlsYa-HPM2bgCOik3yS2uxctau0Uj9WpyacXPo9lL_BFhvIYYbhcDuzv2QpGpY_KghWhMeF53gIURnCjDtVaRGwlsW",
          "rating": 4.7,
          "ratingCount": 35,
          "productId": "12189697796227231637",
          "position": 20
        },
        {
          "title": "Ducky One 3 Matcha Hotswap Double Shot PBT Quack Mechanical Keyboard",
          "source": "Mechanical Keyboards",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:10534862950362891730,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$119.00",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcTon4oYntHBIfq4ZKi5cBDgetoxBOUQP41dN4ONCtT6Sq_yuQ6_AAGw56OzcYCSp-bIr6gMcpFdM8RJAx3CsP_fhMb3AluHpBprJAbZtGlnyrr-7s9tesJw",
          "rating": 4.4,
          "ratingCount": 138,
          "productId": "10534862950362891730",
          "position": 21
        },
        {
          "title": "Keychron K2 Wireless Mechanical Keyboard",
          "source": "Keychron.com",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:17879833808665300620,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$59.99",
          "imageUrl": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcRJj9P-dSI-t_oNJhTVMjmoBYTq3PFfcLEMxrwCrolJi_v-kdUMNiDngeLo75K8GZKy0TdJ_-L3d99z-TycuBqSIW_zpD8-zw6M0McHVoXw_He1Vz4BOdY5",
          "rating": 4.4,
          "ratingCount": 1100,
          "productId": "17879833808665300620",
          "position": 22
        },
        {
          "title": "Logitech G316 X 98 Gaming Keyboard",
          "source": "Logitech G",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:18379726873606918593,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$119.99",
          "imageUrl": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcSH42apx8AnOxSrsay4yxQNqyzwzbZcSJNH4YBtZkGgRfYAPm6qg9lv6PFq4Zs5L0lioMNEwbimkdTRx4Q1T-rZFAzseFBCIsNhrEaw-tySSNSR4OftxAqtng",
          "rating": 4.6,
          "ratingCount": 23,
          "productId": "18379726873606918593",
          "position": 23
        },
        {
          "title": "Keyboard Lofree Flow",
          "source": "Lofree Official",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:11810403505487913553,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$119.00",
          "imageUrl": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcR7jR_e5vJmzP5swTrXWbWef2bPL42T2iayNSqU-1ByNrVIZUOF3SdAxUxR8jkeOpYmtKRrnxIx--w0QGwFqCM3WeZiCGwmU3z8H6kiZyQ5DB1aHrO5uZbSMw",
          "rating": 4.9,
          "ratingCount": 125,
          "productId": "11810403505487913553",
          "position": 24
        },
        {
          "title": "Retro Mechanical Keyboard",
          "source": "7KEYS",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:11494752268746712765,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$97.99",
          "imageUrl": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcTqHc_Jmubaf61naYvm1xegUbsbRjul5uxUC1vfgx4Lc_v7MsWhM-4BtOuq9yL6duHFM_1453batQ14FqY0XRCQ8J73uR6nUrfS-8dveaH1",
          "productId": "11494752268746712765",
          "position": 25
        },
        {
          "title": "Azio Retro Classic Mechanical Keyboard",
          "source": "AZIO Corporation",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:16971097378531019308,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$199.99",
          "imageUrl": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcRjVJ2TMfEX0z5cO-qGpRRcCtGig4NFMYSKGWaEAehtdR6jtjR5_PU1xaihJjdQiRZM9wFNLSy9WaqZmRTLS6wAf4X6QnT9kLzVhkPjL3PlO31EixxJJFBh2Q",
          "rating": 4.6,
          "ratingCount": 114,
          "productId": "16971097378531019308",
          "position": 26
        },
        {
          "title": "Keychron Q1 Ultra 8K Wireless Mechanical Keyboard",
          "source": "Keychron.com",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:5344649837165815560,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$229.99",
          "imageUrl": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcSAchEW3gEEJ0A80awI9E_9K45mDR99a5T3QMeVOscwxr70hTDEzm25g9ynkBcWTLFIV0g4kj_JNLzdopCCV2jexWfyFZ1TooKgOZ0Kabv-c1EQMXkXTDrK",
          "rating": 4.9,
          "ratingCount": 9,
          "productId": "5344649837165815560",
          "position": 27
        },
        {
          "title": "Gravastar Mercury V75 Pro Gaming Keyboard",
          "source": "Best Buy",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:8177873089576243083,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$239.95",
          "imageUrl": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcTTcYILadyJ88aGKjCx8IY2Bcrlvr9Pj1TilR4S4FIYNGGQGk7atpxspBbUbV5hZj1y96lo9u2LY9dKnUxm2M9BwjHk4uZE8_QIcZmuTJY",
          "rating": 4.8,
          "ratingCount": 53,
          "productId": "8177873089576243083",
          "position": 28
        },
        {
          "title": "Evoworks Evo80 Aluminum TKL Hotswap Wireless Keyboard",
          "source": "Mechanical Keyboards",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:13253336244308435657,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$169.99",
          "imageUrl": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcSbS8Qt7QIAKPV12kZDZHEDGHIDNVPOxXOBFGcabuXjA9S1CqxcGeYArXfaj5JkCH57-KCdNhRB8Ze9P6v0gyr7h28vP1IuDgzahV5kTdn3rcCmDPCMqHpAZA",
          "rating": 4.8,
          "ratingCount": 184,
          "productId": "13253336244308435657",
          "position": 29
        },
        {
          "title": "NuPhy Air75 v3",
          "source": "NUPHY",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:13232011580101638860,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$149.95",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcSXSuE2QgS_Orh5vNXDLz0Ig1QvgnUZnhVxLcPOFvPGK7P0PPWVGGQEzZax7oSx_aifGwgka_A6LTeMV1guizqYXDdeYVSLdy9mMTDVYjlx01drJKK7jQ",
          "rating": 4.7,
          "ratingCount": 489,
          "productId": "13232011580101638860",
          "position": 30
        },
        {
          "title": "Corsair K100 RGB Mechanical Gaming Keyboard",
          "source": "Connection",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:8949332337056099610,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$391.95",
          "imageUrl": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcTGar80LcLrZgPf5fUfP8AhEK29YwWkpaSXSQDG0WwJ7GzC-2L2eGZlyZbp3f5wk5cjjYBXZT-Q1A3WKGbQK6VJFiOJe3QzxiVeVaysjL9q1DgCgkAo92M-",
          "rating": 4.4,
          "ratingCount": 49,
          "productId": "8949332337056099610",
          "position": 31
        },
        {
          "title": "Keychron Q6 Ultra 8K Wireless RGB Keyboard",
          "source": "Keychron.com",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:5451284706787390668,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$239.99",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcRuvNzVRvGSlbu5UzMxHNnAFyBNWmhU01ty4QZJahImos_-sejyWAUk5Om1jOFrouVPvJaBEnMQ2HKDRVAbBhancZxuJyplmT2xxnIeiflegpVxuCOPmEXO",
          "rating": 4.6,
          "ratingCount": 8,
          "productId": "5451284706787390668",
          "position": 32
        },
        {
          "title": "Logitech G915 X Wired Mechanical Gaming Keyboard",
          "source": "CDW",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:12098348343970192457,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$199.99",
          "imageUrl": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcSmWp2ZPnH2E0iKlUEpRg-m6EWItJldw1g6mPKbexPC-BmF3TJQ2ISIHdZfTRB-7xxbNCEbmGmu6gUyCaqpKdOHMOK8AN5S334uuCAZ-Ws",
          "rating": 4.4,
          "ratingCount": 145,
          "productId": "12098348343970192457",
          "position": 33
        },
        {
          "title": "Gravastar Mercury V75 HE Gaming Keyboard",
          "source": "Gravastar",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:4273064024988134567,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$169.95",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcS9dZLyOhHs4MMqzd7xd1XAbdPcF7ERKi8OGhj4fvqd3a9nh3ockFbtY9_6fBh2fjnwLEFe9iRdplt0ClKHU-aixJkI-vMp1fSR_tB5QPdRqpsRy914J7xwFw",
          "rating": 4.6,
          "ratingCount": 139,
          "productId": "4273064024988134567",
          "position": 34
        },
        {
          "title": "LUMINKEY Luminkey98 V2 Aluminum Wireless Keyboard",
          "source": "Mechanical Keyboards",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:12394711049720633366,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$268.00",
          "imageUrl": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcT4prylIX0SZxZF2EaqnMemG6MEBXLYGIIk57ByYkC-duZBl2G8axwrkia5uZf78wmy0eRHDfxNlsfRzoimM3PVQ-vfV_TtkFAH7uUqiTNwx3bZIfGrGB_Npg",
          "productId": "12394711049720633366",
          "position": 35
        },
        {
          "title": "Magegee Typewriter Mechanical Gaming Keyboard Retro Black Punk Round Keycaps RGB Rainbow Backlit Wired Keyboards for Laptop MAC PC Gamer",
          "source": "Best Buy",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:5028287084613668314,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$35.99",
          "imageUrl": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcTYo9SaiL6a-oKyaIJ76AdZPWLwvJBOVJiVC9lOpSE2GSHuEtGW4y_bXkt6HcWg5llCCwVPuaLIqzyYGFaphGqZmhlJe16_3lUVBeg1B9cQGekdSAyoQEgTIA",
          "productId": "5028287084613668314",
          "position": 36
        },
        {
          "title": "Keychron Q11 Ultra 8K Wireless Custom Mechanical Keyboard Fully Assembled Knob",
          "source": "Keychron.com",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:11985821720110681337,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$239.99",
          "imageUrl": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcQA5SFnjw7sWt8R2VeLl0ep8zeF0GFVfNqmnHjoN8vqHqCISWah2dxjvNogTEiWA6SVc4s5NOPjHo-n4OdCej8sx8U_fSLKzuk9x5_1Vl-4M9pzeFf_GP7kOA",
          "rating": 3.4,
          "ratingCount": 12,
          "productId": "11985821720110681337",
          "position": 37
        },
        {
          "title": "GravaStar Mercury K98 Pro Wireless Mechanical Gaming Keyboard",
          "source": "Micro Center",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:4603642511690907054,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$259.95",
          "imageUrl": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcSKxyO9WY0og_9FsQznsx3gJ5ZQzlBzyoVTbbCjM9cTN7FWsLpbgWACg3QHqGOpSuZBXpEV4-fFvAzztRnJ3wRHJt3HaQFQpXQIF1bPDqmmYYVkr18x8w5Rvg",
          "rating": 4.8,
          "ratingCount": 42,
          "productId": "4603642511690907054",
          "position": 38
        },
        {
          "title": "Redragon K556 RGB LED Mechanical Keyboard",
          "source": "Newegg.com",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:16226565545758173114,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$59.99",
          "imageUrl": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcS7ikFjhBZdQ7nefZ7NgQk4ExorwA_pm9sP_ewfHab40aCtJBFq5JK-IDl2_oGfULl8wO1FO0NobMgWsbdeJKqSWIK_DguzHkhKzcBHgGr9AxQCabmj59xl3A",
          "rating": 4.7,
          "ratingCount": 42,
          "productId": "16226565545758173114",
          "position": 39
        },
        {
          "title": "Varmilo Sword 2-87 White LED TKL Dye Sub PBT Aluminum Mechanical Keyboard",
          "source": "Mechanical Keyboards",
          "link": "https://www.google.com/search?ibp=oshop&q=mechanical+keyboard&prds=localAnnotatedOfferId:1,catalogid:12906304364526863838,pvo:2,pvt:hg,rds:PC_6027158597472037202%7CPROD_PC_6027158597472037202&gl=us&udm=28&pvorigin=2",
          "price": "$250.00",
          "imageUrl": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcSQxoIDwkIgSrqqFqGsMicrAQFfgu8xXXkuusupH87wV56cjqn7-MMY0ZMBYmORlOTJxbP6Tmlyc-_CzhL7C1ZLCUJ-TPYNySekPZ-1JPB8tlBmSzOGWCAgOQ",
          "productId": "12906304364526863838",
          "position": 40
        }
      ]
    }
  ],
  "usage": {
    "credits": 0.02
  },
  "created_at": "2026-09-16T07:41:40.048Z"
}
```

## Response fields

| Field | Type | Description |
| --- | --- | --- |
| source | string | The requested API source. |
| status | string | done when the realtime request succeeds. |
| created_at | string | Response creation time in ISO 8601 format. |
| usage.credits | number | Credits charged for the request, based on your plan. |
| results[0].searchParameters | object | Search settings reported by Google, with the query recorded as q. Returned settings may differ from the requested values. |
| results[0].shopping | array | Shopping search results. |
| results[0].shopping[].title | string | Product title. |
| results[0].shopping[].link | string | Product listing URL. |
| results[0].shopping[].source | string · optional | Merchant name. |
| results[0].shopping[].price | string · optional | Displayed price including currency formatting. |
| results[0].shopping[].delivery | string · optional | Displayed delivery details. |
| results[0].shopping[].rating | number · optional | Product rating. |
| results[0].shopping[].ratingCount | integer · optional | Number of ratings. |
| results[0].shopping[].imageUrl | string · optional | Product image URL. |
| results[0].shopping[].position | integer | Result position. |
| results[0].shopping[].productId | string · optional | Google product identifier when available. |

- Available fields depend on the query and search type. Optional fields may be absent, and additional fields may be returned.
- The number of returned items and searchParameters.num can differ from params.num. Use the returned array to determine the actual result count.

## Response formats

Responses use JSON by default. Choose another format with these optional headers.

- Accept: application/json (default) or text/plain. Plain text presents the same fields in a readable, indented layout.
- X-Respond-With: markdown. Leave unset for original fields. Markdown works with either response format.

Markdown is available for realtime queries and completed results.

The fields below describe the default JSON response.

[Request and response format examples](https://flashdata.dev/docs/guides/response-formats/reference.md#headers)

<a id="job-lifecycle"></a>

<a id="async-batch"></a>

## API basics

The request builder and examples above use this source's parameters. Use the Python and cURL examples below for shared submission, status and result steps. A Batch body is a JSON object containing queries; each item returns its own job ID.

- [Async request and receipt](https://flashdata.dev/docs/reference/realtime-and-async/reference.md#async)

<a id="job-status"></a>

- [Check job status](https://flashdata.dev/docs/reference/realtime-and-async/reference.md#status)

<a id="job-results"></a>

- [Retrieve completed results](https://flashdata.dev/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON requests](https://flashdata.dev/docs/reference/batch-and-bulk/reference.md#batch)
- [Customer OpenAPI](https://flashdata.dev/docs/openapi.json)

<a id="webhooks"></a>

<a id="callbacks"></a>

## Completion notifications

- [Receive and verify completion webhooks](https://flashdata.dev/docs/guides/async-batch/reference.md#webhooks)

<a id="troubleshooting"></a>

## Troubleshooting

- [Errors and status codes](https://flashdata.dev/docs/errors/reference.md#status-codes)
- [When to retry](https://flashdata.dev/docs/errors/reference.md#retries)

## Related APIs

- [Google Search API](https://flashdata.dev/docs/sources/google_search/reference.md)
- [Google Images API](https://flashdata.dev/docs/sources/google_images/reference.md)
