Découvrez Commerce Product

Passez l’URL d’une page produit d’Amazon, Walmart, Sephora, Olive Young, Rakuten, Zalando ou de 11 autres boutiques, et recevez son prix, son stock, ses images de galerie et de description, ses caractéristiques et ses options dans le même format.

Ce que vous obtenez

• COMMERCE_PRODUCT : chaque tâche lit une page produit parmi 17 boutiques aux États-Unis, en Corée, au Japon, en Inde et en Allemagne. Passez l’url de la page : elle désigne la boutique.
• title, brand, price et listPrice avec leur currency, inStock, seller, rating et reviewCount, tels que la page les affiche.
• images : la galerie du produit. descriptionImages : les 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.
• description, specs, options, categories et gtin, dans les mêmes champs sur toutes les boutiques.

Boutiques

• États-Unis (US) : Amazon amazon, Walmart walmart, Target target, Sephora sephora, Ulta ulta
• Corée (KR) : Olive Young oliveyoung, 11st 11st, Lotte ON lotteon, Musinsa musinsa, Kurly kurly
• Japon (JP) : Rakuten rakuten, Yahoo! Shopping yahoo_shopping, Qoo10 qoo10
• Inde (IN) : Flipkart flipkart, Myntra myntra, Nykaa nykaa
• Allemagne (DE) : Zalando zalando

Fonctionnement

Chaque tâche lit la page produit depuis le pays de la boutique et renvoie les valeurs du choix sur lequel la page s’ouvre. price est ce que l’acheteur paie avant coupons et livraison, et options liste les autres tailles, couleurs ou coffrets.

images réunit jusqu’à 30 photos de la galerie et descriptionImages jusqu’à 300 images de la description, dans l’ordre de la page. Les images de description viennent d’Amazon, Ulta, Olive Young, 11st, Lotte ON, Musinsa, Kurly, Rakuten, Yahoo! Shopping et Qoo10. Les bannières et avis que le vendeur y place arrivent avec elles, et le texte d’une image reste dans l’image.

title, price, currency et images viennent de toutes les boutiques ; les autres champs arrivent quand la page les affiche, et la documentation du moteur indique quelles boutiques renvoient chacun. Quand la boutique répond par une page retirée, comme un produit déréférencé, la tâche se termine par PAGE_UNAVAILABLE.

Cas d’usage

• Lisez en détail les premiers produits d’une Commerce Search : prix, stock, vendeur et toutes les options.
• Suivez chaque jour le prix, le prix de référence et le stock de votre page produit sur Amazon, Olive Young et Rakuten.
• Rassemblez la galerie et les images de détail des concurrents pour comparer comment chaque marque présente le même produit.
• Versez caractéristiques, options et images de description dans votre catalogue ou dans un audit des réponses d’achat des IA.

Envoyer la requête

Envoyez la requête avec votre clé API dans l’en-tête Authorization.

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" }
  }'

Champs de la requête

taskTypestringObligatoire

Le moteur à interroger, par exemple CHATGPT ou GOOGLE.

payload.urlstringObligatoire

Une page produit de l’une des 17 boutiques, jusqu’à 2 048 caractères. L’URL fixe la boutique et son pays.

payload.countrystring

Le pays de la boutique, par exemple US pour Amazon ou KR pour Olive Young. C’est aussi la valeur par défaut.

webhook.urlstring

Une adresse HTTPS de votre serveur. La tâche terminée y est envoyée dès qu’elle se termine.

Réponse

Voici une tâche terminée, raccourcie pour la lecture.

{
  "success": true,
  "task": {
    "id": "3f0f65f4-bb08-492b-8652-7037fe7cba0d",
    "taskType": "COMMERCE_PRODUCT",
    "status": "COMPLETED",
    "createdAt": "2026-10-22T09:27:29.765Z"
  },
  "credits": { "creditsToCharge": 3, "creditsCharged": 3 },
  "response": {
    "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": 18.39,
    "currency": "USD",
    "inStock": true,
    "seller": "Amazon.com",
    "rating": 4.7,
    "reviewCount": 149176,
    "images": [
      "https://m.media-amazon.com/images/I/61EidjXUBrL._SL1000_.jpg",
      "https://m.media-amazon.com/images/I/61-Ut3jOyyL._SL1500_.jpg",
      "…"
    ],
    "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": "Brand Name", "value": "CeraVe" },
      { "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", "…"]
  }
}

task.statusstring

QUEUED, PROCESSING, puis COMPLETED avec la réponse ou FAILED avec error.

credits.creditsChargedinteger

Crédits facturés pour la tâche terminée. Une tâche en échec facture 0.

response.pricenumber

Ce que l’acheteur paie pour le produit tel que la page l’affiche d’abord, avant coupons et livraison, en currency (ISO 4217). listPrice est le prix habituel barré quand il dépasse price.

response.imagesarray

Jusqu’à 30 photos de la galerie du produit, dans l’ordre de la page.

response.descriptionImagesarray

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.

response.specsarray

Jusqu’à 100 paires { name, value } issues des détails du produit. options liste les choix comme la taille ou la couleur, chacun avec ses values.

Recevoir le résultat

La requête renvoie aussitôt la tâche avec status QUEUED. Interrogez GET /v1/async/task/{id} jusqu’à ce que status vaille COMPLETED ou FAILED, ou ajoutez webhook.url pour recevoir la tâche terminée sur votre serveur, avec les mêmes task, credits et response. Les résultats restent disponibles 24 heures après la fin de la tâche.

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

Erreurs

VALIDATION_ERRORHTTP 422

url est absent, dépasse 2 048 caractères ou sort des pages produit des 17 boutiques, ou le payload contient un champ autre que url et country. details indique le champ.

REGION_UNSUPPORTEDHTTP 422

country diffère du pays de la boutique, par exemple KR avec une URL Amazon.

MISSING_API_KEYHTTP 401

L’en-tête Authorization manque, ou sa clé est inconnue, expirée ou révoquée.

INSUFFICIENT_CREDITSHTTP 402

Le solde est inférieur au prix de la tâche. Ajoutez des crédits ou changez de plan, puis renvoyez-la.

Tarif

Chaque lecture terminée utilise 3 crédits, sur toutes les boutiques. Les crédits sont débités à la fin de la tâche.