Compras · Kaufland
API de dados de produtos Kaufland
API de dados de produtos Kaufland: dados ao vivo de Kaufland 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 kaufland.de não é uma loja de um único varejista. Por trás da maioria das páginas de produto há um lojista terceiro – a página nomeia o vendedor em uma linha “Verkauf durch …”, vários vendedores podem disputar o mesmo artigo, e um Nintendo Switch Lite turquesa tem um id de produto diferente do mesmo console em amarelo. A API de dados de produtos Kaufland da everydata.io recebe uma URL kaufland.de/product/<id>/ e retorna o anúncio em um único documento JSON, incluindo o vendedor que detém a oferta no momento, o aviso de estoque, a tabela de especificações e cada variante de cor com sua própria URL de produto.
- Plataforma
- Kaufland
- Endpoint principal
- /product/details
- Cota por chamada
- 1 requisição
- Plano gratuito
- 100 req. / mêsdepois, a partir de € 30 / mês
API de dados de produtos Kaufland: o que ela retorna
A resposta traz primeiro a identificação do produto: productTitle, manufacturer, productId (o id numérico da Kaufland, repetido como asin para manter a compatibilidade com nossos outros endpoints de varejo) e a url canônica. productRating e countReview refletem o agregado – 4,7 com 57 avaliações no exemplo abaixo –, enquanto productDescription e a lista chave/valor productDetails (Modell, Hersteller, Maße, Lieferumfang) contêm o conteúdo em alemão enviado pelo vendedor.
O contexto de marketplace é onde a Kaufland se diferencia da Otto ou da Lidl. soldBy nomeia o lojista por trás da oferta atual, warehouseAvailability traz a frase de escassez ou de estoque que a Kaufland exibe – “Nur noch 1 zu diesem Preis” ou “Nur noch 5 Stück auf Lager” – e price e shippingPrice descrevem a oferta desse lojista em EUR. imageUrlList lista imagens do media.cdn.kaufland.de em 1024×1024.
variations agrupa a dimensão de cor ou tamanho (variationName “Farbe”), e cada valor traz seu próprio dpUrl, asin, flag available, imagem e, quando o vendedor define, price. Como a Kaufland cria uma página de produto separada para cada variante, o dpUrl é o que você passa na chamada seguinte para cobrir a família inteira.
- productTitle, manufacturer, productDescription e a tabela de especificações productDetails
- soldBy – o lojista do marketplace por trás da oferta exibida
- warehouseAvailability com as mensagens de estoque e escassez da Kaufland
- price e shippingPrice como campos numéricos em EUR, retailPrice quando há preço riscado
- productRating e countReview agregados de todo o anúncio
- imageUrlList e mainImage do media.cdn.kaufland.de
- variations[] com dpUrl, asin, available, imageUrl e price por variante
API de dados de produtos Kaufland: o que equipes criam com ela
Monitoramento de vendedores em marketplaces
Marcas consultam novamente seu catálogo no kaufland.de para ver qual lojista detém cada oferta no momento, se aparecem revendedores não autorizados e se o conteúdo do produto foi alterado.
Correspondência de catálogo para cross-listing
Vendedores que anunciam na Amazon ou na Otto comparam seus artigos com os anúncios do kaufland.de por título, fabricante, productDetails e imagens antes de criar ou assumir uma oferta.
Rastreamento de famílias de variantes
Comece por uma cor e siga cada dpUrl em variations[] para coletar preço, disponibilidade e vendedor de toda a família de produtos com poucas requisições.
Feeds para comparadores de preços
Sites de comparação de preços exibem a oferta do kaufland.de com o nome do vendedor, o custo de frete e a linha de escassez, para que os usuários entendam por que uma oferta está barata e quanto tempo ela pode durar.
API de dados de produtos Kaufland: requisição e resposta de exemplo
Chame GET /kfl/product/details com a URL do produto. A forma curta https://www.kaufland.de/product/<id>/ é suficiente; a URL longa do navegador, com id_unit e parâmetros de rastreamento, também funciona. Só são necessárias requisições GET – sem sessão, sem cookies, sem configuração de proxy.
GET /kfl/product/details
curl "https://api.everydata.io/kfl/product/details?url=https%3A%2F%2Fwww.kaufland.de%2Fproduct%2F461878680%2F" \
-H "x-api-key: YOUR_API_KEY"Resposta (resumida)
{
"responseStatus": "PRODUCT_FOUND_RESPONSE",
"responseMessage": "Product successfully found!",
"productTitle": "Nintendo Switch Lite Türkis (Japan-Spec)",
"manufacturer": "Nintendo",
"countReview": 57,
"productRating": "4.7",
"productId": "461878680",
"variationId": "461878680",
"url": "https://www.kaufland.de/product/461878680/",
"soldBy": "Verkauf durch Schnaeppchen-Schuppen",
"warehouseAvailability": "Nur noch 1 zu diesem Preis",
"retailPrice": 0,
"price": 219,
"shippingPrice": 0,
"imageUrlList": [
"https://media.cdn.kaufland.de/product-images/1024x1024/da0ffe417ca13e74d7587ea5a9a3467f.jpg"
],
"productDetails": [
{
"name": "Modell",
"value": "Switch Lite"
},
{
"name": "Hersteller",
"value": "Nintendo"
}
],
"variations": [
{
"variationName": "Farbe",
"values": [
{
"value": "Gelb",
"dpUrl": "https://www.kaufland.de/product/461878683/",
"selected": false,
"available": true,
"retailPrice": 0,
"asin": "461878683"
}
]
}
]
}
soldBy é o campo a conferir antes de confiar em um preço. A Kaufland exibe por padrão a oferta elegível mais barata, então o vendedor pode mudar entre duas chamadas enquanto o productId continua o mesmo; a frase inclui o nome da loja exatamente como a Kaufland o exibe (“Verkauf durch gobuytech”). sellerId está presente, mas é curto e nem sempre significativo – use o nome em soldBy como chave da sua tabela de vendedores.
warehouseAvailability é uma frase de texto livre, não um número. “Nur noch 1 zu diesem Preis” significa que a oferta atual é limitada, não que o produto esteja quase esgotado – outro vendedor pode anunciar mais unidades por um preço maior. Extraia o dígito se precisar de uma quantidade, mas guarde também o texto original.
Se o id não existir, você recebe um 404 com statusMessage "not found for parameter". manufacturer pode ser null quando o vendedor não o preencheu, e imageUrlList pode vir vazio em anúncios pobres – ambos refletem fielmente a página, não são falhas do parser.
Endpoints relacionados
Detalhes do produto. Página de produto por URL: oferta padrão com vendedor, preço, frete, informação de estoque, variantes, especificações e imagens.
Avaliações. Avaliações de clientes paginadas por ID de produto da Kaufland.
Buscar produtos. Busca por palavra-chave com paginação e ordenação: preço, nota, prazo de entrega e indicação de patrocinado por resultado.
API de dados de produtos Kaufland: preços – pague por requisição
Uma página de produto é uma requisição, independentemente do número de vendedores ou de variantes. As 100 requisições por mês do plano gratuito cobrem a prototipagem; o Starter (5.000 requisições, € 30) atualiza cerca de 160 anúncios da Kaufland por dia, o Production (50.000, € 80) cerca de 1.600 e o Business (300.000, € 300) aproximadamente 10.000. Respostas 5xx do site de origem nunca são cobradas.
- Free
- 100 req. / mês
- Starter
- 5.000 req. · € 30
- Production
- 50.000 req. · € 80
- Business
- 300.000 req. · € 300
API de dados de produtos Kaufland: perguntas frequentes
A resposta lista todos os vendedores de um produto?
Ela retorna a oferta que a Kaufland exibe como padrão – normalmente a mais barata – com seu soldBy, price e shippingPrice. As ofertas dos demais vendedores não são enumeradas; consultas ao longo do tempo mostram quais lojistas conquistam a posição padrão.
Qual formato de URL devo enviar?
https://www.kaufland.de/product/<productId>/ is enough. Long URLs with id_unit or campaign parameters are accepted and normalised into the url field of the response.
Variantes de cor ou tamanho são produtos separados?
Sim. Cada variante tem seu próprio productId e sua própria página; o array variations traz todas as variantes irmãs com dpUrl, asin e available, para que você possa consultá-las individualmente.
A Kaufland está disponível apenas para a Alemanha?
Este endpoint cobre o kaufland.de, o marketplace alemão, com preços em EUR com IVA incluído e conteúdo em alemão. Não há parâmetro domainCode.
Onde obtenho as avaliações de clientes?
GET /kfl/product/reviews com productId e um page opcional retorna as avaliações com nota, título, texto, data, a variante que o avaliador comprou e uma flag de compra verificada.
Casos de uso relacionados
Consulte seu primeiro produto do kaufland.de
Cadastre-se gratuitamente, cole uma URL de produto do kaufland.de e receba vendedor, preço, linha de estoque e variantes em JSON – 100 requisições por mês incluídas.