Compras · Lidl
API de busca Lidl
API de busca Lidl: dados ao vivo de Lidl 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
A busca do lidl.de se comporta como a prateleira de um supermercado de desconto: um termo como "schuhe" retorna algumas centenas de artigos, e não dezenas de milhares, o conjunto muda toda semana conforme as campanhas começam e terminam, e boa parte da lista já está com desconto e preço riscado. A API de busca Lidl da everydata.io retorna essas páginas de resultados em JSON com paginação, sete ordenações e a flag de disponibilidade por card – ideal para identificar novas promoções, varrer uma categoria por preço ou alimentar um monitor de ofertas semanais.
- Plataforma
- Lidl
- Endpoint principal
- /search-by-keyword
- Cota por chamada
- 1 requisição
- Plano gratuito
- 100 req. / mêsdepois, a partir de € 30 / mês
API de busca Lidl: o que ela retorna
O envelope traz keyword, sortStrategy, numberOfProducts desta página (cerca de 48 a 50 cards), resultCount da busca inteira (320 para "schuhe"), nextPage e lastPage. Como o sortimento da Lidl é menor, muitas vezes você chega à última página em quatro a sete chamadas, o que torna as varreduras completas baratas.
searchProductDetails lista cada card com productDescription (o nome do artigo, por exemplo "LUPILU® Kinder Hausschuhe"), manufacturer quando a Lidl mostra uma marca, productId, price e retailPrice em EUR (um chinelo de 4,99 riscado de 7,99), productRating e countReview quando o artigo tem avaliações, imgUrl, a dpUrl absoluta, deliveryMessage ("lieferbar"), uma flag sponsored e available – um booleano que mostra na hora se o card ainda pode ser comprado.
- keyword, sortStrategy, numberOfProducts, resultCount, nextPage e lastPage
- Por card: productDescription, manufacturer, productId, imgUrl e dpUrl absoluta
- price e retailPrice como números, para encontrar artigos com desconto com uma única comparação
- Booleano available e deliveryMessage por card
- productRating e countReview para filtrar por avaliações
- Flag sponsored para posições pagas
- sortBy: relevancy (padrão), price, price-desc, ratingScore-desc, deliveryStartDate-desc, sh_carts-desc, discountPercentage-desc
API de busca Lidl: o que equipes criam com ela
Descoberta de promoções semanais
Comunidades de ofertas consultam termos de categoria com sortBy=deliveryStartDate-desc toda manhã e publicam artigos recém-listados de Parkside, Silvercrest ou Livarno poucas horas depois de entrarem no ar.
Varreduras de descontos
Ordene por discountPercentage-desc e compare price com retailPrice para listar todos os artigos com desconto no momento, classificados pelo tamanho da redução.
Monitoramento de esgotamento
Execute um termo novamente e observe a flag available: artigos que passam para false mostram quais promoções esgotaram primeiro – um sinal valioso para compradores e para sites de comparação que devem parar de linkar para eles.
Pesquisa de faixas de preço por categoria
Percorra uma busca com price e price-desc para delimitar as ofertas mais baratas e mais caras de um tipo de produto no sortimento da Lidl e compare com outras redes de desconto.
Alimentação de crawls de produtos
Use a busca como ponto de entrada para coletar dpUrls e depois chame o endpoint de produto para obter especificações, imagens e custo de frete enquanto os artigos ainda estão online.
API de busca Lidl: requisição e resposta de exemplo
Chame GET /ldl/search-by-keyword com keyword e page; adicione sortBy para mudar a ordem. As chaves de ordenação são os nomes internos da Lidl: price é crescente, price-desc decrescente, ratingScore-desc os mais bem avaliados primeiro, discountPercentage-desc os maiores descontos primeiro e sh_carts-desc os artigos mais adicionados ao carrinho.
GET /ldl/search-by-keyword
curl "https://api.everydata.io/ldl/search-by-keyword?keyword=schuhe&page=1&sortBy=relevancy" \
-H "x-api-key: YOUR_API_KEY"Resposta (resumida)
{
"responseStatus": "PRODUCT_FOUND_RESPONSE",
"responseMessage": "Product successfully found!",
"sortStrategy": "relevancy",
"domainCode": "de",
"keyword": "schuhe",
"numberOfProducts": 48,
"resultCount": 320,
"nextPage": 2,
"lastPage": 7,
"searchProductDetails": [
{
"productDescription": "Kinder Hausschuhe",
"productId": "100412669",
"countReview": 0,
"imgUrl": "https://www.lidl.de/assets/gcp5772f230ed84466bb1db79a62f6026b0.jpg",
"price": 4.99,
"retailPrice": 7.99,
"productRating": "",
"dpUrl": "https://www.lidl.de/p/kinder-hausschuhe/p100412669",
"deliveryMessage": "lieferbar",
"sponsored": false,
"available": true
},
{
"productDescription": "LUPILU® Kinder Hausschuhe",
"manufacturer": "LUPILU®",
"productId": "100409128",
"countReview": 0,
"imgUrl": "https://www.lidl.de/assets/gcp2b59f2b509604dcc9edba429d4829714.jpg",
"price": 8.99,
"retailPrice": 0,
"productRating": "",
"dpUrl": "https://www.lidl.de/p/lupilu-kinder-hausschuhe/p100409128",
"deliveryMessage": "lieferbar",
"sponsored": false,
"available": true
}
]
}
Os resultados de busca do lidl.de não trazem shippingPrice nem bullets de características; para isso, abra a dpUrl com GET /ldl/lookup-product-details. productRating volta como string vazia quando um artigo ainda não tem notas – comum em itens novos de campanha –, então trate "" como null, e não como zero estrelas.
Como uma busca por palavra-chave é pequena, o crawl completo de um termo leva poucas requisições. Combine sortBy=discountPercentage-desc com um termo amplo para listar as maiores reduções da semana, ou deliveryStartDate-desc para ver quais artigos foram listados mais recentemente. Se você executa o mesmo termo de hora em hora, passe withCache para que chamadas repetidas compartilhem uma única busca na origem.
Endpoints relacionados
Buscar produtos. Busca por palavra-chave com paginação e ordenação: preço, marca e status de entrega por artigo.
Detalhes do produto. Página de produto por URL: título, marca, preço, frete, nota, especificações e imagens.
Avaliações. Avaliações paginadas e ordenáveis por número de artigo da Lidl.
API de busca Lidl: preços – pague por requisição
Uma página de resultados é uma requisição e contém cerca de 50 cards, então uma varredura completa de "schuhe" custa sete requisições. Monitorar 30 termos duas vezes ao dia em duas páginas dá cerca de 3.600 requisições por mês – dentro do plano Starter (€ 30). Combine com consultas de produto para os cards que mudaram, e o Production (50.000 requisições, € 80) atende à maioria dos monitores.
- Free
- 100 req. / mês
- Starter
- 5.000 req. · € 30
- Production
- 50.000 req. · € 80
- Business
- 300.000 req. · € 300
API de busca Lidl: perguntas frequentes
Quais valores de sortBy estão disponíveis?
relevancy (padrão), price, price-desc, deliveryStartDate-desc, ratingScore-desc, sh_carts-desc e discountPercentage-desc. A ordem aplicada é devolvida em sortStrategy.
A busca mostra se um artigo está esgotado?
Sim. Cada card traz available true/false e uma deliveryMessage como "lieferbar". Itens promocionais esgotados muitas vezes continuam no índice por um tempo com available: false.
Posso buscar apenas dentro da Parkside ou de outra marca própria?
Coloque a marca na keyword ("Parkside Akku") – a busca da Lidl reconhece nomes de marcas – e filtre o campo manufacturer no lado do cliente para descartar outros fornecedores.
Quantos resultados o lidl.de retorna por termo?
Bem menos que um marketplace: centenas, e não milhares, para termos genéricos. numberOfProducts fica em cerca de 48 a 50 por página; lastPage informa a profundidade total.
O custo de frete faz parte da resposta da busca?
Não. shippingPrice, features e a tabela de especificações estão na página do produto; chame GET /ldl/lookup-product-details com a dpUrl do card.
Casos de uso relacionados
Faça sua primeira busca no lidl.de
Crie uma conta gratuita e obtenha uma página completa de resultados do lidl.de em JSON com uma única requisição GET – 100 requisições por mês incluídas.