Compras · Kaufland
API de búsqueda de Kaufland
La API de búsqueda de Kaufland te da datos de Kaufland en tiempo real en el momento en que los pides, limpios y estructurados, listos para tu propia app, una hoja de cálculo o un asistente de IA. Sin scraping, nada que mantener.
100 solicitudes gratis al mes · sin tarjeta de crédito · una clave de API para todas las plataformas
Datos clave
Actualizado el
Buscar en kaufland.de un término genérico como "Konsole" devuelve una mezcla típica de marketplace: videoconsolas junto a mesas consola, miles de vendedores, resultados patrocinados de comerciantes que pagaron por visibilidad y un número de resultados que Kaufland limita a 10.000. La API de búsqueda de Kaufland de everydata.io devuelve esas páginas de resultados en JSON, una llamada por página, con los seis órdenes de la tienda, para que puedas observar rankings, barrer una categoría por precio o encontrar todos los anuncios de un producto entre distintos vendedores.
- Plataforma
- Kaufland
- Endpoint principal
- /product/search
- Cuota por llamada
- 1 solicitud
- Plan gratuito
- 100 solicitudes / mesdespués, desde 30 € / mes
Qué devuelve la API de búsqueda de Kaufland
Cada respuesta empieza con el eco de la solicitud y el estado de la paginación: keyword, sortStrategy, numberOfProducts en esta página (normalmente unos 40), resultCount según Kaufland, nextPage y lastPage. Una búsqueda de "Konsole" muestra 10.000 resultados en 250 páginas: es el límite de Kaufland, no el tamaño real del surtido, así que interpreta resultCount como "al menos".
searchProductDetails contiene los resultados. Cada elemento incluye productDescription (el título del anuncio, a menudo largo y lleno de palabras clave puestas por los vendedores), manufacturer, productId, variationId, price y retailPrice en EUR, productRating y countReview cuando el anuncio tiene valoraciones, imgUrl en 200×200, el dpUrl absoluto de la página del producto, un deliveryMessage con el plazo de entrega de Kaufland ("Lieferung Fr. 2. - Do. 8. Oktober") y un indicador sponsored.
- keyword, sortStrategy, numberOfProducts, resultCount, nextPage y lastPage
- Por resultado: productDescription, manufacturer, productId, variationId, imgUrl y dpUrl absoluto
- price y retailPrice como números, sin analizar cadenas
- productRating y countReview cuando el anuncio tiene reseñas
- deliveryMessage con el rango concreto de fechas de entrega de la oferta por defecto
- Indicador sponsored para separar las posiciones de pago de los comerciantes del ranking orgánico
- sortBy: recommended (por defecto), price-asc, price-desc, customer-reviews, newest-arrivals, bestsellers
Lo que los equipos construyen con la API de búsqueda de Kaufland
Descubrimiento de precios entre vendedores
Busca el nombre de un modelo con price-asc para encontrar el anuncio más barato entre todos los comerciantes y abre después dpUrl para leer el soldBy y los gastos de envío de esa oferta.
Seguimiento de posiciones en el marketplace
Los vendedores siguen la posición de su productId para sus palabras clave principales con recommended y bestsellers y observan cómo los competidores patrocinados alteran el orden orgánico.
Inteligencia de surtido
Consulta periódicamente un término de categoría con newest-arrivals y compara los productId para ver qué comerciantes añaden anuncios, qué marcas llegan a kaufland.de y lo rápido que los productos nuevos reciben reseñas.
Comparativa de plazos de entrega
Agrega deliveryMessage de todo un término para medir los plazos de entrega habituales en el marketplace y detectar ofertas con plazos de envío inusualmente largos.
Base de partida para el catálogo
Recopila los dpUrl de toda una categoría como lista de entrada para el endpoint de producto y construye un conjunto de datos estructurado de títulos, vendedores y especificaciones.
API de búsqueda de Kaufland: solicitud y respuesta de ejemplo
Usa GET /kfl/product/search con keyword y page (ambos obligatorios). Añade sortBy para reproducir un orden concreto de la tienda. Como el dpUrl de Kaufland ya es absoluto, puedes pasar cada resultado directamente a GET /kfl/product/details para obtener el vendedor y la línea de stock.
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"Respuesta (abreviada)
{
"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
}
]
}
El resultado de búsqueda no nombra al vendedor. Cuando necesites soldBy, shippingPrice o la frase de escasez, sigue dpUrl hasta el endpoint de producto; la capa de búsqueda sirve para descubrir y rankear, la de detalle para los datos de la oferta. Los campos que Kaufland no muestra en un resultado (productRating en artículos sin valoraciones, manufacturer en algunos vendedores) simplemente no aparecen en esa entrada, así que programa de forma defensiva.
sortBy=price-asc es la forma más rápida de encontrar la oferta más barata de un modelo concreto: busca el nombre exacto del producto, toma la página uno y tendrás el precio más bajo entre vendedores con su productId. sortBy=bestsellers revela qué anuncios compran de verdad los clientes de Kaufland para un término, con independencia de las posiciones de pago.
Usa withCache cuando varios procesos consulten la misma palabra clave en una hora: la página en caché se comparte y reservas las solicitudes en tiempo real para los términos que cambian.
Endpoints relacionados
Buscar productos. Búsqueda por palabra clave con paginación y ordenación: precio, valoración, plazo de entrega e indicador de patrocinado en cada resultado.
Detalles del producto. Página de producto por URL: oferta principal con vendedor, precio, envío, línea de stock, variantes, especificaciones e imágenes.
Reseñas. Reseñas de clientes paginadas por ID de producto de Kaufland.
Precios de la API de búsqueda de Kaufland: paga por solicitud
Una página de búsqueda equivale a una solicitud; una página devuelve hasta unos 40 resultados. Seguir 40 palabras clave en las páginas uno y dos cada día supone unas 2400 solicitudes al mes, holgadamente dentro de Starter (5000 solicitudes, 30 €). Si además abres cada resultado en el endpoint de producto, calcula una solicitud extra por producto; Production (50.000, 80 €) lo cubre para barridos medianos.
- Free
- 100 solicitudes / mes
- Starter
- 5000 solicitudes · 30 €
- Production
- 50.000 solicitudes · 80 €
- Business
- 300.000 solicitudes · 300 €
API de búsqueda de Kaufland: preguntas frecuentes
¿Qué órdenes puedo solicitar?
recommended (por defecto), price-asc, price-desc, customer-reviews, newest-arrivals y bestsellers: las mismas opciones que el menú de ordenación de kaufland.de. sortStrategy en la respuesta confirma cuál se aplicó.
¿Por qué resultCount muestra 10.000 en muchos términos?
Kaufland limita el número de resultados indicado a 10.000 y el paginador a 250 páginas. Acota la palabra clave (añade marca o modelo) para obtener un recuento exacto y un número de páginas manejable.
¿La búsqueda me dice quién vende el producto?
No, soldBy solo está disponible en la página del producto. Llama a GET /kfl/product/details con el dpUrl del resultado para ver el comerciante, shippingPrice y la frase de stock.
¿Puedo buscar dentro de una categoría o filtrar por marca?
El endpoint recibe keyword, page y sortBy. Incluye la marca o el término de categoría en la palabra clave y filtra manufacturer o precio en tu lado a partir de los campos devueltos.
¿Los anuncios patrocinados están marcados?
Sí, cada resultado lleva sponsored: true o false en la posición en que lo muestra Kaufland, así que puedes calcular el ranking orgánico filtrando.
Casos de uso relacionados
Lanza tu primera búsqueda en kaufland.de
Cuenta gratuita, una solicitud GET y una página de resultados completa en JSON, ordenada como la ordenan tus compradores.