Conheça o Commerce Product

Envie a URL de uma página de produto da Amazon, Walmart, Sephora, Olive Young, Rakuten, Zalando ou de outras 11 lojas e receba preço, estoque, imagens da galeria e da descrição, especificações e opções no mesmo formato.

O que você recebe

• COMMERCE_PRODUCT: cada tarefa lê uma página de produto entre 17 lojas nos EUA, Coreia, Japão, Índia e Alemanha. Envie a url da página; ela define a loja.
• title, brand, price e listPrice com a sua currency, inStock, seller, rating e reviewCount, como a página os mostra.
• images: a galeria do produto. descriptionImages: as imagens da descrição do produto, como a página de detalhes do vendedor ou o conteúdo A+ da Amazon, na ordem da página.
• description, specs, options, categories e gtin, nos mesmos campos em todas as lojas.

Lojas

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

Como funciona

Cada tarefa lê a página de produto a partir do país da loja e devolve os valores da opção com que a página abre. price é o que o comprador paga antes de cupons e frete, e options lista os demais tamanhos, cores ou kits.

images reúne até 30 fotos da galeria e descriptionImages até 300 imagens da descrição, na ordem da página. As imagens da descrição vêm da Amazon, Ulta, Olive Young, 11st, Lotte ON, Musinsa, Kurly, Rakuten, Yahoo! Shopping e Qoo10. Banners e avisos que o vendedor coloca ali vêm junto, e o texto dentro de uma imagem fica na imagem.

title, price, currency e images vêm de todas as lojas; os demais campos vêm quando a página os mostra, e a documentação do mecanismo indica quais lojas devolvem cada um. Quando a loja responde com uma página removida, como um produto retirado, a tarefa termina com PAGE_UNAVAILABLE.

Onde ajuda

• Leia por inteiro os primeiros produtos de uma Commerce Search: preço, estoque, vendedor e todas as opções.
• Acompanhe todo dia o preço, o preço de tabela e o estoque da sua página de produto na Amazon, Olive Young e Rakuten.
• Reúna a galeria e as imagens de detalhe dos concorrentes para comparar como cada marca apresenta o mesmo produto.
• Leve especificações, opções e imagens da descrição para o seu catálogo ou para uma auditoria de respostas de compra com IA.

Envie a requisição

Envie a requisição com a sua chave de API no cabeçalho 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 da requisição

taskTypestringObrigatório

O motor que executa a tarefa, como CHATGPT ou GOOGLE.

payload.urlstringObrigatório

Uma página de produto de uma das 17 lojas, com até 2.048 caracteres. A URL define a loja e o país.

payload.countrystring

O país da loja, como US para a Amazon ou KR para a Olive Young. É também o valor padrão.

webhook.urlstring

Um endereço HTTPS do seu servidor. A tarefa concluída é enviada para lá assim que termina.

Resposta

Uma tarefa concluída chega assim, resumida para facilitar a leitura.

{
  "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 e, no fim, COMPLETED com a resposta ou FAILED com error.

credits.creditsChargedinteger

Créditos cobrados pela tarefa concluída. Uma tarefa que falhou cobra 0.

response.pricenumber

O que o comprador paga pelo produto como a página o mostra primeiro, antes de cupons e frete, em currency (ISO 4217). listPrice é o preço normal riscado quando fica acima de price.

response.imagesarray

Até 30 fotos da galeria do produto, na ordem da página.

response.descriptionImagesarray

Até 300 imagens da descrição do produto, como a página de detalhes do vendedor ou o conteúdo A+ da Amazon, na ordem da página.

response.specsarray

Até 100 pares { name, value } dos detalhes do produto. options lista as escolhas, como tamanho ou cor, cada uma com seus values.

Receba o resultado

A requisição devolve a tarefa na hora, com status QUEUED. Consulte GET /v1/async/task/{id} até status virar COMPLETED ou FAILED, ou adicione webhook.url e a tarefa concluída chega ao seu servidor com os mesmos task, credits e response. Os resultados ficam disponíveis por 24 horas após o fim da tarefa.

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

Erros

VALIDATION_ERRORHTTP 422

url está ausente, passa de 2.048 caracteres ou fica fora das páginas de produto das 17 lojas, ou o payload traz um campo diferente de url e country. details indica o campo.

REGION_UNSUPPORTEDHTTP 422

country é um país diferente do da loja, como KR com uma URL da Amazon.

MISSING_API_KEYHTTP 401

Falta o cabeçalho Authorization, ou a chave é desconhecida, expirou ou foi revogada.

INSUFFICIENT_CREDITSHTTP 402

O saldo é menor que o preço da tarefa. Adicione créditos ou mude de plano e envie de novo.

Preço

Cada leitura concluída usa 3 créditos em todas as lojas. Os créditos são cobrados quando a tarefa é concluída.