Commerce Product API (COMMERCE_PRODUCT)

Leia a página de produto de uma loja e receba o produto em JSON pela API de tarefas assíncronas. Passe a url da página; a URL escolhe a loja, e todas as lojas retornam os mesmos campos. Cada leitura concluída custa 3 créditos.

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_PRODUCT", "payload": { "url": "https://www.amazon.com/dp/B00TTD9BRC" } }'

Envie a tarefa e depois consulte GET /v1/async/task/{id} ou receba o webhook. Veja Tarefas assíncronas.

Parâmetros

url: Obrigatório. Uma página de produto de uma das lojas abaixo, com até 2.048 caracteres. As url de produto que o Commerce Search retorna para essas lojas funcionam como estão, exceto as páginas LOHACO do Yahoo! Shopping (lohaco.yahoo.co.jp). Os parâmetros que não afetam o resultado, como códigos de rastreamento, são removidos antes da leitura.
country: Opcional. O padrão é o país da loja. Qualquer outro país é recusado com 422 REGION_UNSUPPORTED.

`site`	Página do produto	`country`
`amazon`	`amazon.com/dp/{ASIN}`	`US`
`walmart`	`walmart.com/ip/{name}/{id}`	`US`
`target`	`target.com/p/{name}/-/A-{TCIN}`	`US`
`sephora`	`sephora.com/product/{name}-P{id}`	`US`
`ulta`	`ulta.com/p/{name}-{id}`	`US`
`11st`	`11st.co.kr/products/{id}`	`KR`
`lotteon`	`lotteon.com/p/product/{id}`	`KR`
`musinsa`	`musinsa.com/products/{id}`	`KR`
`kurly`	`kurly.com/goods/{id}`	`KR`
`oliveyoung`	`oliveyoung.co.kr/store/goods/getGoodsDetail.do?goodsNo={id}`	`KR`
`rakuten`	`item.rakuten.co.jp/{shop}/{item}/`	`JP`
`yahoo_shopping`	`store.shopping.yahoo.co.jp/{store}/{item}.html`	`JP`
`qoo10`	`qoo10.jp/g/{id}`	`JP`
`flipkart`	`flipkart.com/{name}/p/{itm}?pid={pid}`	`IN`
`myntra`	`myntra.com/{category}/{brand}/{name}/{id}/buy`	`IN`
`nykaa`	`nykaa.com/{name}/p/{id}`	`IN`
`zalando`	`zalando.de/{name}-{sku}.html`	`DE`
`google_shopping`	`google.com/search?q={query}&udm=28#product={productId}&title={title}`	`US`

Outros endereços da mesma página também funcionam, como /gp/product/{ASIN} na Amazon ou as páginas móveis da 11st.

Exemplo de resposta

{
  "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": 16.77,
  "listPrice": 18.96,
  "currency": "USD",
  "inStock": true,
  "seller": "Amazon.com",
  "rating": 4.7,
  "reviewCount": 149149,
  "images": ["https://m.media-amazon.com/images/I/61EidjXUBrL._SL1000_.jpg"],
  "description": "[ HYALURONIC ACID MOISTURIZER ] With hyaluronic acid, ceramides and MVE technology for 24 hour hydration.",
  "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": "Item Form", "value": "Cream" },
    { "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", "Creams & Moisturizers", "Face Moisturizers"]
}

Campos do resultado

site, country, url e productId identificam a página. url é a página lida. productId é o ID de produto da própria loja, como o ASIN na Amazon ou shop:item na Rakuten, e coincide com o que o Commerce Search retorna. A exceção é um produto da Nykaa com tons ou tamanhos: o Commerce Search retorna o ID de uma das opções, e esta leitura retorna o ID da página do produto.
title está sempre presente. Os demais campos aparecem quando a página os mostra; a tabela abaixo lista as lojas que retornam cada um.
price é o que um comprador paga pelo produto como a página o mostra ao abrir, antes de cupons e frete, em currency (ISO 4217). listPrice é o preço normal que a página risca e aparece quando é maior que price. inStock indica se esse produto está em estoque, e seller é quem o vende.
rating usa uma escala de cinco pontos com duas casas decimais. reviewCount é o número de avaliações.
images lista até 30 fotos da galeria do produto na ordem da página. 11st e Lotte ON retornam só a foto principal, a Sephora até duas, e na Rakuten e no Yahoo! Shopping também vêm os banners ou avisos que o vendedor coloca nessa galeria. description é texto simples com uma linha por parágrafo, com até 10.000 caracteres; o texto que aparece só dentro de imagens não é incluído.
descriptionImages lista 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. Também vêm os banners e avisos que o vendedor coloca na descrição, e o texto dentro das imagens não é lido.
specs lista até 100 pares { name, value } dos detalhes do produto. options lista até 20 escolhas, como tamanho ou cor, cada uma com até 100 values; os demais campos descrevem a escolha com que a página abre. categories vai da categoria mais ampla à mais específica, com até 10 níveis. gtin é o UPC, EAN ou JAN informado na página.
google_shopping lê um produto que o Commerce Search retornou: a url traz a consulta, o ID de produto do Google e o título do produto. A leitura refaz essa consulta no Google Shopping, ou o título quando o Google não mostra mais o produto para a consulta, e abre o painel do produto, por isso leva mais tempo que a página de uma loja. offers lista as lojas que o Google mostra para o produto, começando pela que o Google marca como melhor preço, cada uma com seller, title (o nome do produto na loja), url (a página do produto na loja), price, listPrice, currency e inStock. price, listPrice, seller e inStock do produto são os da primeira loja. reviewCount aparece apenas quando o Google mostra o número exato (menos de 1.000). Se o Google não mostrar o produto em nenhuma das duas buscas, a tarefa termina com PAGE_UNAVAILABLE.
Uma página que a loja responde com 404 ou 410, como um produto removido, encerra a tarefa com PAGE_UNAVAILABLE, e a mensagem traz a resposta da loja. As demais leituras com falha terminam com ENGINE_NO_RESULT. A cobrança se aplica a cada leitura concluída.

Campo	Lojas que o retornam
`title`, `price`, `currency`, `images`	Todas
`brand`	Todas exceto Rakuten
`inStock`	Todas exceto Target e Sephora
`rating`	Todas exceto Lotte ON, Kurly e Zalando
`reviewCount`	Todas exceto Lotte ON e Zalando
`categories`	Todas exceto Sephora, Qoo10, Flipkart e Google Shopping
`description`	Todas exceto 11st e Qoo10. Lotte ON, Musinsa e Olive Young mostram quase toda a descrição em imagens, por isso poucas de suas páginas têm uma. Flipkart e Zalando retornam o resumo curto que publicam para os buscadores.
`descriptionImages`	Amazon, Ulta, 11st, Lotte ON, Musinsa, Kurly, Olive Young, Rakuten, Yahoo! Shopping e Qoo10
`specs`	Amazon, Walmart, Target, Ulta, Lotte ON, Musinsa, Kurly, Myntra, Nykaa e Google Shopping
`options`	Amazon, Walmart, Ulta, Musinsa, Kurly, Olive Young, Rakuten, Myntra, Nykaa e Zalando
`seller`	Amazon, Walmart, Lotte ON, Kurly, Rakuten, Myntra, Nykaa e Google Shopping
`listPrice`	Amazon, Walmart, Target, Sephora, Musinsa, Kurly, Olive Young, Qoo10, Myntra, Nykaa e Google Shopping
`offers`	Google Shopping
`gtin`	Amazon, Walmart, Target, Ulta, Olive Young, Rakuten e Yahoo! Shopping

Primeiros passos

Conceitos principais

Mecanismos de resposta

Busca e dados da web

Opções de requisição

Pesquisa

Monitoramento GEO

Conta e dados

Commerce Product API (COMMERCE_PRODUCT)

Requisição

Parâmetros

Exemplo de resposta

Campos do resultado

Relacionado

​Requisição

​Parâmetros

​Exemplo de resposta

​Campos do resultado

​Relacionado

Requisição

Parâmetros

Exemplo de resposta

Campos do resultado

Relacionado