Presentamos Commerce Product

Pasa la URL de una página de producto de Amazon, Walmart, Sephora, Olive Young, Rakuten, Zalando y otras 11 tiendas, y recibe su precio, stock, imágenes de galería y de descripción, especificaciones y opciones en el mismo formato.

Qué obtienes

• COMMERCE_PRODUCT: cada tarea lee una página de producto de 17 tiendas de Estados Unidos, Corea, Japón, India y Alemania. Pasa la url de la página; ella elige la tienda.
• title, brand, price y listPrice con su currency, inStock, seller, rating y reviewCount, tal como los muestra la página.
• images: la galería del producto. descriptionImages: las imágenes de la descripción del producto, como la página de detalle del vendedor o el contenido A+ de Amazon, en el orden de la página.
• description, specs, options, categories y gtin, con los mismos campos en todas las tiendas.

Tiendas

• Estados Unidos (US): Amazon amazon, Walmart walmart, Target target, Sephora sephora, Ulta ulta
• Corea (KR): Olive Young oliveyoung, 11st 11st, Lotte ON lotteon, Musinsa musinsa, Kurly kurly
• Japón (JP): Rakuten rakuten, Yahoo! Shopping yahoo_shopping, Qoo10 qoo10
• India (IN): Flipkart flipkart, Myntra myntra, Nykaa nykaa
• Alemania (DE): Zalando zalando

Cómo funciona

Cada tarea lee la página de producto desde el país de la tienda y devuelve los valores de la opción con la que se abre la página. price es lo que paga el comprador antes de cupones y envío, y options lista las demás tallas, colores o packs.

images reúne hasta 30 fotos de la galería y descriptionImages hasta 300 imágenes de la descripción, en el orden de la página. Las imágenes de la descripción llegan de Amazon, Ulta, Olive Young, 11st, Lotte ON, Musinsa, Kurly, Rakuten, Yahoo! Shopping y Qoo10. Los banners y avisos que el vendedor coloca ahí llegan con ellas, y el texto dentro de una imagen queda en la imagen.

title, price, currency e images llegan de todas las tiendas; los demás campos llegan cuando la página los muestra, y la documentación del motor indica qué tiendas devuelven cada uno. Cuando la tienda responde con una página retirada, como un producto descatalogado, la tarea termina con PAGE_UNAVAILABLE.

Para qué sirve

• Lee a fondo los primeros productos de una Commerce Search: precio, stock, vendedor y todas las opciones.
• Sigue a diario el precio, el precio de lista y el stock de tu página de producto en Amazon, Olive Young y Rakuten.
• Reúne la galería y las imágenes de detalle de la competencia para comparar cómo presenta cada marca el mismo producto.
• Lleva especificaciones, opciones e imágenes de descripción a tu catálogo o a una revisión de respuestas de compra con IA.

Envía la solicitud

Envía la solicitud con tu clave de API en la cabecera 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" }
  }'

Campos de la solicitud

taskTypestringObligatorio

El motor que se ejecuta, como CHATGPT o GOOGLE.

payload.urlstringObligatorio

Una página de producto de una de las 17 tiendas, de hasta 2.048 caracteres. La URL fija la tienda y su país.

payload.countrystring

El país de la tienda, como US para Amazon o KR para Olive Young. También es el valor predeterminado.

webhook.urlstring

Una dirección HTTPS de tu servidor. La tarea terminada se envía allí en cuanto se completa.

Respuesta

Así llega una tarea terminada, recortada para que se lea mejor.

{
  "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 y al final COMPLETED con la respuesta o FAILED con error.

credits.creditsChargedinteger

Créditos cobrados por la tarea terminada. Una tarea fallida cobra 0.

response.pricenumber

Lo que paga el comprador por el producto tal como la página lo muestra primero, antes de cupones y envío, en currency (ISO 4217). listPrice es el precio habitual tachado cuando supera a price.

response.imagesarray

Hasta 30 fotos de la galería del producto, en el orden de la página.

response.descriptionImagesarray

Hasta 300 imágenes de la descripción del producto, como la página de detalle del vendedor o el contenido A+ de Amazon, en el orden de la página.

response.specsarray

Hasta 100 pares { name, value } de los detalles del producto. options lista las opciones, como talla o color, cada una con sus values.

Recibe el resultado

La solicitud devuelve la tarea al instante con status QUEUED. Consulta GET /v1/async/task/{id} hasta que status sea COMPLETED o FAILED, o añade webhook.url y la tarea terminada llega a tu servidor con los mismos task, credits y response. Los resultados siguen disponibles 24 horas después de terminar la tarea.

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

Errores

VALIDATION_ERRORHTTP 422

Falta url, supera los 2.048 caracteres o queda fuera de las páginas de producto de las 17 tiendas, o el payload lleva un campo distinto de url y country. details indica el campo.

REGION_UNSUPPORTEDHTTP 422

country es un país distinto del de la tienda, como KR con una URL de Amazon.

MISSING_API_KEYHTTP 401

Falta la cabecera Authorization, o su clave es desconocida, caducó o fue revocada.

INSUFFICIENT_CREDITSHTTP 402

El saldo es menor que el precio de la tarea. Añade créditos o mejora el plan y vuelve a enviarla.

Precio

Cada lectura completada usa 3 créditos en todas las tiendas. Los créditos se cobran cuando la tarea se completa.