> ## Documentation Index > Fetch the complete documentation index at: https://docs.querying.ai/llms.txt > Use this file to discover all available pages before exploring further. # Obtener un Product Lookup > Lee un Product Lookup motor por motor: ofertas de comercios, páginas citadas, la comparación con la competencia y los prompts de compra. ## OpenAPI ````yaml GET /v1/product-lookup/{id} openapi: 3.1.0 info: title: querying.ai description: >- One API for every AI answer engine. Every task is asynchronous: submit, then collect the result via webhook or polling. version: 1.0.0 servers: - url: https://api.querying.ai description: Production security: - bearerAuth: [] paths: /v1/product-lookup/{id}: get: tags: - Research summary: Get a product lookup description: >- Reads a lookup back from its asks' tasks: for the product and each competitor, whether each engine's answers showed it, the merchant listings they showed and the pages they cite; the products side by side engine by engine; and what each engine answered each shopper prompt. Entries fill in as asks finish. Readable while the asks' tasks are, until 24 hours after they complete. operationId: getProductLookup parameters: - name: id in: path required: true schema: type: string minLength: 1 maxLength: 200 description: >- The lookup's id: the idempotencyKey you sent, or lookup.id from the POST response. responses: '200': description: The lookup, read from its asks so far. content: application/json: schema: $ref: '#/components/schemas/ProductLookupResponse' example: 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: [] pending: [] failed: [] 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 - merchant: Comparor engines: - BING_COPILOT price: currency: USD min: 35.82 max: 45.9 priceRange: currency: USD min: 35.82 max: 48 citedDomains: - domain: ulta.com engines: - CHATGPT - GOOGLE - AIMODE - BING_COPILOT - domain: lgbeauty.com engines: - CHATGPT - GOOGLE - AIMODE 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 completedAt: '2026-10-20T09:23:04.711Z' credits: 2 - taskType: CHATGPT prompt: Find the best price for belif Moisturizing Eye Bomb taskId: c60ffa61-d399-4b15-8343-452dcc150fd3 status: COMPLETED completedAt: '2026-10-20T09:23:20.863Z' credits: 2 listings: - position: 1 title: belif Moisturizing Eye Bomb Eye Cream source: merchant_feed merchant: Ulta Beauty url: >- https://www.ulta.com/p/moisturizing-eye-bomb-eye-cream-pimprod2043262?cmpid… price: value: 48 currency: USD raw: $48.00 available: true brand: belif modelSees: title: belif Moisturizing Eye Bomb Eye Cream description: >- belif's Moisturizing Eye Bomb Eye Cream is a lightweight cream that floods the eye area wi… rating: 4.5 reviewCount: 105 brand: belif ids: chatgptProductId: '2619879' feedId: oai-shopping-id:v1:feed:… ask: 1 match: score: 1 - position: 1 title: Amazon source: chatgpt_widget merchant: Amazon url: https://www.amazon.com/s?k=belif+Moisturizing+Eye+Bomb price: value: 43 currency: USD raw: $43.00 description: >- Reported sale price · $5 below retail · A recent October 2026 deal report lists this price. pictured: belif Moisturizing Eye Bomb 25ml blue jar white lid ask: 2 match: score: 1 otherListings: [] citedPages: - url: >- https://lgbeauty.com/products/moisturizing-eye-bomb?selectedVariant=47584416432448 domain: lgbeauty.com title: Moisturizing Eye Bomb ask: 1 competitors: - product: Clinique All About Eyes summary: foundIn: - CHATGPT - GOOGLE - AIMODE - BING_COPILOT notFoundIn: [] pending: [] failed: [] merchants: - merchant: Ulta Beauty engines: - CHATGPT - AIMODE - BING_COPILOT price: currency: USD min: 39 max: 66 priceRange: currency: USD min: 38.05 max: 72 citedDomains: - domain: clinique.com engines: - GOOGLE - AIMODE credits: 10 engines: - engine: BING_COPILOT status: COMPLETED found: true via: - taskType: BING_COPILOT prompt: Clinique All About Eyes taskId: 5a2119a5-69f4-49db-89e2-a7822b6d99d9 status: COMPLETED completedAt: '2026-10-20T09:23:39.682Z' credits: 2 listings: - position: 1 title: Clinique All About Eyes Cream source: microsoft_shopping merchant: Walmart url: >- https://www.walmart.com/ip/Clinique-All-About-Eyes-1-oz-Eye… price: value: 54 currency: USD raw: $54 rating: 4.58 reviewCount: 76542 brand: Olabens ask: 1 match: score: 1 otherListings: [] citedPages: [] - product: CeraVe Eye Repair Cream summary: foundIn: - CHATGPT - GOOGLE - AIMODE - BING_COPILOT notFoundIn: [] pending: [] failed: [] merchants: - merchant: Ulta Beauty engines: - CHATGPT price: currency: USD min: 14.99 max: 19.99 priceRange: currency: USD min: 14.44 max: 38.95 citedDomains: - domain: cerave.com engines: - GOOGLE credits: 10 engines: - engine: BING_COPILOT status: COMPLETED found: true via: - taskType: BING_COPILOT prompt: CeraVe Eye Repair Cream taskId: c6568949-6bf5-44a4-a7dd-38db0a86be71 status: COMPLETED completedAt: '2026-10-20T09:23:41.368Z' credits: 2 listings: - position: 1 title: >- CeraVe Eye Repair Cream for Dark Circles and Puffiness source: microsoft_shopping merchant: Pasteur Pharmacy url: >- https://pasteurpharmacy.com/products/cerave-anti-aging-eye-r… price: value: 15.95 currency: USD raw: $15.95 rating: 4.35 reviewCount: 117193 brand: CeraVe ask: 1 match: score: 1 otherListings: [] citedPages: - url: >- https://ctchealth.ca/product/cerave-eye-repair-cream-with-hyaluronic-acid-3-ceramides/?utm_source=copilot.com domain: ctchealth.ca title: >- CeraVe Eye Repair Cream for Dark Circles and Puffiness ask: 1 comparison: - product: belif Moisturizing Eye Bomb role: product engines: - engine: CHATGPT status: COMPLETED found: true listings: 4 merchants: 4 mostReviewed: reviewCount: 105 rating: 4.5 merchant: Ulta Beauty priceRange: currency: USD min: 43 max: 48 prompts: answered: 2 appeared: 0 - 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: Clinique All About Eyes role: competitor engines: - engine: BING_COPILOT status: COMPLETED found: true listings: 4 merchants: 3 mostReviewed: reviewCount: 85773 rating: 4.6 merchant: Walmart priceRange: currency: USD min: 38.05 max: 72 prompts: answered: 2 appeared: 0 - 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 via: - taskType: GOOGLE query: best moisturizing eye cream taskId: ae6a153a-6382-40d6-84df-c99de0b60d17 status: COMPLETED completedAt: '2026-10-20T09:24:29.231Z' credits: 1.25 shown: - CeraVe Eye Repair Cream - Clinique All About Eyes named: - belif Moisturizing Eye Bomb - CeraVe Eye Repair Cream - Clinique All About Eyes listings: - position: 1 title: CeraVe Eye Repair Cream source: google_shopping product: CeraVe Eye Repair Cream match: score: 1 - position: 3 title: Clinique All About Eyes Rich source: google_shopping product: Clinique All About Eyes match: score: 1 citedPages: - url: >- https://www.nytimes.com/wirecutter/reviews/best-eye-cream/ domain: nytimes.com title: The New York Times - engine: BING_COPILOT status: COMPLETED via: - taskType: BING_COPILOT prompt: best moisturizing eye cream taskId: 0f582e93-7756-439d-8e5c-bacc510fdff0 status: COMPLETED completedAt: '2026-10-20T09:23:45.384Z' credits: 1.25 shown: - belif Moisturizing Eye Bomb named: - belif Moisturizing Eye Bomb listings: - position: 1 title: >- belif Moisturizing Eye Bomb with Peptide and Ceramide source: microsoft_shopping merchant: Comparor url: >- https://www.comparor.com/us/belif-moisturizing-eye-bomb-hydr… price: value: 45.9 currency: USD raw: $45.9 rating: 4.58 reviewCount: 2942 product: belif Moisturizing Eye Bomb match: score: 1 citedPages: - url: >- https://www.comparor.com/us/belif-moisturizing-eye-bomb-hydrating-eye-cream-25ml.html?utm_source=copilot.com domain: comparor.com title: >- belif Moisturizing Eye Bomb with Peptide and Ceramide '400': description: >- VALIDATION_ERROR: the id is not 1-200 characters without leading or trailing spaces. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': $ref: '#/components/responses/Unauthorized' '404': description: >- RESOURCE_NOT_FOUND: no lookup with this id on your account, including one whose tasks are past the read window. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: success: false error: code: RESOURCE_NOT_FOUND message: Product lookup not found details: id: eye-bomb-us timestamp: '2026-10-20T09:22:43.000Z' components: schemas: ProductLookupResponse: type: object properties: success: type: boolean lookup: type: object properties: id: type: string product: type: string competitors: type: array items: type: string prompts: type: array items: type: string country: type: string enum: - US - KR status: allOf: - $ref: '#/components/schemas/TaskStatus' description: >- QUEUED until an ask starts, PROCESSING while any ask is unfinished, then COMPLETED, or FAILED when every ask failed. createdAt: type: string format: date-time completedAt: type: - string - 'null' format: date-time description: When the last ask finished. credits: type: number description: Credits charged for every ask of the lookup so far. summary: allOf: - $ref: '#/components/schemas/ProductLookupSummary' description: The product's answers across engines. engines: type: array items: $ref: '#/components/schemas/ProductLookupEngineResult' description: The product's answers, one entry per engine asked. competitors: type: array items: $ref: '#/components/schemas/ProductLookupProduct' description: >- Each competitor's summary and engines, in the order of lookup.competitors. comparison: type: array items: $ref: '#/components/schemas/ProductLookupComparisonRow' description: The product and each competitor, engine by engine. prompts: type: array description: What each engine answered to each shopper prompt. items: type: object properties: prompt: type: string engines: type: array items: $ref: '#/components/schemas/ProductLookupPromptEngine' ErrorResponse: type: object required: - success - error properties: success: type: boolean const: false error: $ref: '#/components/schemas/ErrorDetail' TaskStatus: type: string description: >- `PROCESSING` means a worker holds the task. `COMPLETED` and `FAILED` are terminal. enum: - QUEUED - PROCESSING - COMPLETED - FAILED ProductLookupSummary: type: object description: One product's answers across engines. properties: foundIn: type: array items: $ref: '#/components/schemas/ProductLookupEngine' description: Engines whose answers showed the product. notFoundIn: type: array items: $ref: '#/components/schemas/ProductLookupEngine' description: Engines whose asks finished without showing it. pending: type: array items: $ref: '#/components/schemas/ProductLookupEngine' description: Engines with asks still queued or processing. failed: type: array items: $ref: '#/components/schemas/ProductLookupEngine' description: Engines whose asks all failed. merchants: type: array description: >- Each merchant of the product's listings, with the engines that showed it and its prices there, most engines first. items: type: object properties: merchant: type: string engines: type: array items: $ref: '#/components/schemas/ProductLookupEngine' price: $ref: '#/components/schemas/ProductLookupPriceRange' priceRange: $ref: '#/components/schemas/ProductLookupPriceRange' citedDomains: type: array description: >- Each site the answers cite, with the engines that cite it, most engines first. items: type: object properties: domain: type: string engines: type: array items: $ref: '#/components/schemas/ProductLookupEngine' credits: type: number description: Credits charged for this product's asks so far. ProductLookupEngineResult: type: object description: One engine's answers about one product. properties: engine: $ref: '#/components/schemas/ProductLookupEngine' status: allOf: - $ref: '#/components/schemas/TaskStatus' description: >- COMPLETED once every ask finished and one completed; FAILED when every ask failed. found: type: - boolean - 'null' description: >- Whether an answer showed a listing of the product, a record or a ChatGPT widget card. null while asks are running and nothing is found yet, and when every ask failed. via: type: array items: $ref: '#/components/schemas/ProductLookupVia' description: The engine's asks, in order. listings: type: array items: $ref: '#/components/schemas/ProductLookupListing' description: >- Listings judged to be the product, or another pack or form of it. A listing that two asks showed is listed once, and a widget card with the same shop and price as a record or an earlier card is left out. otherListings: type: array items: $ref: '#/components/schemas/ProductLookupListing' description: >- Other products the answers showed. A renamed or translated version of the product can be here. citedPages: type: array items: $ref: '#/components/schemas/ProductLookupCitedPage' description: >- The pages the answers cite. For ChatGPT, the sources its answer cites. ProductLookupProduct: type: object properties: product: type: string summary: $ref: '#/components/schemas/ProductLookupSummary' engines: type: array items: $ref: '#/components/schemas/ProductLookupEngineResult' ProductLookupComparisonRow: type: object properties: product: type: string role: type: string enum: - product - competitor engines: type: array items: type: object properties: engine: $ref: '#/components/schemas/ProductLookupEngine' status: $ref: '#/components/schemas/TaskStatus' found: type: - boolean - 'null' listings: type: integer description: Listings judged to be the product, widget cards included. merchants: type: integer description: Merchants among those listings. mostReviewed: type: object description: >- The listing with the most reviews. For ChatGPT, the count its answering model was given (modelSees). Copilot puts one product's review count on every merchant's offer, so merchant is the first offer that carries it. properties: reviewCount: type: integer rating: type: number merchant: type: string priceRange: $ref: '#/components/schemas/ProductLookupPriceRange' prompts: type: object description: >- Only when the lookup has shopper prompts: how many of them the engine answered, and how many of those answers showed or named the product. properties: answered: type: integer appeared: type: integer ProductLookupPromptEngine: type: object description: One engine's answer to one shopper prompt. properties: engine: $ref: '#/components/schemas/ProductLookupEngine' status: $ref: '#/components/schemas/TaskStatus' via: type: array items: $ref: '#/components/schemas/ProductLookupVia' shown: type: array items: type: string description: >- The lookup's products (the product and competitors) that the answer showed as a record or widget card, in the order shown. A record counts only when it contains the product name's first word, the brand. named: type: array items: type: string description: >- The lookup's products that the answer's text names, in the order named. listings: type: array description: >- Every product record and widget card in the answer. One that is a looked-up product carries product and match. items: allOf: - $ref: '#/components/schemas/ProductLookupRecord' - type: object properties: product: type: string description: The looked-up product this listing is. match: $ref: '#/components/schemas/ProductLookupMatch' citedPages: type: array items: $ref: '#/components/schemas/ProductLookupCitedPage' ErrorDetail: type: object required: - code - message properties: code: type: string description: Stable, safe to branch on. See the Errors guide for the full list. message: type: string description: For humans. May change. details: description: >- Context for the error. An array of `{field, message}` on most `VALIDATION_ERROR`s; an object elsewhere (for example `{id}` on `RESOURCE_NOT_FOUND`, `retryAfterSec` on 429 and 503 codes). Omitted when there is nothing to add. oneOf: - type: array items: type: object properties: field: type: string message: type: string - type: object additionalProperties: true timestamp: type: string format: date-time ProductLookupEngine: type: string description: >- An engine a product lookup can ask. GOOGLE is Google AI Overviews and AIMODE is Google AI Mode. NAVER_AI_TAB answers in KR only. enum: - CHATGPT - GOOGLE - AIMODE - GEMINI - BING_COPILOT - NAVER_AI_TAB ProductLookupPriceRange: type: object description: >- Single-unit prices in the market's currency (USD for US, KRW for KR). Listings with match.variant are left out. properties: currency: type: string min: type: number max: type: number ProductLookupVia: type: object description: One ask and its task. properties: taskType: $ref: '#/components/schemas/ProductLookupEngine' prompt: type: string description: The text asked, on engines that take a prompt. query: type: string description: The text asked, on engines that take a query. taskId: type: string format: uuid status: $ref: '#/components/schemas/TaskStatus' completedAt: type: - string - 'null' format: date-time credits: type: number description: 'What the ask was charged: 0 until it finishes, and 0 when it fails.' error: type: string description: Why the ask failed, starting with its code. ProductLookupListing: allOf: - $ref: '#/components/schemas/ProductLookupRecord' - type: object properties: ask: type: integer description: >- Which of the engine's asks showed the listing, from 1, in the order of via. match: $ref: '#/components/schemas/ProductLookupMatch' ProductLookupCitedPage: type: object properties: url: type: string domain: type: string description: The host without www. or m. title: type: string ask: type: integer description: 'In engines[]: which ask''s answer cites the page, from 1.' ProductLookupRecord: type: object description: >- One merchant's listing of a product as an engine shows it. Only the fields the engine gives are set. properties: position: type: integer description: Order in the answer, from 1. title: type: string description: >- The product name on the record. On a chatgpt_widget listing, the card's heading, which can be the shop's name. merchant: type: string description: Who sells it. source: type: string enum: - shopify - google_shopping - merchant_feed - chatgpt_catalog - chatgpt_widget - microsoft_shopping - naver_shopping description: >- Where the listing comes from. ChatGPT's product catalog holds shopify, google_shopping and merchant_feed records, and chatgpt_catalog when the record does not say. chatgpt_widget is a shop and price ChatGPT wrote in a widget card without a record. Google AI Overviews, AI Mode and Gemini show google_shopping, Copilot microsoft_shopping and Naver AI Tab naver_shopping. url: type: string description: >- The merchant's page when the engine links one, otherwise the engine's own product page. price: $ref: '#/components/schemas/ProductLookupPrice' oldPrice: allOf: - $ref: '#/components/schemas/ProductLookupPrice' description: The price before a discount the engine shows. available: type: boolean description: Whether it is in stock. ChatGPT only. rating: type: number minimum: 0 maximum: 5 reviewCount: type: integer image: type: string description: type: string brand: type: string modelSees: type: object description: >- ChatGPT only: what ChatGPT gave its answering model about the record. A merchant feed record's rating and review count are only here. properties: title: type: string description: type: string rating: type: number reviewCount: type: integer brand: type: string productPage: type: string reviews: type: object description: The review summary and pros and cons the engine shows. properties: summary: type: string pros: type: array items: type: string cons: type: array items: type: string ids: type: object additionalProperties: type: string description: >- Catalog identifiers that tie records of one product together, such as chatgptProductId and feedId on ChatGPT, googleCatalogId, googleProductGroupId and googleProductDocId on Google engines, bingProductId and bingGroupId on Copilot, and naverProductId on Naver AI Tab. pictured: type: string description: >- chatgpt_widget only: what the picture beside the card shows, as the answer searched for it. ProductLookupMatch: type: object description: >- Why a listing is judged to be a looked-up product. No engine returns a GTIN, so the judgment uses names. properties: score: type: number minimum: 0 maximum: 1 description: Share of the product name's words found in the listing. missing: type: array items: type: string description: Words of the product name the listing lacks. variant: type: array items: type: string description: >- Words that mark another pack or form of the product, such as set, mini, 1+1 or stick. accessory: type: array items: type: string description: >- Words that mark a part rather than the product, such as a replacement filter. ProductLookupPrice: type: object properties: value: type: number currency: type: string description: >- An ISO 4217 code when the symbol is unambiguous in the market, otherwise the symbol as shown. raw: type: string description: The price as the engine shows it. responses: Unauthorized: description: Missing or invalid bearer token. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: success: false error: code: MISSING_API_KEY message: Missing or invalid API key timestamp: '2026-07-09T04:12:00.000Z' securitySchemes: bearerAuth: type: http scheme: bearer description: 'Your API key, sent as `Authorization: Bearer `.' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.