Commerce Search API (COMMERCE_SERP)

​

Requisição

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": "amazon", "query": "wireless earbuds", "limit": 20 } }'

​

Parâmetros

• site: Obrigatório. A loja a buscar, conforme a tabela abaixo.
• query: Termo de busca obrigatório, de 1 a 500 caracteres.
• country: Opcional. O padrão é o país da loja. Qualquer outro país é recusado com 422 REGION_UNSUPPORTED.
• limit: Inteiro opcional de 1 a 40, com padrão 20.

​

Exemplo de resposta

{
  "site": "amazon",
  "query": "wireless earbuds",
  "country": "US",
  "returnedCount": 1,
  "products": [
    {
      "rank": 1,
      "productId": "B0CHWRXH8B",
      "title": "Wireless Earbuds, Bluetooth 5.3 Headphones",
      "url": "https://www.amazon.com/dp/B0CHWRXH8B",
      "price": 24.99,
      "currency": "USD",
      "rating": 4.6,
      "reviewCount": 19406
    }
  ]
}

​

Campos do resultado

• site, query e country repetem a requisição. returnedCount é o número de itens em products.
• Cada produto inclui rank, productId, title e url. productId é o ID de produto da própria loja, como o ASIN na Amazon, o número do anúncio no eBay ou shop:item na Rakuten. rank segue a ordem padrão da loja. Exceto na Coupang, pula os anúncios que a loja marca como patrocinados.
• price, rating, reviewCount, imageUrl e brand aparecem quando a página de resultados os mostra. price é um número na currency (ISO 4217) de cada produto: uma mesma busca na Amazon pode mostrar mais de uma moeda. Quando os tamanhos têm preços diferentes, price é o menor. Os preços da Target são os da sua loja online padrão. Os preços do AliExpress são os preços de venda exibidos a um comprador dos EUA sem login.
• rating usa uma escala de cinco estrelas. A Kurly e a Zalando não mostram avaliações, o AliExpress mostra estrelas sem o número de avaliações, e contagens abreviadas como 999+ são omitidas. brand vem da Target, Sephora, Ulta, Olive Young, Lotte ON, Musinsa, Yahoo! Shopping, Qoo10, Flipkart, Myntra, Nykaa e Zalando, que mostram a marca separada do título.
• No google_shopping, productId é o ID de produto do Google, ou o ID da oferta quando o Google não agrupou o anúncio em um produto. A página do Google não tem links para a página do produto nem da loja, então url é a página de resultados do Google Shopping em que o produto apareceu, com #product={productId}&title={title} no final. Envie essa url ao Commerce Product para ler as lojas, especificações e descrição do produto. seller é a loja que o Google mostra primeiro, e reviewCount aparece apenas quando o Google mostra o número exato (menos de 1.000).
• Cada busca retorna produtos da primeira página de resultados da loja. Essa página mostra até 30 produtos no Yahoo! Shopping, 32 na Myntra e 24 na Zalando. Na Flipkart ela tem 40 posições e na Nykaa 20, com anúncios patrocinados incluídos.
• Quando uma loja envia a busca para outra página, os produtos vêm dessa página: a Ulta envia algumas marcas para a página da marca, a Target envia algumas buscas para uma busca relacionada, e a Nykaa mostra a página da categoria para buscas que nomeiam uma categoria.
• Uma busca sem nenhum produto termina como tarefa com falha. A cobrança é por busca concluída.

​

Relacionado

• Commerce Product
• Visão geral dos motores
• Créditos e limites