# FlashData Google Shopping API

Пошук товарів Google для товарів і отримання цін, торговців, рейтингів і посилань на продукт в структурованих JSON.

Канонічне посилання: https://flashdata.dev/uk/docs/sources/google_shopping
Відгук: 2026-10-23

Навігація: POST https://data.flashdata.dev/v1/queries/realtime
Автентифікація: X-API-Key: YOUR_API_KEY
Режими: [Realtime](https://flashdata.dev/uk/docs/reference/realtime-and-async/reference.md#realtime) · [Async](https://flashdata.dev/uk/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/uk/docs/reference/batch-and-bulk/reference.md#batch)

Обов'язковий дозвіл на джерело: google_shopping

Замініть YOUR_API_KEY з ключем API, який має дозвіл на джерело та доступні кредити. Виконайте запити на сервер або агент.

[Налаштування автентичності](https://flashdata.dev/uk/docs/guides/headers-and-authentication/reference.md)

[Оберіть та рефінансуйте пошук Google](https://flashdata.dev/uk/docs/guides/google-search-guide/reference.md)

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

## Надіслати запит

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

## Параметри

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

### Тіло запиту

| Параметр | Типи | Обов’язково | За замовчуванням | Опис |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | ТОЙ | — | Набір до google_shopping.  |
| <a id="parameter-query"></a> query | string | ТОЙ | Не встановити | Пошук запитів. Підтримує оператори Google, такі як сайт: і в назві: Мінімальна довжина: 1. Максимальна довжина: 2000. |
| <a id="parameter-params"></a> params | object | Ні | {} | Settings для цього запиту.  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | Ні | Не встановити | Async і партії тільки. Public HTTPS завершена URL на порту 443, до 2,048 символів. Немає облікових даних користувача або фрагмента URL. Omit, використовуйте null або порожній рядок для повідомлення. У партії, встановивши це на кожному запиту, за межами парам.  |

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

### Країна, мова та місце розташування

| Параметр | Типи | Обов’язково | За замовчуванням | Опис |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-gl"></a> params.gl | string | Ні | Не встановити | Двомісний код країни, наприклад, нам, gb, de або sg. Визначте явно для вибору країни. Мінімальна довжина: 2. Максимальна довжина: 2. Візерунок: ^[A-Za-z]{2}$ |
| <a id="parameter-params-hl"></a> params.hl | string | Ні | Не встановити | Google мова інтерфейсу. Налаштуйте явно для вибору мови. Мінімальна довжина: 1. Максимальна довжина: 35. Візерунок: ^[A-Za-z0-9-]+$ |
| <a id="parameter-params-location"></a> params.location | string | Ні | Не встановити | Запрошення місця пошуку, бажано місто, таких як "London, England, United Kingdom". Наявність залежить від типу пошуку. Мінімальна довжина: 1. Максимальна довжина: 200. |

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

### Пігментація

| Параметр | Типи | Обов’язково | За замовчуванням | Опис |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-num"></a> params.num | integer | Ні | Не встановити | Заявка на результат. FlashData не додає фіксованого за замовчуванням при в'язанні. Повернутий рахунок може відрізнятися за типом запиту і типом пошуку. Мінімальне: 1. Максимальна потужність: 100. |
| <a id="parameter-params-page"></a> params.page | integer | Ні | Не встановити | Заявка на результат сторінки. Встановити явно. Кожна сторінка - окремий запит API. Мінімальне: 1. Максимальна потужність: 100. |

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

### Фільтри для пошуку

| Параметр | Типи | Обов’язково | За замовчуванням | Опис |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-tbs"></a> params.tbs | string | Ні | Не встановити | Заява Google пошук фільтрів, таких як qdr:d для минулого дня або qdr:w за минулий тиждень. Наявність залежить від типу пошуку. Мінімальна довжина: 1. Максимальна довжина: 200. |
| <a id="parameter-params-autocorrect"></a> params.autocorrect | boolean | Ні | Не встановити | Заявка на виправлення заклинання з true або запитом її вимкнено з false. Застосовується поведінка залежить від типу пошуку; для використання поведінки Google.  |

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

## Читати результат

Збережіть успішну відповідь JSON як response.json. Збережіть це як read-response.py і запустіть python read-response.py. Використовуються тільки Python- стандартна бібліотека і не дає нового запиту.

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

## Приклад відповіді

Зареєстрований приклад; поля та підрахунки залежать від джерела та запитуваного введення.
```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"
}
```

## Поля зворотнього зв'язку

| Поле | Типи | Опис |
| --- | --- | --- |
| source | string | За запитом джерело API. |
| status | string | в режимі реального часу, якщо в реальному часі буде досягнуто запит. |
| created_at | string | Час створення відповіді в форматі ISO 8601. |
| usage.credits | number | Кредит, що стягується за запит, виходячи з тарифного плану. |
| results[0].searchParameters | object | Параметри пошуку, які були опубліковані Google, з запитом, записаним як q. Повернуті налаштування можуть відрізнятися від заданих значень. |
| results[0].shopping | array | Результати пошуку покупок. |
| results[0].shopping[].title | string | Назва продукту. |
| results[0].shopping[].link | string | Список продуктів URL. |
| results[0].shopping[].source | string · optional | Ім'я товара. |
| results[0].shopping[].price | string · optional | Відобразена ціна, включаючи валютне форматування. |
| results[0].shopping[].delivery | string · optional | Відображення деталей доставки. |
| results[0].shopping[].rating | number · optional | Оцінка продукту. |
| results[0].shopping[].ratingCount | integer · optional | Кількість рейтингів. |
| results[0].shopping[].imageUrl | string · optional | Зображення продукту URL. |
| results[0].shopping[].position | integer | Результатів пошуку. |
| results[0].shopping[].productId | string · optional | Google виписаний при наявності. |

- Доступні поля залежать від типу запиту та пошуку. Можливі додаткові поля, які можуть бути повернені.
- Кількість відправлених предметів і searchParameters.num може відрізнятися від params.num. Використовуйте повернуті масиви для визначення фактичного результату.

## Формати відповідей

Відповіді використовуйте JSON за замовчуванням. Виберіть інший формат з цими заголовками.

- Accept: application/json (За замовчуванням) або text/plain. Плайн-фактура представляє ті ж поля, які можна прочитати, відступивши макет.
- X-Respond-With: markdown. Залиште заявку на оригінальні поля. Markdown працює з форматом відповіді.

Markdown доступна для запитів в режимі реального часу і завершених результатів.

На полях нижче описано відповідь JSON.

[Приклади форматів запиту та відповіді](https://flashdata.dev/uk/docs/guides/response-formats/reference.md#headers)

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

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

## Основи API

На прикладі конструктора запиту та прикладів, які вище використовують параметри цього джерела. Використовуйте Python і cURL прикладів нижче для спільного подання, стану та кроків результату. Корпус Batch є об'єктом JSON, що містить запити; кожен елемент повертає свою власну роботу ID.

- [Async запит та отримання](https://flashdata.dev/uk/docs/reference/realtime-and-async/reference.md#async)

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

- [Перевірити статус роботи](https://flashdata.dev/uk/docs/reference/realtime-and-async/reference.md#status)

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

- [Результати пошуку](https://flashdata.dev/uk/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON запитів](https://flashdata.dev/uk/docs/reference/batch-and-bulk/reference.md#batch)
- [Клієнт OpenAPI](https://flashdata.dev/docs/openapi.json)

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

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

## Повідомлення про видалення

- [Отримувати і перевірити завершення вебхуки](https://flashdata.dev/uk/docs/guides/async-batch/reference.md#webhooks)

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

## Виправлення несправностей

- [Помилки й коди стану](https://flashdata.dev/uk/docs/errors/reference.md#status-codes)
- [Коли птиця](https://flashdata.dev/uk/docs/errors/reference.md#retries)

## Схожі API

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