La recherche de produits sur 20 boutiques en ligne est désormais prise en charge

Interrogez Amazon, Walmart, Coupang, Olive Young, Rakuten, Flipkart, Zalando et 13 autres boutiques dans cinq pays, et recevez le classement des produits de chacune avec prix, notes et nombre d’avis dans le même format.

Ce que vous obtenez

• COMMERCE_SERP : chaque tâche interroge une boutique, choisie avec payload.site, parmi 20 boutiques aux États-Unis, en Corée, au Japon, en Inde et en Allemagne.
• products : le classement de la boutique pour votre recherche, jusqu’à 40 produits, chacun avec rank, productId, title et url.
• price sous forme de nombre avec sa currency, ainsi que rating, reviewCount, brand et imageUrl dès que la page de résultats les affiche.
• Les mêmes champs produit sur toutes les boutiques : un seul parseur lit Amazon, Coupang, Rakuten et Zalando de la même façon.

Boutiques

• États-Unis (US) : Amazon amazon, Walmart walmart, Target target, eBay ebay, AliExpress aliexpress, Sephora sephora, Ulta ulta
• Corée (KR) : Coupang coupang, 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 première page de résultats que la boutique affiche pour votre recherche dans son propre pays et renvoie les produits dans l’ordre par défaut de la boutique. Sur toutes les boutiques sauf Coupang, les annonces sponsorisées sont écartées et rank compte les autres dans l’ordre de la page.

productId est l’identifiant propre à la boutique : l’ASIN sur Amazon, le numéro d’article sur eBay, shop:item sur Rakuten. price est un nombre dans la currency du produit (ISO 4217), et le prix le plus bas quand chaque format a son prix. rating suit une échelle de cinq points sur les boutiques qui affichent des notes ; Kurly et Zalando présentent les produits avec leur prix et leur titre.

Quand une boutique renvoie une recherche vers une autre page, les produits viennent de cette page : Ulta envoie certains noms de marque vers la page de la marque, Target envoie certaines recherches vers une recherche proche et Nykaa affiche la page de catégorie pour les recherches qui nomment une catégorie. Une recherche qui ne trouve aucun produit se termine en tâche échouée.

Cas d’usage

• Suivez jour après jour la position de votre produit sur la recherche de sa catégorie chez Amazon, Walmart et Target.
• Comparez votre prix, votre note et votre nombre d’avis avec les produits classés autour de vous.
• Suivez une gamme beauté ou mode sur Olive Young, Rakuten, Nykaa et Zalando avec le même format de requête.
• Placez le classement de la boutique à côté des réponses de ChatGPT ou de Google AI Mode pour la même recherche et voyez quels produits l’acheteur rencontre à chaque endroit.

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_SERP",
    "payload": { "site": "target", "query": "sunscreen", "limit": 10 }
  }'

Champs de la requête

taskTypestringObligatoire

Le moteur à interroger, par exemple CHATGPT ou GOOGLE.

payload.sitestringObligatoire

La boutique à interroger, par exemple amazon, coupang ou rakuten. Les 20 valeurs figurent avec le moteur.

payload.querystringObligatoire

La recherche, rédigée comme un acheteur la tape dans le champ de recherche de la boutique. De 1 à 500 caractères.

payload.countrystring

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

payload.limitinteger

Nombre de produits renvoyés, de 1 à 40. 20 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": "fa04f93f-babe-4d50-9549-8b7100261fee",
    "taskType": "COMMERCE_SERP",
    "status": "COMPLETED",
    "createdAt": "2026-10-22T00:05:55.416Z"
  },
  "credits": { "creditsToCharge": 3, "creditsCharged": 3 },
  "response": {
    "site": "target",
    "query": "sunscreen",
    "country": "US",
    "returnedCount": 10,
    "products": [
      {
        "rank": 1,
        "productId": "76545827",
        "title": "La Roche Posay Anthelios Melt in Milk Sunscreen Lotion - SPF 100 - 3.0 fl oz",
        "brand": "La Roche Posay",
        "url": "https://www.target.com/p/la-roche-posay-anthelios-melt-in-milk-sunscreen-lotion-spf-100-3-0-fl-oz/-/A-76545827",
        "price": 20.99,
        "currency": "USD",
        "rating": 4.54,
        "reviewCount": 995
      },
      {
        "rank": 2,
        "productId": "80839020",
        "title": "Neutrogena Beach Defense Sunscreen Lotion - SPF 70 - 1 fl oz",
        "brand": "Neutrogena",
        "url": "https://www.target.com/p/neutrogena-beach-defense-sunscreen-lotion-spf-70-1-fl-oz/-/A-80839020",
        "price": 1.99,
        "currency": "USD",
        "rating": 4.59,
        "reviewCount": 1580
      },
      "…"
    ]
  }
}

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

Le nombre de produits dans products.

response.productsarray

Les produits dans l’ordre de la boutique : rank, productId, title et url, ainsi que price, currency, rating, reviewCount, imageUrl et brand quand la page de résultats les affiche.

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

site est hors des 20 boutiques, query est vide ou dépasse 500 caractères, limit sort de 1 à 40, ou le payload contient un autre champ. details indique le champ.

REGION_UNSUPPORTEDHTTP 422

country diffère du pays de la boutique, par exemple KR avec 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 recherche terminée utilise 3 crédits, sur toutes les boutiques. Les crédits sont débités à la fin de la tâche.