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

# Commerce Product API (COMMERCE_PRODUCT)

> Lisez une page produit d'Amazon, Walmart, Target, Sephora, Ulta, Olive Young, 11st, Musinsa, Kurly, Rakuten, Flipkart, Zalando et d'autres boutiques, et obtenez son prix, son stock, son vendeur, sa note, ses images, ses caractéristiques et ses options dans un même format.

Lisez la page produit d'une boutique et recevez le produit en JSON via l'API de tâches asynchrones. Passez l'`url` de la page ; l'URL désigne la boutique, et toutes les boutiques renvoient les mêmes champs. Une lecture terminée coûte **3 crédits**.

## Requête

```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.amazon.com/dp/B00TTD9BRC" } }'
```

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

## Paramètres

* `url` : obligatoire. Une page produit de l'une des boutiques ci-dessous, de 2 048 caractères au plus. Les `url` de produit renvoyées par [Commerce Search](/fr/engines/commerce-serp.md) pour ces boutiques s'utilisent telles quelles, sauf les pages LOHACO de Yahoo! Shopping (`lohaco.yahoo.co.jp`). Les paramètres sans effet sur le résultat, comme les codes de suivi, sont retirés avant la lecture.
* `country` : facultatif. Par défaut, le pays de la boutique. Tout autre pays est refusé avec `422 REGION_UNSUPPORTED`.

| `site` | Page produit | `country` |
| - | - | - |
| `amazon` | `amazon.com/dp/{ASIN}` | `US` |
| `walmart` | `walmart.com/ip/{name}/{id}` | `US` |
| `target` | `target.com/p/{name}/-/A-{TCIN}` | `US` |
| `sephora` | `sephora.com/product/{name}-P{id}` | `US` |
| `ulta` | `ulta.com/p/{name}-{id}` | `US` |
| `11st` | `11st.co.kr/products/{id}` | `KR` |
| `lotteon` | `lotteon.com/p/product/{id}` | `KR` |
| `musinsa` | `musinsa.com/products/{id}` | `KR` |
| `kurly` | `kurly.com/goods/{id}` | `KR` |
| `oliveyoung` | `oliveyoung.co.kr/store/goods/getGoodsDetail.do?goodsNo={id}` | `KR` |
| `rakuten` | `item.rakuten.co.jp/{shop}/{item}/` | `JP` |
| `yahoo_shopping` | `store.shopping.yahoo.co.jp/{store}/{item}.html` | `JP` |
| `qoo10` | `qoo10.jp/g/{id}` | `JP` |
| `flipkart` | `flipkart.com/{name}/p/{itm}?pid={pid}` | `IN` |
| `myntra` | `myntra.com/{category}/{brand}/{name}/{id}/buy` | `IN` |
| `nykaa` | `nykaa.com/{name}/p/{id}` | `IN` |
| `zalando` | `zalando.de/{name}-{sku}.html` | `DE` |
| `google_shopping` | `google.com/search?q={query}&udm=28#product={productId}&title={title}` | `US` |

Les autres adresses de la même page fonctionnent aussi, comme `/gp/product/{ASIN}` chez Amazon ou les pages mobiles de 11st.

## Exemple de réponse

```json theme={"theme":"css-variables"}
{
  "site": "amazon",
  "country": "US",
  "url": "https://www.amazon.com/dp/B00TTD9BRC",
  "productId": "B00TTD9BRC",
  "title": "CeraVe Moisturizing Cream, Face & Body Moisturizer for Dry Skin, 19oz",
  "brand": "CeraVe",
  "price": 16.77,
  "listPrice": 18.96,
  "currency": "USD",
  "inStock": true,
  "seller": "Amazon.com",
  "rating": 4.7,
  "reviewCount": 149149,
  "images": ["https://m.media-amazon.com/images/I/61EidjXUBrL._SL1000_.jpg"],
  "description": "[ HYALURONIC ACID MOISTURIZER ] With hyaluronic acid, ceramides and MVE technology for 24 hour hydration.",
  "descriptionImages": ["https://m.media-amazon.com/images/S/aplus-media-library-service-media/8c56d081-e316-4b57-9731-fcf4eda0821f.__CR0,0,1464,600_PT0_SX1464_V1___.jpg"],
  "specs": [
    { "name": "Item Form", "value": "Cream" },
    { "name": "Skin Type", "value": "All, Dry, Sensitive" }
  ],
  "options": [{ "name": "Size", "values": ["8 Ounce", "16 Ounce (Pack of 1)", "19 Ounce (Pack of 1)"] }],
  "categories": ["Beauty & Personal Care", "Skin Care", "Face", "Creams & Moisturizers", "Face Moisturizers"]
}
```

## Champs du résultat

* `site`, `country`, `url` et `productId` identifient la page. `url` est la page lue. `productId` est l'identifiant produit propre à la boutique, comme l'ASIN chez Amazon ou `shop:item` chez Rakuten, et correspond à celui renvoyé par Commerce Search. Exception : pour un produit Nykaa décliné en teintes ou en tailles, Commerce Search renvoie l'identifiant d'une déclinaison et cette lecture celui de la page produit.
* `title` est toujours présent. Les autres champs apparaissent quand la page les affiche ; le tableau ci-dessous indique les boutiques qui renvoient chacun d'eux.
* `price` est ce que paie un acheteur pour le produit tel que la page l'affiche à l'ouverture, avant coupons et livraison, dans la devise `currency` (ISO 4217). `listPrice` est le prix habituel que la page barre, présent quand il dépasse `price`. `inStock` indique si ce produit est en stock, et `seller` est son vendeur.
* `rating` utilise une échelle sur cinq avec deux décimales. `reviewCount` est le nombre d'avis.
* `images` liste jusqu'à 30 photos de la galerie du produit, dans l'ordre de la page. 11st et Lotte ON ne renvoient que la photo principale, Sephora jusqu'à deux, et chez Rakuten et Yahoo! Shopping, les bannières ou avis que le vendeur place dans cette galerie sont aussi renvoyés. `description` est un texte brut avec une ligne par paragraphe, de 10 000 caractères au plus ; le texte présent uniquement dans des images n'y figure pas.
* `descriptionImages` liste jusqu'à 300 images de la description du produit, comme la page de détail du vendeur ou le contenu A+ d'Amazon, dans l'ordre de la page. Les bannières et avis que le vendeur place dans sa description sont aussi renvoyés, et le texte présent dans les images n'est pas lu.
* `specs` liste jusqu'à 100 paires `{ name, value }` issues des détails du produit. `options` liste jusqu'à 20 choix, comme la taille ou la couleur, chacun avec jusqu'à 100 `values` ; les autres champs décrivent le choix sur lequel la page s'ouvre. `categories` va de la catégorie la plus large à la plus précise, sur 10 niveaux au plus. `gtin` est l'UPC, l'EAN ou le JAN indiqué sur la page.
* `google_shopping` lit un produit renvoyé par [Commerce Search](/fr/engines/commerce-serp.md) : son `url` contient la requête, l’identifiant produit de Google et le titre du produit. La lecture relance cette requête sur Google Shopping, ou le titre si Google n’affiche plus le produit pour la requête, et ouvre le panneau du produit, elle prend donc plus de temps qu’une page de boutique. `offers` liste les boutiques que Google affiche pour le produit, en commençant par celle que Google signale comme meilleur prix, chacune avec `seller`, `title` (le nom du produit chez la boutique), `url` (la page produit de la boutique), `price`, `listPrice`, `currency` et `inStock`. Les `price`, `listPrice`, `seller` et `inStock` du produit sont ceux de la première boutique. `reviewCount` n’apparaît que lorsque Google affiche le nombre exact (moins de 1 000). Si Google n’affiche le produit pour aucune des deux recherches, la tâche se termine par `PAGE_UNAVAILABLE`.
* Une page à laquelle la boutique répond 404 ou 410, comme un produit retiré, termine la tâche avec `PAGE_UNAVAILABLE`, et le message reprend la réponse de la boutique. Les autres lectures échouées se terminent par `ENGINE_NO_RESULT`. La facturation s'applique à chaque lecture terminée.

| Champ | Boutiques qui le renvoient |
| - | - |
| `title`, `price`, `currency`, `images` | Toutes |
| `brand` | Toutes sauf Rakuten |
| `inStock` | Toutes sauf Target et Sephora |
| `rating` | Toutes sauf Lotte ON, Kurly et Zalando |
| `reviewCount` | Toutes sauf Lotte ON et Zalando |
| `categories` | Toutes sauf Sephora, Qoo10, Flipkart et Google Shopping |
| `description` | Toutes sauf 11st et Qoo10. Lotte ON, Musinsa et Olive Young présentent l'essentiel de la description en images, si bien que peu de leurs pages en ont une. Flipkart et Zalando renvoient le court résumé qu'ils publient pour les moteurs de recherche. |
| `descriptionImages` | Amazon, Ulta, 11st, Lotte ON, Musinsa, Kurly, Olive Young, Rakuten, Yahoo! Shopping et Qoo10 |
| `specs` | Amazon, Walmart, Target, Ulta, Lotte ON, Musinsa, Kurly, Myntra, Nykaa et Google Shopping |
| `options` | Amazon, Walmart, Ulta, Musinsa, Kurly, Olive Young, Rakuten, Myntra, Nykaa et Zalando |
| `seller` | Amazon, Walmart, Lotte ON, Kurly, Rakuten, Myntra, Nykaa et Google Shopping |
| `listPrice` | Amazon, Walmart, Target, Sephora, Musinsa, Kurly, Olive Young, Qoo10, Myntra, Nykaa et Google Shopping |
| `offers` | Google Shopping |
| `gtin` | Amazon, Walmart, Target, Ulta, Olive Young, Rakuten et Yahoo! Shopping |

## Voir aussi

* [Commerce Search](/fr/engines/commerce-serp.md)
* [Vue d’ensemble des moteurs](/fr/engines/overview.md)
* [Crédits et limites](/fr/concepts/credits-and-limits.md)


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