Superfudis API

Acceso estructurado a comparaciones de precios

Superfudis ofrece una API pública para consultar productos y comparar precios entre supermercados en España mediante descripciones en lenguaje natural.

La API está pensada para consultas de consumidores y asistentes que actúan en nombre de consumidores. No está destinada a la extracción masiva del catálogo ni a la redistribución comercial de los datos.

Qué permite hacer

Buscar productos a partir de lenguaje natural.
Comparar precios entre supermercados.
Identificar el mismo producto o alternativas compatibles.
Comparar una cesta de hasta 10 productos.
Obtener un enlace a Superfudis con la cesta preparada.

Supermercados

La disponibilidad depende del catálogo actual de Superfudis. Actualmente se comparan, entre otros:

Mercadona
Carrefour
Dia
Consum
Eroski
El Corte Inglés

Endpoint principal


            POST https://supercomparador-i9tw.onrender.com/api/v1/compare-basket

curl -X POST \
  https://supercomparador-i9tw.onrender.com/api/v1/compare-basket \
  -H 'Content-Type: application/json' \
  -d '{
    "items": [
      {
        "query": "Coto de Imaz Reserva 750 ml",
        "quantity": 1
      }
    ],
    "retailers": [
      "Mercadona",
      "Carrefour",
      "Dia",
      "Consum"
    ],
    "include_delivery": false
  }'

Límites de uso

Máximo 10 productos por petición.
Máximo 3 peticiones por minuto e IP.
No se ofrece un endpoint para descargar el catálogo completo.

Precios y disponibilidad

Los precios reflejan la información disponible en Superfudis y pueden cambiar cuando el supermercado actualiza sus datos.

La disponibilidad, promociones y precio definitivo de compra deben confirmarse en el supermercado correspondiente.

Documentación técnica

El servicio utiliza OpenAPI. La especificación y documentación interactiva están disponibles públicamente.

OpenAPI JSON Documentación interactiva

Integraciones con asistentes de IA

Superfudis permite el acceso autorizado a sus comparaciones a través de integraciones compatibles. Los sistemas externos deben utilizar los endpoints públicos o integraciones autorizadas y respetar los límites de uso.