> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Shopping API

> Recherchez des produits sur la boutique Google Shopping et lisez ses pages produit en JSON : classement avec prix, notes, nombres d’avis et vendeurs pour la recherche, et prix, disponibilité, vendeur, images et caractéristiques pour chaque page produit.

Recherchez des produits sur la boutique Google Shopping (shopping.google.com) et lisez ses pages produit via l’API de tâches asynchrones. Envoyez `COMMERCE_SERP` avec `site` `google_shopping` pour recevoir les produits qu’affiche une recherche, dans l’ordre de la boutique, ou `COMMERCE_PRODUCT` avec l’`url` d’un produit pour lire ce produit. Une recherche ou une page produit terminée coûte **2 crédits**.

## Recherche

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "COMMERCE_SERP", "payload": { "site": "google_shopping", "query": "wireless earbuds", "limit": 3 } }'
```

Soumettez la tâche, puis interrogez `GET /v1/async/task/{id}` ou recevez son webhook. Voir [Tâches asynchrones](https://docs.querying.ai/fr/concepts/async-tasks.md).

### Paramètres

* `site` : obligatoire. `google_shopping`.
* `query` : obligatoire. Terme de recherche, de 1 à 500 caractères.
* `limit` : entier facultatif de 1 à 40, avec 20 par défaut.
* `country` : facultatif. Par défaut, `US`, le pays de la boutique. Tout autre pays est refusé avec `422 REGION_UNSUPPORTED`.

Seuls les champs de payload listés ci-dessus sont acceptés. Omettez `include` : même `include: {}` renvoie `422 VALIDATION_ERROR` sur `payload.include` avant toute réservation de crédits.

### Exemple de réponse

```json theme={"theme":"css-variables"}
{
  "site": "google_shopping",
  "query": "wireless earbuds",
  "country": "US",
  "returnedCount": 3,
  "products": [
    {
      "rank": 1,
      "productId": "1067219252613399794",
      "title": "JLab Go Air Sport True Wireless Earbuds",
      "url": "https://www.google.com/search?q=wireless+earbuds&udm=28&gl=us&hl=en#product=1067219252613399794&title=JLab+Go+Air+Sport+True+Wireless+Earbuds",
      "price": 9.88,
      "currency": "USD",
      "rating": 4.1,
      "seller": "Walmart"
    },
    {
      "rank": 2,
      "productId": "5295866786049939613",
      "title": "JBL Vibe Beam 2 Noise Cancelling True Wireless Earbuds",
      "url": "https://www.google.com/search?q=wireless+earbuds&udm=28&gl=us&hl=en#product=5295866786049939613&title=JBL+Vibe+Beam+2+Noise+Cancelling+True+Wireless+Earbuds",
      "price": 39.95,
      "currency": "USD",
      "rating": 4.2,
      "seller": "Best Buy",
      "imageUrl": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcTxk4D_LlWLl4n-ponPRc2ihvXVxc8LIg5CGbLCdzmKDbN8zVii50zLQ0tUpH6TwjuCdY2RS3wRw93no9--JdlU6yG_udswoQ"
    },
    {
      "rank": 3,
      "productId": "549048356659243400",
      "title": "Beats Solo Buds True Wireless Earbuds",
      "url": "https://www.google.com/search?q=wireless+earbuds&udm=28&gl=us&hl=en#product=549048356659243400&title=Beats+Solo+Buds+True+Wireless+Earbuds",
      "price": 69.99,
      "currency": "USD",
      "rating": 3.8,
      "seller": "Target",
      "imageUrl": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcSQnGg6ee9gh0KOOWZFMqbmbUGjWa3kZ5V5EBOzJjb6JRM9z6TdPAoGlSi5_f6cPsEXle-oiBJ8EJ-FaREc98Wqt8jC8WzmfQ"
    }
  ]
}
```

### Champs du résultat

* `site`, `query` et `country` reprennent la requête. `returnedCount` est le nombre d’éléments de `products`.
* Chaque produit comporte `rank`, `productId`, `title` et `url`. `productId` est l’identifiant produit de Google, ou l’identifiant de l’offre pour une annonce que Google n’a pas regroupée en produit. `rank` suit l’ordre par défaut de la boutique, et les annonces que la boutique marque comme sponsorisées sont exclues.
* `price`, `rating`, `reviewCount`, `imageUrl` et `seller` apparaissent quand la page de résultats les affiche. `price` est un nombre dans la `currency` du produit (ISO 4217) ; quand les formats ont des prix différents, c’est le plus bas.
* `rating` utilise une échelle de cinq points. Les nombres d’avis abrégés, comme 999+, sont omis. `reviewCount` n’apparaît que lorsque Google affiche le nombre exact (moins de 1 000).
* Chaque recherche renvoie les produits de la première page de résultats de la boutique.
* La page de Google ne renvoie vers aucune page produit ni marchand, donc `url` est la page de résultats Google Shopping où le produit a été classé, terminée par `#product={productId}&title={title}`. Passez cette `url` à `COMMERCE_PRODUCT` pour lire les boutiques, les caractéristiques et la description du produit. `seller` est la boutique que Google affiche en premier.

## Page produit

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "COMMERCE_PRODUCT", "payload": { "url": "https://www.google.com/search?q=wireless+earbuds&udm=28&gl=us&hl=en#product=5295866786049939613&title=JBL+Vibe+Beam+2+Noise+Cancelling+True+Wireless+Earbuds" } }'
```

### Paramètres

* `url` : obligatoire. L’`url` d’un produit renvoyée par une recherche Google Shopping, de 2 048 caractères au plus : `google.com/search?q={query}&udm=28&gl={market}#product={productId}&title={title}`. Le `productDetailUrl` d’un produit des résultats [Google Search](https://docs.querying.ai/fr/engines/google-serp.md), [Google AI Overviews](https://docs.querying.ai/fr/engines/google-ai-overviews.md) et [Google AI Mode](https://docs.querying.ai/fr/engines/google-ai-mode.md) fonctionne aussi tel quel.
* `country` : facultatif. Par défaut, le `gl` de l’`url`, parmi `US`, `GB`, `AU`, `CA`, `KR`, `JP`, `TW`, `HK`, `DE`, `FR`, `ES`, `IT`, `PL`, `PT`, `BR`, `IN`, `ID`, `TH` et `VN`. Tout autre pays est refusé avec `422 REGION_UNSUPPORTED`.

Seuls les champs de payload listés ci-dessus sont acceptés. Omettez `include` : même `include: {}` renvoie `422 VALIDATION_ERROR` sur `payload.include` avant toute réservation de crédits.

### Exemple de réponse

```json theme={"theme":"css-variables"}
{
  "site": "google_shopping",
  "country": "US",
  "url": "https://www.google.com/search?q=wireless+earbuds&udm=28&gl=us&hl=en#product=5295866786049939613&title=JBL+Vibe+Beam+2+Noise+Cancelling+True+Wireless+Earbuds",
  "productId": "5295866786049939613",
  "title": "JBL Vibe Beam 2 Noise Cancelling True Wireless Earbuds",
  "brand": "JBL",
  "price": 39.95,
  "listPrice": 65,
  "currency": "USD",
  "inStock": true,
  "seller": "Scheels",
  "rating": 4.2,
  "images": [
    "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcTxk4D_LlWLl4n-ponPRc2ihvXVxc8LIg5CGbLCdzmKDbN8zVii50zLQ0tUpH6TwjuCdY2RS3wRw93no9--JdlU6yG_udswoQ",
    "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcQ64EZlooEjcI4GdHBULPySzyZvLSCxjsMi8raMFjbWdZv_KK0cL6P2pIc7nts3uk7G0_XBWBBhVjcuz92sCo2lcDw4hW2H"
  ],
  "description": "The JBL Vibe Beam 2 is a true wireless in-ear earbud system designed to deliver strong audio performance, effective noise control, and seamless everyday usability. Equipped with Bluetooth 5.3, it…",
  "specs": [
    { "name": "Brand", "value": "JBL" },
    { "name": "Noise Canceling", "value": "Yes" },
    { "name": "With Microphone", "value": "Yes" }
  ],
  "offers": [
    {
      "price": 39.95,
      "title": "JBL Vibe Beam 2 headphones",
      "seller": "Scheels",
      "inStock": true,
      "currency": "USD",
      "listPrice": 65
    },
    {
      "url": "https://www.walmart.com/ip/JBL-Vibe-Beam-2-True-Wireless-Noise-Cancelling-In-Ear-Earbuds-Black/21106652379?wmlspartner=wlpa&selectedSellerId=609&veh=seo_fpl&cn=google",
      "price": 39.77,
      "title": "Jbl Vibe Beam 2 True Wireless Noise Cancelling In-Ear Earbuds, Black",
      "seller": "Walmart - Electronics Expo (Authorized Dealer)",
      "inStock": true,
      "currency": "USD"
    }
  ]
}
```

### Champs du résultat

* `site`, `country`, `url` et `productId` identifient la page. `url` est la page lue, et `productId` correspond à celui que renvoie une recherche.
* `title` est toujours présent. `brand`, `price`, `listPrice`, `currency`, `inStock`, `seller`, `rating`, `reviewCount`, `images`, `description`, `specs` et `offers` apparaissent quand la page les affiche.
* `price` est ce que paie un acheteur tel que la page l’affiche à l’ouverture, avant coupons et livraison, en `currency` (ISO 4217). `listPrice` est le prix habituel que la page barre, présent quand il dépasse `price`. `inStock` indique la disponibilité du produit. `seller` est le marchand qui le vend.
* `rating` utilise une échelle de cinq points avec deux décimales. `reviewCount` est le nombre d’avis. `reviewCount` n’apparaît que lorsque Google affiche le nombre exact (moins de 1 000).
* `images` liste jusqu’à 30 photos de la galerie du produit, dans l’ordre de la page.
* `description` est du texte brut avec une ligne par paragraphe, jusqu’à 10 000 caractères ; le texte qui n’apparaît que dans des images n’est pas inclus.
* `specs` liste jusqu’à 100 paires `{ name, value }` des caractéristiques du produit.
* La lecture relance la requête de l’`url` sur Google Shopping dans son marché, ou le titre du produit quand Google ne l’affiche plus pour cette requête, puis ouvre le panneau du produit ; elle prend donc plus de temps qu’une page de boutique. Si Google n’affiche le produit dans aucun des deux cas, la tâche se termine par `PAGE_UNAVAILABLE`.
* `offers` liste les boutiques que Google affiche pour le produit, en commençant par celle que Google marque comme le meilleur prix, chacune avec `seller`, `title` (le nom du produit dans la boutique), `url` (la page produit de la boutique, quand Google la lie), `price`, `listPrice`, `currency` et `inStock`. `price`, `listPrice`, `seller` et `inStock` du produit sont ceux de la première boutique. Les prix sont dans la devise de l’onglet Shopping du marché (ISO 4217), quelle que soit la langue des libellés.
* Un `productDetailUrl` d’un produit Google AI Overviews ou AI Mode recherche le titre du produit, et le résultat renvoie le `productDocid` de ce produit.

## Erreurs et facturation

* Une recherche qui ne renvoie aucun produit se termine par une tâche en échec.
* Seules les tâches terminées sont facturées : 2 crédits par recherche ou page produit.

## Voir aussi

* [Google Search](https://docs.querying.ai/fr/engines/google-serp.md)
* [Google AI Overviews](https://docs.querying.ai/fr/engines/google-ai-overviews.md)
* [Google AI Mode](https://docs.querying.ai/fr/engines/google-ai-mode.md)
* [Toutes les boutiques Commerce](https://docs.querying.ai/fr/engines/overview.md#commerce)
* [Crédits et limites](https://docs.querying.ai/fr/concepts/credits-and-limits.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.