Compras · Walmart
API de produtos Walmart
API de produtos Walmart: dados ao vivo de Walmart no momento em que você pede, limpos e estruturados – prontos para seu próprio app, uma planilha ou um assistente de IA. Sem scraping, nada para manter.
100 requisições grátis por mês · sem cartão de crédito · uma chave de API para todas as plataformas
Fatos principais
Atualizado em
O walmart.com monta cada página de produto a partir de um grande objeto de dados que contém preço, status de estoque, vendedor, promessa de entrega, imagens, matriz de variantes, especificações e estatísticas de avaliações. A API de produtos Walmart da everydata.io busca essa página em tempo real e entrega o objeto de dados completo em JSON – nada em cache, nada resumido. Você passa a URL do produto no formato https://www.walmart.com/ip/<slug>/<usItemId>; o usItemId no final é o número público do item no Walmart e o mesmo id que você usará depois no endpoint de avaliações.
- Plataforma
- Walmart
- Endpoint principal
- /walmart-lookup-product
- Cota por chamada
- 1 requisição
- Plano gratuito
- 100 req. / mêsdepois, a partir de € 30 / mês
Dados de Walmart, prontos para usar
A resposta é um invólucro simples: responseStatus e responseMessage no topo e, em seguida, item, que é o próprio payload da página do Walmart. Os dados de produto que interessam ficam em item.props.pageProps.initialData.data. Ali, product reúne os dados comerciais – name, brand, usItemId, availabilityStatus (IN_STOCK, OUT_OF_STOCK …), priceInfo.currentPrice com o preço numérico e currencyUnit, listPrice e savingsAmount quando o Walmart mostra um preço riscado, sellerName / sellerDisplayName e sellerAverageRating para vendedores do marketplace, e fulfillmentType (FC para itens enviados pelo Walmart, STORE para retirada na loja; caso contrário, envio pelo vendedor do marketplace).
Ao lado de product, você recebe idml com longDescription, specifications, productHighlights, warnings, nutritionFacts e videos, e reviews com averageOverallRating, totalReviewCount, os cinco contadores ratingValue*Count e a principal avaliação positiva / negativa incorporada. Como o objeto é o do próprio Walmart, ele também traz dados raros em APIs condensadas: variantCriteria com cada cor e tamanho e sua disponibilidade, imageInfo.allImages em resolução ampliável, category.path como breadcrumb, returnPolicy, orderLimit e a promessa de entrega deliveryDate para a localização padrão.
- product.name, brand, usItemId, canonicalUrl e o breadcrumb da categoria (category.path)
- priceInfo.currentPrice.price e currencyUnit como números, além de listPrice / savingsAmount / isPriceReduced
- availabilityStatus, fulfillmentType, fulfillmentBadge (ex.: "2 days") e shippingOption.deliveryDate
- sellerName, sellerDisplayName, sellerId, sellerAverageRating e sellerReviewCount – Walmart.com ou um vendedor do marketplace
- variantCriteria com cada variante de cor/tamanho, seu usItemId e availabilityStatus
- idml.specifications, longDescription, productHighlights e imageInfo.allImages
- Bloco reviews com averageOverallRating, totalReviewCount e contagens por número de estrelas
O que equipes criam com isso
Comparação de preços omnichannel
Varejistas e marcas comparam o preço atual, o preço de tabela e o desconto do Walmart com Amazon, Target ou a própria loja – item a item, com o nome do vendedor para separar preços do Walmart como vendedor direto dos preços do marketplace.
Monitoramento de vendedores em marketplaces
Vendedores do Walmart Marketplace consultam novamente os próprios anúncios para confirmar que detêm a buy box, que fulfillmentType e a promessa de entrega estão como esperado e que nenhum vendedor não autorizado apareceu no item.
Enriquecimento de catálogo
Use product.name, brand, idml.specifications, longDescription e imageInfo.allImages para enriquecer registros de produto incompletos ou para associar itens do Walmart aos seus próprios SKUs pelo manufacturerProductId.
Monitoramento de estoque e sortimento
Acompanhe availabilityStatus e variantCriteria ao longo do tempo para ver quais cores ou tamanhos se esgotam primeiro e quando o Walmart retira um item do catálogo.
Requisição e resposta de exemplo
Chame GET /wlm/walmart-lookup-product com a URL completa do produto. Qualquer URL de item do walmart.com funciona – com ou sem parâmetros de rastreamento –, desde que termine no usItemId numérico. O exemplo abaixo está resumido: o objeto item real tem centenas de chaves em vários níveis, e só o objeto product tem mais de 180 campos.
GET /wlm/walmart-lookup-product
curl "https://api.everydata.io/wlm/walmart-lookup-product?url=https%3A%2F%2Fwww.walmart.com%2Fip%2FPatPat-Mommy-and-Me-100-Cotton-Matching-Dresses-for-Women-Girls-One-Piece%2F115632287" \
-H "x-api-key: YOUR_API_KEY"Resposta (resumida)
{
"responseStatus": "PRODUCT_FOUND_RESPONSE",
"responseMessage": "Product successfully found!",
"item": {
"page": "/ip/[...itemParams]",
"query": {
"itemParams": [
"PatPat-Mommy-and-Me-100-Cotton-Matching-Dresses-for-Women-Girls-One-Piece",
"115632287"
]
},
"buildId": "production_20260917T021715375Z-en-US",
"locale": "en",
"props": {
"pageProps": {
"initialData": {
"data": {
"product": {
"usItemId": "115632287",
"name": "PatPat Mommy and Me 100% Cotton Matching Dresses for Women/Girls,One Piece",
"brand": "PatPat",
"availabilityStatus": "IN_STOCK",
"canonicalUrl": "/ip/PatPat-Mommy-and-Me-100-Cotton-Matching-Dresses-for-Women-Girls-One-Piece/115632287",
"priceInfo": {
"currentPrice": {
"price": 17.99,
"priceString": "$17.99",
"currencyUnit": "USD"
},
"isPriceReduced": false,
"listPrice": null
},
"sellerName": "Interfocus INC",
"sellerDisplayName": "PatPat",
"sellerAverageRating": 4.1663,
"fulfillmentType": "FC",
"fulfillmentBadge": "2 days",
"returnPolicy": {
"returnable": true,
"freeReturns": true,
"returnPolicyText": "Free 90-day returns"
},
"variantCriteria": [
{
"id": "actual_color",
"name": "Color",
"type": "SWATCH"
}
]
},
"idml": {
"specifications": [],
"productHighlights": [],
"videos": []
},
"reviews": {
"averageOverallRating": 0,
"totalReviewCount": 0,
"customerReviews": []
}
}
}
}
}
}
}Navegue por um caminho fixo: item.props.pageProps.initialData.data.product é o objeto que seu código deve mapear. Faça o mapeamento de forma defensiva – o Walmart adiciona e renomeia chaves no próprio payload de tempos em tempos, e blocos opcionais como listPrice ou nutritionFacts vêm como null quando a página não os exibe. Os nomes de campos acima são do Walmart, não nossos; não renomeamos nada.
No Walmart, preços e estoque dependem da localização. O payload inclui um bloco location com o postalCode e os storeIds para os quais a página foi gerada, então você sempre sabe a que contexto de loja um preço pertence. Um produto que o Walmart mostra como disponível apenas na loja retorna fulfillmentType STORE e detalhes de retirada em vez de uma promessa de entrega.
Um usItemId errado ou truncado retorna 404 com uma statusMessage que indica o parâmetro; um bloqueio ou timeout do lado do Walmart resulta em 502/503 e não consome sua cota. O tamanho da resposta costuma ser de algumas centenas de kilobytes – se você só precisa de preço e estoque, extraia esses dados e descarte o resto em vez de armazenar páginas inteiras.
Endpoints relacionados
Detalhes do produto. Página de produto por URL.
Avaliações. Avaliações de clientes paginadas de um produto.
Buscar produtos. Busca por palavra-chave com paginação e ordenação.
Pague por requisição, todas as plataformas incluídas
Uma página de produto equivale a uma requisição, independentemente do tamanho do payload. O plano gratuito (100 requisições por mês) basta para examinar a estrutura dos itens que interessam; o Starter (5.000 requisições, € 30) atualiza diariamente uma lista de monitoramento de cerca de 160 itens, e o Production (50.000, € 80), cerca de 1.600. Erros 5xx do lado do Walmart nunca são cobrados.
- Free
- 100 req. / mês
- Starter
- 5.000 req. · € 30
- Production
- 50.000 req. · € 80
- Business
- 300.000 req. · € 300
API de produtos Walmart: perguntas frequentes
Qual formato de URL o endpoint de produtos Walmart aceita?
Qualquer URL de item do walmart.com que termine no usItemId, normalmente https://www.walmart.com/ip/<slug>/<usItemId>. Parâmetros de consulta extras, como athbdg, são ignorados.
Onde fica o preço na resposta?
Em item.props.pageProps.initialData.data.product.priceInfo.currentPrice – price é um número e currencyUnit é USD. listPrice, savingsAmount e isPriceReduced descrevem um preço riscado, quando o Walmart exibe um.
A API retorna vendedores do marketplace?
Sim. sellerName é a razão social do vendedor (por exemplo, Interfocus INC), sellerDisplayName é o nome da loja exibido aos compradores, e sellerAverageRating / sellerReviewCount são a avaliação do próprio vendedor. Itens vendidos pelo próprio Walmart mostram Walmart.com.
Por que a resposta é tão grande?
Você recebe o objeto de dados completo da página do Walmart em vez de um subconjunto selecionado, então nada se perde. Mapeie do seu lado as poucas chaves de que precisa; só o objeto product tem mais de 180 campos.
Posso obter páginas de produto do walmart.ca?
O endpoint de produtos atende atualmente o walmart.com. O endpoint de avaliações aceita domainCode com ou ca, então dados de avaliações canadenses estão disponíveis por usItemId.
Existe cache?
Não – cada consulta de produto busca a página ao vivo. Se você precisa de uma frequência de atualização mais barata, consulte com menos frequência; a resposta informa exatamente de qual contexto de loja e de qual build a página veio.
Casos de uso relacionados
Busque sua primeira página de produto do Walmart
Cadastre-se gratuitamente, copie sua chave de API e cole qualquer URL de item do walmart.com no endpoint de produtos. 100 requisições por mês sem custo.