API Product Lookup : votre produit dans les réponses d’achat de l’IA

Interrogez ChatGPT, Google AI Overviews, AI Mode, Copilot et Naver AI Tab sur un produit : quels moteurs l’affichent, chez quels marchands et à quel prix, quelles pages chaque réponse cite, et comment il se situe face à vos concurrents.

01

Quels moteurs affichent votre produit

Envoyez un nom de produit et un pays, US ou KR. Pour chaque moteur, found indique si la réponse a affiché le produit, et otherListings regroupe les autres produits affichés. summary.foundIn et summary.notFoundIn répartissent les moteurs en deux listes.

02

Marchands, prix et avis

Chaque fiche affichée dans une réponse indique son marchand, son prix et son catalogue d’origine, avec le stock, la note, le nombre d’avis et les identifiants de catalogue quand le moteur les fournit. Sur ChatGPT, modelSees contient ce que son modèle de réponse a reçu sur le produit, et les fiches chatgpt_widget reprennent les marchands et les prix que ChatGPT a écrits dans ses cartes de widget.

03

Les pages derrière chaque réponse

citedPages liste les pages que cite chaque réponse. summary.citedDomains les regroupe par site avec les moteurs qui les ont citées, et summary.merchants liste chaque marchand avec les moteurs qui l’ont affiché et sa fourchette de prix.

Votre produit face à vos concurrents

Ajoutez jusqu’à cinq produits concurrents. Chacun reçoit les mêmes questions que le vôtre, et comparison[] les aligne moteur par moteur.

  • found : quels moteurs ont affiché chaque produit.
  • listings et merchants : combien de fiches chaque produit a obtenues, et chez combien de marchands.
  • mostReviewed et priceRange : la fiche qui compte le plus d’avis, et la fourchette de prix affichée par chaque moteur.
  • prompts : combien de prompts d’achat chaque moteur a traités, et combien de ces réponses ont affiché ou nommé le produit.

Ce que demandent les acheteurs

Ajoutez jusqu’à trois prompts d’achat, comme « best eye cream for puffiness ». Chaque moteur répond à chaque prompt tel quel, et prompts[] indique les produits que la réponse a affichés en fiches (shown) et ceux que son texte nomme (named).

Moteurs et questions par marché

Chaque marché interroge les moteurs qui y affichent des fiches produit. engines vous permet de choisir les vôtres.

  • US : ChatGPT reçoit « Buy {produit} » et « Find the best price for {produit} », et Google AI Overviews, AI Mode et Copilot le nom du produit.
  • KR : Naver AI Tab et AI Mode reçoivent le nom du produit, et ChatGPT « {produit} 구매 » et « {produit} 최저가 ».
  • Gemini s’ajoute quand engines le cite. En KR, Google AI Overviews et Copilot aussi.
Étape 1

Envoyer à POST /v1/product-lookup

Envoyez votre produit avec jusqu’à cinq concurrents et trois prompts d’achat. Cette consultation interroge quatre moteurs sur trois produits et deux prompts d’achat : 23 questions pour 40 crédits. idempotencyKey devient l’identifiant de la consultation.

cURL
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"
}'
Étape 2

Chaque question est une tâche

La réponse liste chaque question avec sa tâche, et credits.creditsToCharge additionne leur prix. Les questions s’exécutent, se facturent et envoient leurs webhooks comme toute tâche. Renvoyer le même identifiant renvoie les questions existantes et ajoute uniquement celles qui manquent.

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-…",
        "taskType": "CHATGPT",
        "status": "QUEUED",
        "priority": 1,
        "createdAt": "2026-10-20T09:22:43.422Z",
        "idempotencyKey": "eye-bomb-us:CHATGPT:buy"
      }
    },
    "…"
  ]
}
Étape 3

La lire avec GET /v1/product-lookup/:id

Interrogez l’identifiant jusqu’à ce que lookup.status vaille COMPLETED, ou lisez la consultation à chaque webhook d’une question. Lisez et enregistrez le résultat dans les 24 heures qui suivent la fin de ses questions.

cURL
curl https://api.querying.ai/v1/product-lookup/eye-bomb-us \
  -H "Authorization: Bearer $QUERYING_API_KEY"

Coût

Un produit coûte 10 crédits et un prompt d’achat 5, quels que soient les moteurs interrogés. Votre produit et chaque concurrent comptent comme des produits : la consultation ci-dessus coûte 40 crédits. Le prix d’un produit se répartit entre ses questions, une question en échec rend ses crédits à votre solde, et un renvoi facture uniquement les questions qu’il ajoute.

Voir les tarifs →
Coût par produit selon le forfait
Forfait1 000 produits
Basic≈ $25.00
Max≈ $10.00

Tarifs effectifs en supposant que tous les crédits mensuels inclus sont utilisés.

Mesuré sur 50 produits

Le 2026-10-20, nous avons consulté 50 produits via l’API de production, 25 aux États-Unis et 25 en Corée.

  • US : Copilot a affiché les 25 produits, Google AI Overviews et AI Mode 23 sur 25.
  • KR : Naver AI Tab a affiché les 25 produits, AI Mode 13 sur 25.
  • ChatGPT, avec les deux questions et ses cartes de widget, a affiché le produit lors des 24 exécutions aux États-Unis et des 20 en Corée.
  • D’une exécution à l’autre, une même fiche marchand a gardé son prix, sa note et son nombre d’avis pour 307 valeurs sur 316. Les fiches affichées changent à chaque exécution : lisez les tendances sur plusieurs consultations.

Fonctionnalités associées

Commencez avec 500 crédits offerts

Lancez votre première tâche dans le Playground, ou appelez l'API avec votre clé.