Nouveautés20 oct. 2026Nouveau

Voici Product Lookup

Product Lookup

Product Lookup interroge les moteurs d’achat IA sur votre produit et ceux de vos concurrents, puis renvoie, moteur par moteur, les marchands, les prix et les avis que montre chaque réponse.

Ce que vous obtenez

engines[] : si les réponses de chaque moteur ont montré votre produit (found), et chaque fiche marchand montrée, avec son prix, sa disponibilité, sa note, son nombre d’avis et le catalogue d’origine.
modelSees : le titre, la description, la note et le nombre d’avis reçus par le modèle de ChatGPT qui répond, pour voir votre produit tel que le modèle le lit.
comparison[] : votre produit et jusqu’à cinq concurrents côte à côte sur chaque moteur, avec les fiches, les marchands, la fiche la plus commentée et la fourchette de prix.
prompts[] : jusqu’à trois prompts d’achat, avec les produits de votre recherche que chaque réponse a montrés et nommés.
citedPages et summary.citedDomains : les pages citées par chaque réponse, regroupées par site entre les moteurs.

Fonctionnement

Envoyez un nom de produit et un marché. En US, Product Lookup demande à ChatGPT « Buy … » et « Find the best price for … », et interroge les AI Overviews de Google, Google AI Mode et Bing Copilot sur le nom du produit. En KR, il interroge Naver AI Tab et Google AI Mode sur le nom, et ChatGPT avec « … 구매 » et « … 최저가 ». Chaque concurrent reçoit les mêmes questions, et chaque prompt d’achat est envoyé tel quel à chaque moteur. La recherche ci-dessous, trois produits et deux prompts d’achat, s’est terminée en deux minutes environ.

Il lit les fiches produit de chaque réponse ainsi que les marchands et les prix que ChatGPT écrit dans ses cartes d’achat, et garde celles dont le titre porte le nom du produit. match.score indique la part du nom présente dans une fiche, et les coffrets, formats mini et recharges sont marqués variant. Chaque recherche lit des réponses en direct : le prix, la note et les avis d’une fiche restent stables d’une exécution à l’autre, tandis que l’ensemble des marchands montrés par un moteur change d’une réponse à l’autre ; comparez des recherches répétées pour suivre la tendance.

Cas d’usage

Vérifiez quels moteurs montrent votre produit, avec quels marchands et quels prix.
Comparez vos avis et vos prix à ceux des concurrents sur chaque moteur. Dans la recherche ci-dessous, Bing Copilot affichait 2 942 avis pour belif, contre 85 773 pour Clinique et 117 193 pour CeraVe.
Posez les questions de catégorie des acheteurs et voyez quels produits les réponses mettent en avant. Dans la recherche ci-dessous, CeraVe est apparu dans 5 des 8 réponses, belif dans 2.
Lancez une recherche avant et après une modification de votre flux produits ou de vos fiches, puis comparez ce que montre chaque moteur.

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/product-lookup \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product": "belif Moisturizing Eye Bomb",
    "country": "US",
    "competitors": ["Clinique All About Eyes", "CeraVe Eye Repair Cream"],
    "prompts": [
      "best eye cream for puffiness",
      "best moisturizing eye cream"
    ],
    "idempotencyKey": "eye-bomb-us"
  }'

Champs de la requête

productstringObligatoire: Le nom du produit tel que les acheteurs le cherchent, de 1 à 200 caractères. Une URL de page produit ou un code-barres renvoie VALIDATION_ERROR.
countrystringObligatoire: US ou KR. Le marché fixe les moteurs interrogés et la formulation des questions.
competitorsarray: Jusqu’à 5 noms de produits concurrents. Chacun reçoit les mêmes questions que votre produit.
promptsarray: Jusqu’à 3 prompts d’achat, comme best eye cream for puffiness, envoyés tels quels à chaque moteur.
enginesarray: Moteurs interrogés. Par défaut, CHATGPT, GOOGLE, AIMODE et BING_COPILOT en US, NAVER_AI_TAB, CHATGPT et AIMODE en KR. Ajoutez GEMINI pour interroger aussi Gemini.
idempotencyKeystring: Nomme la recherche. Un nouvel envoi renvoie la même recherche et ajoute seulement les questions manquantes.
webhook.urlstring: Une adresse HTTPS de votre serveur. La tâche de chaque question y est envoyée dès qu’elle se termine.

Réponse

La réponse, raccourcie pour la lecture.

JSON

{
  "success": true,
  "lookup": {
    "id": "eye-bomb-us",
    "product": "belif Moisturizing Eye Bomb",
    "competitors": ["Clinique All About Eyes", "CeraVe Eye Repair Cream"],
    "prompts": [
      "best eye cream for puffiness",
      "best moisturizing eye cream"
    ],
    "country": "US",
    "engines": ["CHATGPT", "GOOGLE", "AIMODE", "BING_COPILOT"]
  },
  "summary": { "total": 23, "succeeded": 23, "failed": 0 },
  "credits": { "creditsToCharge": 40, "creditsCharged": 0 },
  "asks": [
    {
      "engine": "CHATGPT",
      "taskType": "CHATGPT",
      "role": "product",
      "prompt": "Buy belif Moisturizing Eye Bomb",
      "success": true,
      "task": {
        "id": "56be57f3-d316-4727-8bd3-ab065fed2ec1",
        "taskType": "CHATGPT",
        "status": "QUEUED",
        "priority": 1,
        "createdAt": "2026-10-20T09:22:43.422Z",
        "idempotencyKey": "eye-bomb-us:CHATGPT:buy"
      }
    },
    {
      "engine": "GOOGLE",
      "taskType": "GOOGLE",
      "role": "product",
      "query": "belif Moisturizing Eye Bomb",
      "success": true,
      "task": {
        "id": "0d6d6839-8705-44c1-ac3c-c5f56cb25d08",
        "taskType": "GOOGLE",
        "status": "QUEUED",
        "priority": 1,
        "createdAt": "2026-10-20T09:22:43.472Z",
        "idempotencyKey": "eye-bomb-us:GOOGLE:name"
      }
    },
    "…"
  ]
}

lookup.idstring: L’identifiant de la recherche : votre idempotencyKey ou un identifiant créé par le serveur. Lisez-la avec GET /v1/product-lookup/{id}.
summaryobject: Bilan des questions : total, succeeded et failed.
credits.creditsToChargenumber: Ce que coûtent les questions une fois toutes répondues : 10 crédits par produit et 5 par prompt d’achat.
asksarray: Une entrée par question : le moteur, le texte posé et sa task, ou error avec son code si la question a été refusée.

Recevoir le résultat

Chaque question tourne comme une tâche à part, la recherche se remplit donc au fil des réponses. Lisez-la avec GET /v1/product-lookup/{id} jusqu’à ce que lookup.status vaille COMPLETED, ou ajoutez webhook.url pour recevoir la tâche terminée de chaque question. Une recherche reste lisible 24 heures après la fin de ses questions.

curl "https://api.querying.ai/v1/product-lookup/$LOOKUP_ID" \
  -H "Authorization: Bearer $QUERYING_API_KEY"

Voici une recherche terminée, raccourcie pour la lecture.

JSON

{
  "success": true,
  "lookup": {
    "id": "eye-bomb-us",
    "product": "belif Moisturizing Eye Bomb",
    "competitors": ["Clinique All About Eyes", "CeraVe Eye Repair Cream"],
    "prompts": [
      "best eye cream for puffiness",
      "best moisturizing eye cream"
    ],
    "country": "US",
    "status": "COMPLETED",
    "createdAt": "2026-10-20T09:22:43.422Z",
    "completedAt": "2026-10-20T09:24:36.695Z",
    "credits": 40
  },
  "summary": {
    "foundIn": ["CHATGPT", "GOOGLE", "AIMODE", "BING_COPILOT"],
    "notFoundIn": [],
    "merchants": [
      {
        "merchant": "Ulta Beauty",
        "engines": ["CHATGPT", "BING_COPILOT"],
        "price": { "currency": "USD", "min": 48, "max": 48 }
      },
      {
        "merchant": "Amazon",
        "engines": ["CHATGPT"],
        "price": { "currency": "USD", "min": 43, "max": 43 }
      },
      "…"
    ],
    "priceRange": { "currency": "USD", "min": 35.82, "max": 48 },
    "citedDomains": [
      {
        "domain": "ulta.com",
        "engines": ["CHATGPT", "GOOGLE", "AIMODE", "BING_COPILOT"]
      },
      "…"
    ],
    "credits": 10
  },
  "engines": [
    {
      "engine": "CHATGPT",
      "status": "COMPLETED",
      "found": true,
      "via": [
        {
          "taskType": "CHATGPT",
          "prompt": "Buy belif Moisturizing Eye Bomb",
          "taskId": "56be57f3-d316-4727-8bd3-ab065fed2ec1",
          "status": "COMPLETED",
          "credits": 2
        },
        "…"
      ],
      "listings": [
        {
          "ask": 1,
          "position": 1,
          "title": "belif Moisturizing Eye Bomb Eye Cream",
          "merchant": "Ulta Beauty",
          "source": "merchant_feed",
          "price": { "value": 48, "currency": "USD", "raw": "$48.00" },
          "available": true,
          "modelSees": {
            "rating": 4.5,
            "reviewCount": 105,
            "brand": "belif"
          },
          "match": { "score": 1 }
        },
        {
          "ask": 2,
          "position": 1,
          "title": "Amazon",
          "merchant": "Amazon",
          "source": "chatgpt_widget",
          "price": { "value": 43, "currency": "USD", "raw": "$43.00" },
          "match": { "score": 1 }
        },
        "…"
      ],
      "citedPages": [
        {
          "ask": 1,
          "domain": "lgbeauty.com",
          "title": "Moisturizing Eye Bomb"
        },
        "…"
      ]
    },
    "…"
  ],
  "comparison": [
    {
      "product": "belif Moisturizing Eye Bomb",
      "role": "product",
      "engines": [
        {
          "engine": "BING_COPILOT",
          "status": "COMPLETED",
          "found": true,
          "listings": 6,
          "merchants": 5,
          "mostReviewed": {
            "reviewCount": 2942,
            "rating": 4.58,
            "merchant": "Comparor"
          },
          "priceRange": { "currency": "USD", "min": 35.82, "max": 48 },
          "prompts": { "answered": 2, "appeared": 1 }
        },
        "…"
      ]
    },
    {
      "product": "CeraVe Eye Repair Cream",
      "role": "competitor",
      "engines": [
        {
          "engine": "BING_COPILOT",
          "status": "COMPLETED",
          "found": true,
          "listings": 6,
          "merchants": 6,
          "mostReviewed": {
            "reviewCount": 117193,
            "rating": 4.35,
            "merchant": "Pasteur Pharmacy"
          },
          "priceRange": { "currency": "USD", "min": 15.95, "max": 38.95 },
          "prompts": { "answered": 2, "appeared": 0 }
        },
        "…"
      ]
    },
    "…"
  ],
  "prompts": [
    {
      "prompt": "best moisturizing eye cream",
      "engines": [
        {
          "engine": "GOOGLE",
          "status": "COMPLETED",
          "shown": ["CeraVe Eye Repair Cream", "Clinique All About Eyes"],
          "named": [
            "belif Moisturizing Eye Bomb",
            "CeraVe Eye Repair Cream",
            "Clinique All About Eyes"
          ]
        },
        {
          "engine": "BING_COPILOT",
          "status": "COMPLETED",
          "shown": ["belif Moisturizing Eye Bomb"],
          "named": ["belif Moisturizing Eye Bomb"]
        },
        "…"
      ]
    },
    "…"
  ]
}

lookup.statusstring: QUEUED et PROCESSING pendant l’exécution, COMPLETED quand toutes les questions sont terminées et qu’au moins une a répondu, FAILED si toutes ont échoué.
lookup.creditsnumber: Crédits facturés jusqu’ici pour les questions qui ont répondu.
engines[].foundboolean: Indique si les réponses du moteur ont montré le produit : une fiche marchand ou une carte d’achat ChatGPT suffit pour true.
engines[].listingsarray: Chaque fiche marchand montrée pour le produit : merchant, price, available, note et avis, le catalogue d’origine (source) et, sur ChatGPT, ce que le modèle qui répond a reçu (modelSees).
summary.merchantsarray: Chaque marchand qui a montré le produit, avec les moteurs qui l’ont montré et sa fourchette de prix.
comparisonarray: Votre produit et chaque concurrent côte à côte sur chaque moteur : found, listings, merchants, mostReviewed, priceRange et le nombre de réponses aux prompts d’achat où il apparaît.
prompts[].enginesarray: Pour chaque prompt d’achat et chaque moteur, les produits de votre recherche que la réponse a montrés (shown) et nommés dans le texte (named).

Erreurs

VALIDATION_ERRORHTTP 400: Un champ manque ou sort des valeurs admises. details indique le champ.
REGION_UNSUPPORTEDHTTP 422: country désigne un autre marché que US et KR.
RESOURCE_ALREADY_EXISTSHTTP 409: Cet idempotencyKey nomme déjà une recherche portant sur un autre produit, concurrent, prompt ou pays. Envoyez la requête sous une nouvelle clé.
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.
PLAN_CONCURRENCY_LIMITHTTP 429: Les tâches simultanées de votre forfait sont au complet. Les questions qui tiennent entrent, les autres reviennent dans asks[] avec ce code, et renvoyer la même requête après Retry-After secondes les ajoute. Quand aucune ne tient, toute la requête renvoie 429.

Tarif

Chaque produit, le vôtre comme chaque concurrent, coûte 10 crédits et chaque prompt d’achat 5 crédits, quels que soient les moteurs interrogés. Le prix est réparti entre les questions de ce produit, et seules les questions qui répondent sont facturées. La recherche ci-dessus, trois produits et deux prompts d’achat, coûte 40 crédits.

Autres nouveautés

API22 oct. 2026Nouveau
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.
API21 oct. 2026Nouveau
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.

Recevez les mises à jour par e-mail.

Flux RSS