A busca de produtos em 20 lojas online já está disponível

Pesquise na Amazon, Walmart, Coupang, Olive Young, Rakuten, Flipkart, Zalando e em mais 13 lojas de cinco países, e receba o ranking de produtos de cada uma com preços, avaliações e número de resenhas no mesmo formato.

O que você recebe

• COMMERCE_SERP: cada tarefa pesquisa uma loja, escolhida com payload.site, entre 20 lojas nos EUA, Coreia, Japão, Índia e Alemanha.
• products: o ranking da loja para a sua busca, até 40 produtos, cada um com rank, productId, title e url.
• price como número com a sua currency, além de rating, reviewCount, brand e imageUrl sempre que a página de resultados os mostra.
• Os mesmos campos de produto em todas as lojas, então um único parser lê Amazon, Coupang, Rakuten e Zalando do mesmo jeito.

Lojas

• Estados Unidos (US): Amazon amazon, Walmart walmart, Target target, eBay ebay, AliExpress aliexpress, Sephora sephora, Ulta ulta
• Coreia (KR): Coupang coupang, 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 primeira página de resultados que a loja mostra para a sua busca no próprio país e devolve os produtos na ordem padrão da loja. Em todas as lojas, exceto a Coupang, os anúncios patrocinados ficam de fora, e rank conta os demais na ordem da página.

productId é o ID da própria loja: o ASIN na Amazon, o número do item no eBay, shop:item no Rakuten. price é um número na currency do produto (ISO 4217) e, quando cada tamanho tem seu preço, o mais baixo. rating usa uma escala de cinco pontos nas lojas que mostram avaliações; Kurly e Zalando apresentam os produtos com preço e título.

Quando uma loja leva uma busca para outra página, os produtos vêm dessa página: a Ulta leva alguns nomes de marca para a página da marca, a Target leva algumas buscas para uma busca relacionada e a Nykaa mostra a página da categoria para buscas que citam uma categoria. Uma busca que não encontra produtos termina como tarefa com falha.

Onde ajuda

• Acompanhe dia a dia a posição do seu produto na busca da categoria na Amazon, Walmart e Target.
• Compare o seu preço, avaliação e número de resenhas com os produtos ao redor no ranking.
• Acompanhe uma linha de beleza ou moda na Olive Young, Rakuten, Nykaa e Zalando com o mesmo formato de requisição.
• Coloque o ranking da loja ao lado das respostas do ChatGPT ou do Google AI Mode para a mesma busca e veja quais produtos o comprador encontra em cada lugar.

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_SERP",
    "payload": { "site": "target", "query": "sunscreen", "limit": 10 }
  }'

Campos da requisição

taskTypestringObrigatório

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

payload.sitestringObrigatório

A loja pesquisada, como amazon, coupang ou rakuten. Os 20 valores aparecem com o motor.

payload.querystringObrigatório

A busca, escrita como o comprador digita na caixa de busca da loja. De 1 a 500 caracteres.

payload.countrystring

O país da loja, como US para amazon ou KR para coupang. É também o valor padrão.

payload.limitinteger

Produtos retornados, de 1 a 40. Padrão 20.

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": "fa04f93f-babe-4d50-9549-8b7100261fee",
    "taskType": "COMMERCE_SERP",
    "status": "COMPLETED",
    "createdAt": "2026-10-22T00:05:55.416Z"
  },
  "credits": { "creditsToCharge": 3, "creditsCharged": 3 },
  "response": {
    "site": "target",
    "query": "sunscreen",
    "country": "US",
    "returnedCount": 10,
    "products": [
      {
        "rank": 1,
        "productId": "76545827",
        "title": "La Roche Posay Anthelios Melt in Milk Sunscreen Lotion - SPF 100 - 3.0 fl oz",
        "brand": "La Roche Posay",
        "url": "https://www.target.com/p/la-roche-posay-anthelios-melt-in-milk-sunscreen-lotion-spf-100-3-0-fl-oz/-/A-76545827",
        "price": 20.99,
        "currency": "USD",
        "rating": 4.54,
        "reviewCount": 995
      },
      {
        "rank": 2,
        "productId": "80839020",
        "title": "Neutrogena Beach Defense Sunscreen Lotion - SPF 70 - 1 fl oz",
        "brand": "Neutrogena",
        "url": "https://www.target.com/p/neutrogena-beach-defense-sunscreen-lotion-spf-70-1-fl-oz/-/A-80839020",
        "price": 1.99,
        "currency": "USD",
        "rating": 4.59,
        "reviewCount": 1580
      },
      "…"
    ]
  }
}

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.returnedCountinteger

O número de produtos em products.

response.productsarray

Os produtos na ordem da loja: rank, productId, title e url, além de price, currency, rating, reviewCount, imageUrl e brand quando a página de resultados os mostra.

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

site está fora das 20 lojas, query está vazio ou passa de 500 caracteres, limit está fora de 1 a 40 ou o payload traz outro campo. details indica o campo.

REGION_UNSUPPORTEDHTTP 422

country é um país diferente do da loja, como KR com 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 busca concluída usa 3 créditos em todas as lojas. Os créditos são cobrados quando a tarefa é concluída.