API de planificación de precios de electricidad

¿Por qué un dispositivo necesita conocer el precio de la próxima hora?

Para integrar más energía renovable en la red, es la demanda la que debe adaptarse a la producción, y no al revés. Ese papel recae en los dispositivos pilotables: termo eléctrico conectado, punto de recarga, batería doméstica o calefacción gestionada por una aplicación.

La señal que une la oferta con la demanda es el precio, pero el dispositivo debe poder leerlo. Un termo no sabe interpretar una tarifa eléctrica, y su fabricante no puede mantener actualizadas las miles de ofertas de un país, y menos aún de quince. Ese es justamente el hueco que cubre esta API: convierte una oferta comercial, con sus opciones y particularidades locales, en una sucesión de franjas horarias valoradas que una máquina puede consumir.

¿Qué hace la API de planificación de Selectra?

Califica al consumidor y luego expone el precio durante los próximos períodos. Son tres puntos de entrada, llamados en este orden:

1. Calificar al cliente: un cuestionario corto, servido por la propia API (país, código postal, comercializadora, tarifa, opción). Cada respuesta determina la siguiente pregunta hasta completar la calificación;
2. Recuperar el planning de precios: la API responde con la sucesión de períodos futuros, cada uno con su precio, su nombre y su índice de contador. Los períodos contiguos con el mismo precio se fusionan;
3. Leer el detalle de la oferta (opcional): una tercera llamada devuelve la ficha de la oferta (término de potencia, descripción de la opción, tramos y desglose de precios).

La calificación merece una aclaración: es la API la que fabrica el cuestionario, mercado por mercado. Devuelve la siguiente pregunta y las respuestas admisibles, y el integrador se limita a mostrarlas. Nadie, del lado del cliente, tiene que mantener la lista de comercializadoras de un país ni la de sus opciones, que cambian constantemente.

¿Qué datos devuelve la API?

La respuesta es una tabla JSON de períodos sucesivos. Cada uno incluye una fecha de inicio, una fecha de fin, un precio del kWh, el nombre del tramo tal como lo denomina la comercializadora y la referencia del índice correspondiente en el contador, lo que permite relacionar un precio con un consumo realmente registrado. La respuesta indica además la moneda y la hora de la próxima actualización.

{
  "prices": [
    {
      "name": "Punta",
      "price": 0.2143,
      "start": "2026-09-09T10:00:00+02:00",
      "end": "2026-09-09T14:00:00+02:00",
      "distributor_reference": "1"
    },
    {
      "name": "Llano",
      "price": 0.1356,
      "start": "2026-09-09T14:00:00+02:00",
      "end": "2026-09-09T18:00:00+02:00",
      "distributor_reference": "2"
    }
  ],
  "next_update": "2026-09-10T20:15:00+02:00",
  "currency": "EUR"
}

Extracto de respuesta de la API de planificación de precios de Selectra. Los períodos contiguos con el mismo precio y el mismo nombre se fusionan.

¿Qué países están cubiertos?

La API de planificación de precios de electricidad de Selectra opera ya en más de 200 países. En Europa cubre el 99 % de todas las ofertas publicadas —desde tarifas fijas y de discriminación horaria hasta precios dinámicos y de respuesta a la demanda— y se extiende mucho más allá de Europa, hasta América, Asia, África, Oriente Medio y Oceanía. España está totalmente integrada.

A escala mundial, la API abarca más de 3.700 comercializadoras y más de 23.000 ofertas, y se añaden nuevos mercados de forma continua. El mercado en cuestión es el residencial y las pequeñas empresas, los únicos segmentos para los que se publican precios: por encima de cierta potencia, la tarificación se negocia caso por caso y no figura en ninguna tabla pública.

¿Y en detalle sobre España?

España es uno de los mercados más completos de la API: cubre al 97 % de los hogares. El precio del kWh que devuelve suma el término de energía y los peajes y cargos regulados, con los impuestos incluidos. Gestiona:

• todas las comercializadoras y todas las tarifas residenciales publicadas, con y sin discriminación horaria, desde el PVPC, cuyo precio cambia cada hora, hasta las ofertas del mercado libre. Las únicas excepciones son Repsol Mis 10 Horas y las ofertas dinámicas cuya fórmula no es pública;
• los períodos punta, llano y valle de la tarifa 2.0TD, cuyos horarios fija el regulador y no la comercializadora ni la distribuidora;
• una sesentena de tarifas indexadas al mercado mayorista (precio dinámico), calculadas con los precios de OMIE, fuente que utilizamos con autorización;
• opciones más específicas: tarifa de fin de semana, segunda residencia, verano o tarifa para coche eléctrico;
• los precios de compensación de excedentes, para un cliente con autoconsumo;
• precios distintos para la Península, Baleares, Ceuta, Melilla y Canarias, porque los sistemas no peninsulares no tienen los mismos precios.

Ofertas de electricidad cubiertas por la API de planificación de precios de Selectra, por comercializadora. Fuente: energy-core (Selectra). Los datos se actualizan de forma automática.

La cobertura española completa, las tarifas y una consola de prueba están en la página de España del catálogo.

¿Y para ordenar todas las ofertas españolas? La API Comparador

La API de planificación responde a la pregunta «¿cuánto costará mi tarifa en las próximas horas?». La API Comparador de Selectra responde a otra: ¿cuánto le costaría cada oferta del mercado a este hogar concreto, de la más barata a la más cara? Alimenta páginas de comparación, herramientas de cambio de comercializadora y sistemas de facturación. Está activa en ocho mercados europeos y en España cubre la luz y el gas, por separado o juntos.

Método 1: ordenar a partir del consumo anual o de una factura

Es lo que necesita una página de comparación: el visitante conoce más o menos su consumo anual, no las horas en las que consume. Una sola llamada GET recibe el consumo en kWh y la potencia contratada, que se factura por día consuma lo que consuma el contador y decide además la tarifa: 2.0TD hasta 15 kW, 3.0TD por encima. La API devuelve todas las ofertas ordenadas de la más barata a la más cara.

GET /v3/es/compare?energy_type=electricity&client_type=domestic&car_base=3500&power=4.6

La forma más barata de ganar precisión en España no exige ningún contador inteligente: la factura de la luz ya imprime el consumo en punta, llano y valle. Si se envían esas tres cifras en lugar del total, la API deja de suponer el reparto. También puede tarificar una sola factura (con sus días de facturación) en lugar de un año, y ordenar el mercado con y sin placas solares en una misma respuesta, teniendo en cuenta la compensación de excedentes.

Método 2: ordenar a partir de la curva de carga

El contador registra el consumo hora a hora. Envía esas lecturas (hasta un año completo, directamente o en un archivo CSV) y cada intervalo se tarifica en el período en el que realmente cae, con el calendario de la provincia: la 2.0TD divide cada día laborable en punta, llano y valle a horas fijas, y los fines de semana y festivos son valle todo el día. Es la única forma honesta de comparar el PVPC o una tarifa indexada con una tarifa fija, porque se calculan con la serie horaria publicada para las horas que el hogar consumió de verdad.

Sin dirección que buscar, pero con cuatro territorios fiscales

En España, el precio de la luz es nacional y su forma, regulada. Lo que cambia con la geografía son los impuestos: 21 % de IVA en la Península y Baleares, 7 % de IGIC en Canarias y 1 % de IPSI en Ceuta y en Melilla (más detalles sobre el IVA y los impuestos de la luz). El método anual solo necesita saber en cuál de los cuatro territorios está el contador; el método por curva de carga pide el código postal, del que deduce a la vez el territorio, la provincia y la hora, ya que Canarias va una hora por detrás.

¿Cómo acceder a la API y cuánto cuesta?

El acceso se realiza desde el catálogo api.selectra.com, que ofrece la documentación, una consola de prueba y la suscripción. Un nivel gratuito, sin tarjeta bancaria, abre los tres puntos de entrada en todos los mercados cubiertos: suficiente para construir una primera integración y juzgar el dato antes de hablar de contrato.

Más allá, la facturación combina tres elementos: una cuota mensual por los mercados que necesites (mercado por mercado o en fórmula Europa), un precio por llamada que disminuye con el volumen, y unos gastos de puesta en marcha que incluyen el acompañamiento técnico hasta la puesta en producción. Los importes vigentes se muestran en directo en la página de tarifas del catálogo, ya que se leen desde la propia facturación.

La API Comparador sigue el mismo modelo: una cuota mensual por mercado (España se vende por separado), un precio por llamada y un acceso gratuito con un paquete de llamadas de prueba para probarla con datos reales. Sus mercados y tarifas figuran en la página de la API Comparador. Las peticiones repetidas no cuestan nada: cuando una respuesta no ha cambiado desde la última llamada, vuelve vacía y no se descuenta de la cuota.

¿A quién se dirige esta API?

Los integradores son de cuatro familias: los fabricantes de dispositivos pilotables y los editores de sistemas de gestión energética del hogar, que necesitan el precio para decidir cuándo activarse; las energéticas, que quieren ofrecer el pilotaje a sus clientes sin reconstruir una base tarifaria; los agregadores de flexibilidad y de respuesta a la demanda, que arbitran entre precio minorista y señal de red; y los operadores de recarga de vehículos eléctricos, cuyo valor consiste precisamente en saber desplazar una carga unas horas.

El punto común de estas cuatro familias: ninguna tiene interés en convertirse en editora de datos tarifarios. Mantener las tarifas de un solo país ocupa ya a un equipo a tiempo completo, y la dificultad no está en el número de comercializadoras, sino en la velocidad a la que cambian las opciones.

¿Por qué Selectra ofrece esta API?

Selectra compara ofertas de electricidad desde 2007. Sus fundadores, Xavier Pinon y Aurian de Maupeou, previeron desde el inicio de la liberalización del mercado la creciente complejidad de las ofertas, que exigía una mejor información al consumidor basada en datos de precios. La API de planificación sigue exactamente la misma lógica: simplificar un tema complejo, esta vez al servicio de la electrificación del consumo energético.

La empresa opera en 15 países con un equipo de 50 especialistas en el mercado energético que mantienen sus sitios y bases de datos actualizados en tiempo real. Con más de 100 millones de euros de facturación en 2024 y 2000 empleados, tiene los medios para sostener ese mantenimiento en el tiempo, que es la única cuestión que importa cuando se confía el dato tarifario a un tercero. Sus oficinas de París, Madrid, Lyon, Roma y Tokio, entre otras, la sitúan lo más cerca posible de los mercados que modeliza.

Preguntas frecuentes sobre la API de planificación

¿Para qué sirve la API de planificación de precios de la electricidad?

Permite que un dispositivo pilotable —termo conectado, punto de recarga, batería doméstica o sistema de gestión energética— conozca el precio del kWh en las próximas horas y desplace por sí mismo el consumo hacia los momentos más baratos. Es la pieza que falta en la mayoría de los objetos conectados: saben pilotar, pero no a qué precio.

¿Qué datos devuelve exactamente la API?

Una tabla JSON de períodos sucesivos. Cada período incluye una fecha de inicio, una fecha de fin, un precio del kWh, el nombre del tramo tal como lo denomina la comercializadora («Punta», «Valle»…) y la referencia del índice correspondiente en el contador. La respuesta indica además la moneda y la hora de la próxima actualización.

¿Cómo sabe la API qué tarifa tiene contratada el cliente?

No lo adivina: lo pregunta. La primera llamada abre un cuestionario corto cuyas preguntas y respuestas construye la propia API, mercado por mercado. El integrador no tiene que mantener la lista de comercializadoras de un país ni la de sus opciones: muestra lo que la API le devuelve.

¿España está totalmente cubierta?

Sí, el 97 % de los hogares: PVPC, períodos punta, llano y valle de la tarifa 2.0TD, discriminación horaria, tarifas indexadas al mercado mayorista, tarifa de fin de semana, tarifa para coche eléctrico y compensación de excedentes, con precios propios para la Península, Baleares, Ceuta, Melilla y Canarias.

¿Qué diferencia hay entre la API de planificación y la API Comparador?

La API de planificación parte de la tarifa que un hogar ya tiene e indica a un dispositivo cuándo será más barata la luz en las próximas horas. La API Comparador parte del consumo del hogar (un total anual, los consumos de una factura o la curva de carga del contador) y ordena todas las ofertas de luz y gas del mercado español según lo que le costarían. La primera sirve a los dispositivos inteligentes; la segunda, a los comparadores y a las herramientas de cambio de comercializadora.

¿Cómo probar la API antes de contratar?

El catálogo api.selectra.com abre un acceso gratuito, sin tarjeta bancaria, con una cuota de llamadas mensual en todos los mercados y los tres puntos de entrada. Suficiente para construir una primera integración y juzgar el dato. La API Comparador tiene su propio acceso gratuito, con un paquete de llamadas de prueba.