# FlashData Google Shopping API

Cari Google Belanja untuk produk dan mengambil harga, pedagang, peringkat dan link produk dalam terstruktur JSON.

Referensi kanonikal: https://flashdata.dev/id/docs/sources/google_shopping
Diulas: 2026-10-23

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

Izin sumber yang diperlukan: google_shopping

Ganti kunci YOUR_API_KEY dengan kunci API yang memiliki hak sumber ini dan kredit yang tersedia. Jalankan permintaan pada server atau agen host.

[Atur otentikasi](https://flashdata.dev/id/docs/guides/headers-and-authentication/reference.md)

[Pilih dan perbaiki pencarian Google](https://flashdata.dev/id/docs/guides/google-search-guide/reference.md)

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

## Kirim permintaan

### 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>

## Parameter

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

### Isi permintaan

| Parameter | Jenis | Wajib | Default | Deskripsi |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | Ya | — | Set ke google_shopping.  |
| <a id="parameter-query"></a> query | string | Ya | Tak ditata | Cari query. Dukungan Google operator pencarian seperti situs: dan tinta:. Panjang Min: 1. Panjang Max: 2000. |
| <a id="parameter-params"></a> params | object | Tidak | {} | Settings untuk permintaan ini.  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | Tidak | Tak ditata | Async dan batch saja. Publik HTTPS pelengkapan URL di port 443, sampai 2,048 karakter. Tak ada kredensial pengguna atau fragmen URL. Omit, gunakan null atau string kosong untuk tanpa pemberitahuan. Dalam batch, set ini pada setiap query, di luar param.  |

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

### Negara, bahasa & lokasi

| Parameter | Jenis | Wajib | Default | Deskripsi |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-gl"></a> params.gl | string | Tidak | Tak ditata | Dua huruf kode negara, seperti kita, gb, de atau sg. Set secara eksplisit untuk memilih suatu negara. Panjang Min: 2. Panjang Max: 2. Pola: ^[A-Za-z]{2}$ |
| <a id="parameter-params-hl"></a> params.hl | string | Tidak | Tak ditata | Google bahasa antarmuka. Set secara eksplisit untuk memilih suatu bahasa. Panjang Min: 1. Panjang Max: 35. Pola: ^[A-Za-z0-9-]+$ |
| <a id="parameter-params-location"></a> params.location | string | Tidak | Tak ditata | Lokasi pencarian yang diminta, sebaiknya sebuah kota, seperti "London, England, United Kingdom". Ketersediaan tergantung pada tipe pencarian. Panjang Min: 1. Panjang Max: 200. |

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

### Paginasi

| Parameter | Jenis | Wajib | Default | Deskripsi |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-num"></a> params.num | integer | Tidak | Tak ditata | Jumlah hasil yang diminta. FlashData tidak menambahkan default tetap ketika diabaikan. Jumlah yang kembali dapat berbeda dengan tipe query dan search. Minimum: 1. Maksimum: 100. |
| <a id="parameter-params-page"></a> params.page | integer | Tidak | Tak ditata | Halaman hasil yang diminta. Set secara eksplisit. Setiap halaman adalah permintaan terpisah API. Minimum: 1. Maksimum: 100. |

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

### Saringan pencarian

| Parameter | Jenis | Wajib | Default | Deskripsi |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-tbs"></a> params.tbs | string | Tidak | Tak ditata | Diminta Google cari filter, seperti qdr: d untuk hari terakhir atau qdr: w untuk minggu terakhir. Ketersediaan tergantung pada tipe pencarian. Panjang Min: 1. Panjang Max: 200. |
| <a id="parameter-params-autocorrect"></a> params.autocorrect | boolean | Tidak | Tak ditata | Permintaan koreksi ejaan dengan true atau permintaan itu dinonaktifkan dengan false. Perilaku terapan tergantung pada tipe pencarian; omit untuk menggunakan perilaku Google.  |

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

## Baca hasilnya

Simpan respon JSON sukses sebagai response.json. Simpan ini sebagai read-response.py dan jalankan python read-response.py. Ini hanya menggunakan Python perpustakaan standar dan tidak membuat permintaan baru.

### 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))
```

## Contoh respons

Contoh direkam; ruas dan jumlah bergantung pada sumber dan masukan yang diminta.
```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"
}
```

## Ruas respon

| Ruas | Jenis | Deskripsi |
| --- | --- | --- |
| source | string | Sumber yang diminta API. |
| status | string | dilakukan ketika permintaan realtime sukses. |
| created_at | string | Waktu pembuatan respon dalam format ISO 8601. |
| usage.credits | number | Kredit dikenakan biaya untuk permintaan, berdasarkan rencana Anda. |
| results[0].searchParameters | object | Pengaturan pencarian dilaporkan oleh Google, dengan query direkam sebagai q. Pengaturan ulang mungkin berbeda dari nilai yang diminta. |
| results[0].shopping | array | Hasil pencarian belanja. |
| results[0].shopping[].title | string | Gelar produksi. |
| results[0].shopping[].link | string | Daftar produk URL. |
| results[0].shopping[].source | string · optional | Nama dagang. |
| results[0].shopping[].price | string · optional | Harga yang ditampilkan termasuk pemformatan mata uang. |
| results[0].shopping[].delivery | string · optional | Rincian pengiriman yang ditampilkan. |
| results[0].shopping[].rating | number · optional | Rating produk. |
| results[0].shopping[].ratingCount | integer · optional | Jumlah rating. |
| results[0].shopping[].imageUrl | string · optional | Gambar produk URL. |
| results[0].shopping[].position | integer | Posisi hasil. |
| results[0].shopping[].productId | string · optional | Google identifikasi produk ketika tersedia. |

- Ruas tersedia bergantung pada tipe query dan search. Bidang opsional mungkin tidak hadir, dan bidang tambahan mungkin dikembalikan.
- Jumlah item yang dikembalikan dan searchParameters.num dapat berbeda dari params.num. Gunakan array yang dikembalikan untuk menentukan jumlah hasil yang sebenarnya.

## Format respons

Respon menggunakan JSON secara baku. Pilih format lain dengan header opsional ini.

- Accept: application/json (baku) atau text/plain. Teks biasa menyajikan ruas yang sama dalam tata letak yang dapat dibaca, tidak terbaca.
- X-Respond-With: markdown. Tinggalkan unset untuk bidang asli. Markdown bekerja dengan baik format respon.

Markdown tersedia untuk kueri realtime dan hasil selesai.

Bidang di bawah ini menjelaskan respon baku JSON.

[Permohonan dan contoh format respon](https://flashdata.dev/id/docs/guides/response-formats/reference.md#headers)

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

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

## Dasar-dasar API

Permintaan pembangun dan contoh di atas menggunakan parameter sumber ini. Gunakan contoh Python dan cURL di bawah ini untuk penyerahan bersama, status, dan langkah-langkah hasil. Tubuh Batch adalah objek JSON berisi kueri; setiap item mengembalikan pekerjaannya sendiri ID.

- [Async permintaan dan tanda terima](https://flashdata.dev/id/docs/reference/realtime-and-async/reference.md#async)

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

- [Periksa status pekerjaan](https://flashdata.dev/id/docs/reference/realtime-and-async/reference.md#status)

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

- [Mengambil hasil selesai](https://flashdata.dev/id/docs/reference/realtime-and-async/reference.md#results)
- [permintaan Batch JSON](https://flashdata.dev/id/docs/reference/batch-and-bulk/reference.md#batch)
- [Pelanggan OpenAPI](https://flashdata.dev/docs/openapi.json)

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

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

## Pemberitahuan penyelesaian

- [Menerima dan memverifikasi pelengkapan webhooks](https://flashdata.dev/id/docs/guides/async-batch/reference.md#webhooks)

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

## Permasalahan menarik

- [Kesalahan dan kode status](https://flashdata.dev/id/docs/errors/reference.md#status-codes)
- [Kapan untuk mencoba lagi](https://flashdata.dev/id/docs/errors/reference.md#retries)

## Terkait APIs

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