> ## Documentation Index > Fetch the complete documentation index at: https://docs.querying.ai/llms.txt > Use this file to discover all available pages before exploring further. # Commerce Product API (COMMERCE_PRODUCT) > Leia uma página de produto da Amazon, Walmart, Target, Sephora, Ulta, Olive Young, 11st, Musinsa, Kurly, Rakuten, Flipkart, Zalando e outras lojas e receba preço, estoque, vendedor, avaliação, imagens, especificações e opções no mesmo formato. 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 ```bash theme={"theme":"css-variables"} 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](/pt/concepts/async-tasks.md). ## 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](/pt/engines/commerce-serp.md) 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 ```json theme={"theme":"css-variables"} { "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](/pt/engines/commerce-serp.md) 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 | ## Relacionado * [Commerce Search](/pt/engines/commerce-serp.md) * [Visão geral dos motores](/pt/engines/overview.md) * [Créditos e limites](/pt/concepts/credits-and-limits.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.