# FlashData API Google Shopping

Recherchez des produits dans Google Shopping et récupérez leurs prix, les vendeurs, les notes et les liens au format JSON structuré.

Référence canonique : https://flashdata.dev/fr/docs/sources/google_shopping
Révisé le : 2026-10-23

Endpoint: POST https://data.flashdata.dev/v1/queries/realtime
Authentification: X-API-Key: YOUR_API_KEY
Modes: [Temps réel](https://flashdata.dev/fr/docs/reference/realtime-and-async/reference.md#realtime) · [Asynchrone](https://flashdata.dev/fr/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/fr/docs/reference/batch-and-bulk/reference.md#batch)

Autorisation requise pour la source: google_shopping

Remplacez YOUR_API_KEY par une clé API disposant de la permission requise pour cette source et d’un solde de crédits disponible. Exécutez les requêtes sur votre serveur ou dans l’environnement de votre agent.

[Configurer l’authentification](https://flashdata.dev/fr/docs/guides/headers-and-authentication/reference.md)

[Choisir et affiner une recherche Google](https://flashdata.dev/fr/docs/guides/google-search-guide/reference.md)

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

## Envoyer une requête

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

## Paramètres

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

### Corps de la requête

| Paramètre | Type | Obligatoire | Par défaut | Description |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | Oui | — | Définissez ce champ sur google_shopping.  |
| <a id="parameter-query"></a> query | string | Oui | Non défini | Requête de recherche. Les opérateurs Google tels que site: et intitle: sont pris en charge. Longueur minimale : 1. Longueur maximale : 2000. |
| <a id="parameter-params"></a> params | object | Non | {} | Paramètres de cette requête.  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | Non | Non défini | Async et Batch uniquement. URL HTTPS publique de notification sur le port 443, de 2 048 caractères maximum, sans identifiants ni fragment. Omettez ce champ, ou utilisez null ou une chaîne vide pour désactiver les notifications. Dans un Batch, définissez-le pour chaque requête, en dehors de params.  |

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

### Pays, langue et lieu

| Paramètre | Type | Obligatoire | Par défaut | Description |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-gl"></a> params.gl | string | Non | Non défini | Code pays à deux lettres, par exemple us, gb, de ou sg. Renseignez-le explicitement pour sélectionner un pays. Longueur minimale : 2. Longueur maximale : 2. Format : ^[A-Za-z]{2}$ |
| <a id="parameter-params-hl"></a> params.hl | string | Non | Non défini | Langue de l’interface Google. Renseignez ce champ explicitement pour sélectionner une langue. Longueur minimale : 1. Longueur maximale : 35. Format : ^[A-Za-z0-9-]+$ |
| <a id="parameter-params-location"></a> params.location | string | Non | Non défini | Lieu de recherche demandé, de préférence une ville, par exemple "London, England, United Kingdom". Sa prise en compte dépend du type de recherche. Longueur minimale : 1. Longueur maximale : 200. |

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

### Pagination

| Paramètre | Type | Obligatoire | Par défaut | Description |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-num"></a> params.num | integer | Non | Non défini | Nombre de résultats demandé. Si ce champ est omis, FlashData n’ajoute pas de valeur par défaut fixe. Le nombre renvoyé peut varier selon la requête et le type de recherche. Minimum : 1. Maximum : 100. |
| <a id="parameter-params-page"></a> params.page | integer | Non | Non défini | Numéro de la page de résultats demandée. Renseignez-le explicitement. Chaque page nécessite une requête API distincte. Minimum : 1. Maximum : 100. |

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

### Filtres de recherche

| Paramètre | Type | Obligatoire | Par défaut | Description |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-tbs"></a> params.tbs | string | Non | Non défini | Filtres de recherche Google demandés, par exemple qdr:d pour les dernières 24 heures ou qdr:w pour les sept derniers jours. Leur disponibilité dépend du type de recherche. Longueur minimale : 1. Longueur maximale : 200. |
| <a id="parameter-params-autocorrect"></a> params.autocorrect | boolean | Non | Non défini | Utilisez true pour demander la correction orthographique, ou false pour demander sa désactivation. Le comportement dépend du type de recherche ; omettez ce champ pour conserver le comportement de Google.  |

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

## Lire le résultat

Enregistrez la réponse JSON d’une requête réussie dans response.json. Enregistrez le script ci-dessous dans read-response.py, dans le même dossier, puis exécutez python read-response.py. Il utilise uniquement la bibliothèque standard de Python et n’envoie aucune nouvelle requête.

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

## Exemple de réponse

Exemple enregistré ; les champs et les nombres de résultats dépendent de la source et des paramètres de la requête.
```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"
}
```

## Champs de réponse

| Champ | Type | Description |
| --- | --- | --- |
| source | string | Source API demandée. |
| status | string | done lorsque la requête realtime réussit. |
| created_at | string | Date et heure de création de la réponse au format ISO 8601. |
| usage.credits | number | Crédits facturés pour la requête selon votre offre. |
| results[0].searchParameters | object | Paramètres de recherche renvoyés par Google, avec la requête dans le champ q. Ces paramètres peuvent différer des valeurs demandées. |
| results[0].shopping | array | Résultats de recherche de produits. |
| results[0].shopping[].title | string | Titre du produit. |
| results[0].shopping[].link | string | URL de la fiche produit. |
| results[0].shopping[].source | string · optional | Nom du vendeur. |
| results[0].shopping[].price | string · optional | Prix tel qu’il est affiché, avec la mise en forme de la devise. |
| results[0].shopping[].delivery | string · optional | Informations de livraison telles qu’elles sont affichées. |
| results[0].shopping[].rating | number · optional | Note du produit. |
| results[0].shopping[].ratingCount | integer · optional | Nombre d’évaluations. |
| results[0].shopping[].imageUrl | string · optional | URL de l’image du produit. |
| results[0].shopping[].position | integer | Position du résultat. |
| results[0].shopping[].productId | string · optional | Identifiant Google du produit, lorsqu’il est disponible. |

- Les champs disponibles dépendent de la requête et du type de recherche. Les champs facultatifs peuvent être absents, et des champs supplémentaires peuvent être renvoyés.
- Le nombre d’éléments renvoyés et searchParameters.num peuvent différer de params.num. Comptez les éléments du tableau renvoyé pour connaître le nombre réel de résultats.

## Formats de réponse

Les réponses sont en JSON par défaut. Choisissez un autre format avec ces en-têtes facultatifs.

- Accept: application/json (par défaut) ou text/plain. Le texte brut présente les mêmes champs dans une disposition lisible avec indentation.
- X-Respond-With: markdown. Ne définissez pas cet en-tête pour conserver les champs d’origine. Markdown fonctionne avec les deux formats de réponse.

Markdown est disponible pour les requêtes realtime et les résultats de tâches terminées.

Les champs ci-dessous décrivent la réponse JSON par défaut.

[Exemples de formats de requête et de réponse](https://flashdata.dev/fr/docs/guides/response-formats/reference.md#headers)

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

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

## Bases de l’API

Le générateur de requêtes et les exemples ci-dessus utilisent les paramètres de cette source. Consultez les exemples Python et cURL ci-dessous pour les étapes communes de soumission, de suivi et de récupération des résultats. Le corps d’une requête Batch est un objet JSON contenant queries ; chaque élément renvoie son propre identifiant de tâche.

- [Requête Async et reçu de soumission](https://flashdata.dev/fr/docs/reference/realtime-and-async/reference.md#async)

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

- [Vérifier l’état de la tâche](https://flashdata.dev/fr/docs/reference/realtime-and-async/reference.md#status)

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

- [Récupérer les résultats des tâches terminées](https://flashdata.dev/fr/docs/reference/realtime-and-async/reference.md#results)
- [Requêtes JSON Batch](https://flashdata.dev/fr/docs/reference/batch-and-bulk/reference.md#batch)
- [Spécification OpenAPI publique](https://flashdata.dev/docs/openapi.json)

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

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

## Notifications d'achèvement

- [Recevoir et vérifier les webhooks de fin de traitement](https://flashdata.dev/fr/docs/guides/async-batch/reference.md#webhooks)

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

## Dépannage

- [Erreurs et codes d’état](https://flashdata.dev/fr/docs/errors/reference.md#status-codes)
- [Quand réessayer](https://flashdata.dev/fr/docs/errors/reference.md#retries)

## API associées

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