# FlashData Google Shopping API

Procure Google Comprando produtos e recuperando preços, comerciantes, classificações e links de produtos em JSON estruturado.

Referência canônica: https://flashdata.dev/pt/docs/sources/google_shopping
Revisado: 2026-10-23

Ponto final: POST https://data.flashdata.dev/v1/queries/realtime
Autenticação: X-API-Key: YOUR_API_KEY
Modos: [Realtime](https://flashdata.dev/pt/docs/reference/realtime-and-async/reference.md#realtime) · [Async](https://flashdata.dev/pt/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/pt/docs/reference/batch-and-bulk/reference.md#batch)

Precisou de permissão de origem: google_shopping

Substitua YOUR_API_KEY por uma chave API que tem essa permissão de fonte e créditos disponíveis. Execute pedidos no seu servidor ou host de agente.

[Configurar autenticação](https://flashdata.dev/pt/docs/guides/headers-and-authentication/reference.md)

[Escolha e refine uma busca Google](https://flashdata.dev/pt/docs/guides/google-search-guide/reference.md)

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

## Envie um pedido

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

## Parâmetros

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

### Corpo da requisição

| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | Sim | — | Preparar para google_shopping.  |
| <a id="parameter-query"></a> query | string | Sim | Não está pronto | Pesquisando. Suporta operadores de busca Google como site e título: Comprimento mínimo: 1. Comprimento máximo: 2000. |
| <a id="parameter-params"></a> params | object | Não | {} | Settings para este pedido.  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | Não | Não está pronto | Async e apenas lote. HTTPS conclusão URL na porta 443, até caracteres 2,048. Sem credenciais de usuário ou fragmento URL. Omit, use null ou uma string vazia para nenhuma notificação. Em um lote, coloque isso em cada consulta, fora dos parâmetros.  |

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

### País, idioma e localização

| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-gl"></a> params.gl | string | Não | Não está pronto | Código de país de duas letras, como nós, gb, de ou sg. Defina explicitamente para selecionar um país. Comprimento mínimo: 2. Comprimento máximo: 2. Padrão: ^[A-Za-z]{2}$ |
| <a id="parameter-params-hl"></a> params.hl | string | Não | Não está pronto | Google linguagem de interface. Defina explicitamente para selecionar um idioma. Comprimento mínimo: 1. Comprimento máximo: 35. Padrão: ^[A-Za-z0-9-]+$ |
| <a id="parameter-params-location"></a> params.location | string | Não | Não está pronto | Local de busca solicitado, de preferência uma cidade, como "London, England, United Kingdom". Disponibilidade depende do tipo de busca. Comprimento mínimo: 1. Comprimento máximo: 200. |

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

### Paginação

| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-num"></a> params.num | integer | Não | Não está pronto | Número de resultados solicitados. FlashData não adiciona um padrão fixo quando omitido. A contagem retornada pode diferir por tipo de pesquisa e pesquisa. Mínimo: 1. Máximo: 100. |
| <a id="parameter-params-page"></a> params.page | integer | Não | Não está pronto | Página de resultados solicitada. Set explicitamente. Cada página é um pedido API separado. Mínimo: 1. Máximo: 100. |

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

### Filtros de busca

| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-tbs"></a> params.tbs | string | Não | Não está pronto | Solicitados filtros de busca Google, como qdr:d para o último dia ou qdr:w para a última semana. Disponibilidade depende do tipo de busca. Comprimento mínimo: 1. Comprimento máximo: 200. |
| <a id="parameter-params-autocorrect"></a> params.autocorrect | boolean | Não | Não está pronto | Solicite correção ortográfica com true ou peça desativada com false. O comportamento aplicado depende do tipo de busca, omitir usar o comportamento do Google.  |

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

## Leia o resultado

Salve a resposta JSON bem sucedida como response.json. Guarde isso como read-response.py e execute python read-response.py. Ele usa apenas a biblioteca padrão do Python e não faz nenhum novo pedido.

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

## Exemplo de resposta

Exemplo gravado; campos e conta depende da fonte e entrada solicitada.
```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"
}
```

## Campos de resposta

| Campo | Tipo | Descrição |
| --- | --- | --- |
| source | string | A fonte API solicitada. |
| status | string | Feito quando o pedido em tempo real for bem sucedido. |
| created_at | string | Tempo de criação de resposta no formato ISO 8601. |
| usage.credits | number | Créditos cobrados pelo pedido, baseado no seu plano. |
| results[0].searchParameters | object | Configurações de pesquisa relatadas por Google, com a consulta gravada como q. Configurações devolvidas podem diferir dos valores solicitados. |
| results[0].shopping | array | Resultados de busca de compras. |
| results[0].shopping[].title | string | Título do produto. |
| results[0].shopping[].link | string | Lista de produtos URL. |
| results[0].shopping[].source | string · optional | Nome mercante. |
| results[0].shopping[].price | string · optional | Preço mostrado, incluindo formatação de moeda. |
| results[0].shopping[].delivery | string · optional | Mostrei detalhes da entrega. |
| results[0].shopping[].rating | number · optional | Classificação de produto. |
| results[0].shopping[].ratingCount | integer · optional | Número de audiências. |
| results[0].shopping[].imageUrl | string · optional | Imagem do produto URL. |
| results[0].shopping[].position | integer | Posição do resultado. |
| results[0].shopping[].productId | string · optional | Google identificador de produto quando disponível. |

- Campos disponíveis dependem do tipo de pesquisa e pesquisa. Campos opcionais podem estar ausentes, e campos adicionais podem ser devolvidos.
- O número de itens devolvidos e searchParameters.num pode diferir do params.num. Use a matriz de retorno para determinar a contagem real de resultados.

## Formatos de resposta

Respostas usam JSON por padrão. Escolha outro formato com esses cabeçalhos opcionais.

- Accept: application/json (padrão) ou text/plain. Texto simples apresenta os mesmos campos em um layout legível e indentado.
- X-Respond-With: markdown. Deixe de lado os campos originais. Markdown funciona com qualquer formato de resposta.

Markdown está disponível para consultas em tempo real e resultados completos.

Os campos abaixo descrevem a resposta padrão JSON.

[Requisito e formatação de resposta exemplos](https://flashdata.dev/pt/docs/guides/response-formats/reference.md#headers)

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

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

## Conceitos básicos da API

O construtor de pedidos e exemplos acima usam os parâmetros desta fonte. Use os exemplos Python e cURL abaixo para submissão compartilhada, status e passos de resultado. Um corpo Batch é um objeto JSON contendo consultas, cada item retorna seu próprio trabalho ID.

- [Async pedido e recibo](https://flashdata.dev/pt/docs/reference/realtime-and-async/reference.md#async)

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

- [Verifique o status do trabalho](https://flashdata.dev/pt/docs/reference/realtime-and-async/reference.md#status)

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

- [Recupere resultados completados](https://flashdata.dev/pt/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON pedidos](https://flashdata.dev/pt/docs/reference/batch-and-bulk/reference.md#batch)
- [Cliente OpenAPI](https://flashdata.dev/docs/openapi.json)

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

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

## Notificações de conclusão

- [Receba e verifique os hooks de conclusão](https://flashdata.dev/pt/docs/guides/async-batch/reference.md#webhooks)

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

## Solução de problemas

- [Erros e códigos de status](https://flashdata.dev/pt/docs/errors/reference.md#status-codes)
- [Quando tentar novamente](https://flashdata.dev/pt/docs/errors/reference.md#retries)

## APIs relacionadas

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