Commerce Product API (COMMERCE_PRODUCT)

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

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.

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

{
  "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 : 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

Premiers pas

Concepts clés

Moteurs de réponse

Recherche et données web

Options de requête

Analyses

Suivi GEO

Compte et données

Commerce Product API (COMMERCE_PRODUCT)

Requête

Paramètres

Exemple de réponse

Champs du résultat

Voir aussi

​Requête

​Paramètres

​Exemple de réponse

​Champs du résultat

​Voir aussi

Requête

Paramètres

Exemple de réponse

Champs du résultat

Voir aussi