Compras · Kaufland
API de busca Kaufland
API de busca 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
Buscar no kaufland.de por um termo genérico como “Konsole” retorna uma mistura típica de marketplace: consoles de videogame ao lado de aparadores, milhares de vendedores, cards patrocinados de lojistas que pagaram por visibilidade e uma contagem de resultados que a Kaufland limita a 10.000. A API de busca Kaufland da everydata.io entrega essas páginas de resultados em JSON, uma chamada por página, com as seis ordenações da loja – para que você observe rankings, varra uma categoria por preço ou encontre todos os anúncios de um produto entre vendedores.
- Plataforma
- Kaufland
- Endpoint principal
- /product/search
- Cota por chamada
- 1 requisição
- Plano gratuito
- 100 req. / mêsdepois, a partir de € 30 / mês
API de busca Kaufland: o que ela retorna
Cada resposta começa repetindo a requisição e o estado da paginação: keyword, sortStrategy, numberOfProducts nesta página (normalmente cerca de 40), resultCount conforme informado pela Kaufland, nextPage e lastPage. Uma busca por “Konsole” mostra 10.000 resultados em 250 páginas – o teto da Kaufland, não o tamanho real do sortimento, então trate resultCount como “pelo menos”.
searchProductDetails contém os cards. Cada item traz productDescription (o título do anúncio, muitas vezes longo e cheio de palavras-chave inseridas pelos vendedores), manufacturer, productId, variationId, price e retailPrice em EUR, productRating e countReview quando o anúncio tem avaliações, imgUrl em 200×200, o dpUrl absoluto da página de produto, um deliveryMessage com o prazo de entrega da Kaufland (“Lieferung Fr. 2. - Do. 8. Oktober”) e uma flag sponsored.
- keyword, sortStrategy, numberOfProducts, resultCount, nextPage e lastPage
- Por card: productDescription, manufacturer, productId, variationId, imgUrl e dpUrl absoluto
- price e retailPrice como números – sem parsing de strings
- productRating e countReview quando o anúncio tem avaliações
- deliveryMessage com o intervalo concreto de datas de entrega da oferta padrão
- Flag sponsored para separar posições pagas de lojistas do ranking orgânico
- sortBy: recommended (padrão), price-asc, price-desc, customer-reviews, newest-arrivals, bestsellers
API de busca Kaufland: o que equipes criam com ela
Descoberta de preços entre vendedores
Busque um nome de modelo com price-asc para encontrar o anúncio mais barato entre todos os lojistas e depois abra o dpUrl para ler o soldBy e o custo de frete dessa oferta.
Monitoramento de ranking no marketplace
Vendedores acompanham a posição do seu productId nas palavras-chave principais em recommended e bestsellers e observam como concorrentes patrocinados alteram a ordem orgânica.
Inteligência de sortimento
Consulte periodicamente um termo de categoria com newest-arrivals e compare os productIds para ver quais lojistas adicionam anúncios, quais marcas entram no kaufland.de e com que rapidez novos produtos recebem avaliações.
Benchmarking de prazos de entrega
Agregue o deliveryMessage de um termo para medir os prazos típicos no marketplace e identificar ofertas com prazos de envio incomumente longos.
Alimentação de catálogo
Colete os dpUrls de uma categoria inteira como lista de entrada para o endpoint de produto e monte um dataset estruturado de títulos, vendedores e especificações.
API de busca Kaufland: requisição e resposta de exemplo
Use GET /kfl/product/search com keyword e page (ambos obrigatórios). Adicione sortBy para reproduzir uma ordenação específica da loja. Como o dpUrl da Kaufland já é absoluto, você pode passar cada resultado direto para GET /kfl/product/details para obter o vendedor e a linha de estoque.
GET /kfl/product/search
curl "https://api.everydata.io/kfl/product/search?keyword=Konsole&page=1&sortBy=recommended" \
-H "x-api-key: YOUR_API_KEY"Resposta (resumida)
{
"responseStatus": "PRODUCT_FOUND_RESPONSE",
"responseMessage": "Product successfully found!",
"sortStrategy": "recommended",
"domainCode": "de",
"keyword": "Konsole",
"numberOfProducts": 39,
"resultCount": 10000,
"nextPage": 2,
"lastPage": 250,
"searchProductDetails": [
{
"productDescription": "LITTLE TREE Konsolentisch, Beistelltisch, Flurtisch, Sofatisch für kleinen Raum, Konsolentisch mit Stauraum für Eingang, Flur, Wohnzimmer, Braun",
"manufacturer": "Wanbor",
"productId": "506827780",
"variationId": "506827780",
"countReview": 9,
"imgUrl": "https://media.cdn.kaufland.de/product-images/200x200/2964f233238ba0212891e092d4d59797.jpg",
"price": 109.99,
"retailPrice": 0,
"productRating": "5.0",
"dpUrl": "https://www.kaufland.de/product/506827780/",
"deliveryMessage": "Lieferung Di. 22. - Fr. 25. September",
"sponsored": false
}
]
}
O card de busca não informa o vendedor. Quando você precisar de soldBy, shippingPrice ou da frase de escassez, siga o dpUrl até o endpoint de produto; a camada de busca serve para descoberta e ranking, a camada de detalhes para dados da oferta. Campos que a Kaufland não exibe em um card (productRating em itens sem avaliação, manufacturer para alguns vendedores) simplesmente não aparecem naquela entrada, então programe de forma defensiva.
sortBy=price-asc é a forma mais rápida de encontrar a oferta mais barata de um modelo específico: busque o nome exato do produto, pegue a primeira página e você terá o menor preço entre os vendedores com o respectivo productId. sortBy=bestsellers revela quais anúncios os clientes da Kaufland realmente compram para um termo, independentemente das posições pagas.
Use withCache quando vários jobs consultarem a mesma palavra-chave dentro de uma hora – a página em cache é compartilhada e você reserva as requisições em tempo real para os termos que mudam.
Endpoints relacionados
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.
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.
API de busca Kaufland: preços – pague por requisição
Uma página de busca equivale a uma requisição; uma página retorna até cerca de 40 cards. Acompanhar 40 palavras-chave nas páginas um e dois diariamente dá cerca de 2.400 requisições por mês – folgadamente dentro do Starter (5.000 requisições, € 30). Se você também abrir cada card no endpoint de produto, reserve uma requisição extra por produto; o Production (50.000, € 80) cobre isso em varreduras de porte médio.
- Free
- 100 req. / mês
- Starter
- 5.000 req. · € 30
- Production
- 50.000 req. · € 80
- Business
- 300.000 req. · € 300
API de busca Kaufland: perguntas frequentes
Quais ordenações posso solicitar?
recommended (padrão), price-asc, price-desc, customer-reviews, newest-arrivals e bestsellers – as mesmas opções do menu de ordenação do kaufland.de. sortStrategy na resposta confirma o que foi aplicado.
Por que o resultCount mostra 10.000 para muitos termos?
A Kaufland limita a contagem de resultados informada a 10.000 e a paginação a 250 páginas. Restrinja a keyword (adicione marca ou modelo) para obter uma contagem exata e um número de páginas gerenciável.
A busca informa quem vende o produto?
Não, soldBy só está disponível na página de produto. Chame GET /kfl/product/details com o dpUrl do card para ver o lojista, o shippingPrice e a frase de estoque.
Posso buscar dentro de uma categoria ou filtrar por marca?
O endpoint aceita keyword, page e sortBy. Coloque a marca ou o termo da categoria na keyword e filtre manufacturer ou preço do seu lado a partir dos campos retornados.
Os anúncios patrocinados são marcados?
Sim, cada card traz sponsored: true ou false na posição em que a Kaufland o exibe, para que você possa calcular o ranking orgânico filtrando.
Casos de uso relacionados
Faça sua primeira busca no kaufland.de
Conta gratuita, uma requisição GET, uma página de resultados completa em JSON – ordenada do jeito que seus compradores ordenam.