API · versión 1.0

API de OpenMoney

Los mismos datos que enseña esta web, en JSON: contratos adjudicados, licitaciones en plazo, subvenciones concedidas y presupuestos liquidados por empresa, órgano de contratación, municipio y administración. Con una clave gratuita que se crea en tu cuenta.

EmpezarReferencia de rutasOpenAPI (JSON)

Empezar en tres pasos

1. Crea una cuenta en openmoney.es/cuenta con tu correo: sin contraseña ni tarjeta, entras con el enlace que te enviamos.
2. Crea una clave en la misma página («Claves de la API»). Empieza por om_ y se enseña una sola vez: cópiala. Puedes tener hasta tres activas y revocarlas cuando quieras.
3. Llama a la API con la clave en la cabecera X-API-Key:

curl -H "X-API-Key: om_…" "https://api.openmoney.es/search?q=indra"

[
  {"tipo": "empresa", "id": "A28599033", "nombre": "INDRA SISTEMAS SA", "peso": 1843201377.6, "score": 0.98},
  {"tipo": "empresa", "id": "B84138296", "nombre": "INDRA BPO SLU", "peso": 3296999.98, "score": 0.77},
  {"tipo": "organo", "id": "E04973401", "nombre": "Subdirección General de Adquisiciones de Armamento y Material", "peso": 912004112.3, "score": 0.41}
]

La base es https://api.openmoney.es. Todo es GET, responde JSON en UTF-8 y va comprimido si mandas Accept-Encoding: gzip. No hay estado entre llamadas: cada petición se basta con su clave.

La clave

Toda ruta de datos pide la cabecera X-API-Key. Sin ella la respuesta es 401 con el motivo. Las únicas rutas libres son / (qué es esta API), /health (si está sana) y /openapi.json (esta misma referencia en formato OpenAPI 3, para importarla en Postman, Insomnia o un generador de clientes).

• La clave es personal e intransferible: identifica tu cuenta. No la pongas en el código de un navegador ni en un repositorio; guárdala en una variable de entorno o en el gestor de secretos de tu plataforma.
• Solo guardamos una huella (SHA-256) de la clave y su prefijo. Si la pierdes, revócala en tu cuenta y crea otra. Revocar deja de valer al instante (en algún caso, hasta quince segundos después).
• Cada clave tiene un nombre para reconocerla y su uso se ve en tu cuenta: peticiones de hoy y de los últimos treinta días, por día y por ruta.

Límites y cuota

Dos barreras, y las dos responden 429 con Retry-After (segundos) cuando se alcanzan:

• Por dirección IP: 60 peticiones en ráfaga y luego 1 por segundo, de forma continua. Vale para toda la API, con o sin clave. Es la que frena a quien dispara sin clave.
• Por clave: una cuota diaria de peticiones (por defecto, 1.000; se renueva a las 00:00 UTC). Se ve en cada respuesta:

  Cabecera	Qué dice
  X-RateLimit-Limit	la cuota diaria de la clave
  X-RateLimit-Remaining	las peticiones que quedan hoy
  X-RateLimit-Reset	cuándo se renueva, en segundos desde 1970 (la próxima medianoche UTC)

¿Necesitas más? La cuota se ajusta por clave para integraciones con volumen (socios, alertas diarias para muchas empresas): escríbenos desde la dirección del aviso legal contando qué vas a hacer con los datos. Mientras tanto, pide páginas grandes (limite=100 en las listas, hasta 500 en las novedades) y guarda lo que ya tienes: los datos cambian una vez al día.

Errores

Todo error devuelve JSON con la clave detail y el motivo en castellano:

{"detail": "hace falta una clave de la API en la cabecera X-API-Key; se crea gratis con una cuenta en https://openmoney.es/cuenta (documentación: https://openmoney.es/api)"}

Para un cliente robusto: reintenta los 429 y 503 respetando Retry-After, no reintentes los 4xx restantes, y trata cualquier campo nuevo en una respuesta como algo que puedes ignorar (añadimos campos; no quitamos ni renombramos sin avisar en Cambios).

Convenciones: importes, fechas, identificadores y códigos

• Importes en euros, sin IVA, y son importes adjudicados o concedidos, nunca pagos. Los acuerdos marco y los importes repetidos no se suman (se marcan como sospechoso donde aparecen). Las liquidaciones son obligaciones reconocidas netas. Nada anterior a 2022. Lo explica la metodología.
• Fechas en ISO 8601: los días como 2026-09-23; las marcas de tiempo con zona, en UTC (2026-09-09T05:00:00+00:00). Un parámetro de fecha y hora sin zona se toma como UTC.
• Identificadores: la empresa por su NIF (con o sin separadores, en cualquier caja; las uniones temporales por su id UTE-… tal cual), el órgano por su código DIR3 (L01280796) o, cuando PLACSP no lo trae, por la clave NIF:… o PLAT:… que devuelven las fichas; el municipio por su código INE de cinco cifras (28079); la administración por su slug (estado, seguridad-social, canarias…). /search devuelve el tipo y el id que acepta cada ficha.
• Personas físicas: nunca hay DNI ni NIE; sus importes aparecen agregados como «personas físicas» y un DNI en una lista de NIF se ignora.
• Códigos: los CPV son la nomenclatura europea (se filtra por prefijo: 45 son las obras, 45233 las de carreteras); el territorio, por código NUTS español por prefijo (ES51 Cataluña, ES511 Barcelona; ES es toda España); el tipo de contrato y el procedimiento, por los códigos numéricos de PLACSP (tipo: 1 suministros, 2 servicios, 3 obras…; procedimiento: 1 abierto, 9 abierto simplificado…). /licitaciones/resumen devuelve cada código con su nombre y cuántos expedientes tiene: es la lista completa y viva de valores para los filtros, y las respuestas llevan siempre el nombre junto al código.
• Enlaces: link es la página del expediente en la plataforma de origen (PLACSP o la autonómica); las fichas de la web están en https://openmoney.es/empresa/{nif}, /organo/{id}, /municipio/{ine} y /licitaciones.

Paginación y novedades desde una marca

Las listas se paginan con desde (posición, empieza en 0) y limite, y devuelven total sobre lo filtrado. Una página más allá del final vuelve vacía con el total real.

/licitaciones/novedades es la ruta para mantenerte al día sin repetir descargas: pides los expedientes cuya última versión en PLACSP (actualizado) es igual o posterior a una marca, en orden, y la respuesta trae en siguiente la marca de la página siguiente (desde y tras, el último expediente de ese instante) mientras mas sea true; cuando ya no hay más, siguiente es la marca que debes guardar para la próxima consulta. Aparte vienen las bajas: expedientes que PLACSP retiró desde la marca. Cada expediente dice si sigue abierta.

{
  "desde": "2026-09-09T05:00:00+00:00", "mas": true,
  "siguiente": {"desde": "2026-09-09T11:42:10+00:00", "tras": "https://contrataciondelestado.es/…/idEvl=abc"},
  "expedientes": [ { "id": 27414823, "estado": "PUB", "estado_nombre": "Publicada", "abierta": true, "baja": null, "…": "los campos de la lista y los tres presupuestos" } ],
  "bajas": [ {"id": 27301111, "id_url": "https://…", "expediente": "2026/SER/0102", "baja": "2026-09-09T06:10:00+00:00"} ],
  "bajas_mas": false
}

Los datos se cargan una vez al día, poco después de las 05:00 UTC, con seis horas de solape sobre el feed de PLACSP. Consulta las novedades a partir de las 08:00 UTC y quédate con la marca que devuelve la respuesta, no con tu hora local: así no pierdes ni repites expedientes aunque el feed llegue con retraso.

Ejemplos

Licitaciones en plazo, con filtros

curl -H "X-API-Key: om_…" "https://api.openmoney.es/licitaciones/abiertas?cpv=45&nuts=ES51&dias=30&orden=presupuesto&limite=100"

{
  "total": 388, "desde": 0, "limite": 25, "orden": "plazo",
  "resultados": [
    {
      "id": 27414823,
      "expediente": "2026/OBR/0041",
      "titulo": "Renovación de la red de abastecimiento en la calle Mayor",
      "objeto": "Obras de renovación de la red de abastecimiento de agua…",
      "organo": "L01280796", "organo_nombre": "Ayuntamiento de Madrid",
      "tipo": "3", "tipo_nombre": "Obras",
      "procedimiento": "9", "procedimiento_nombre": "Abierto simplificado",
      "presupuesto": 412300.5, "presupuesto_origen": "sin_iva",
      "cpv": [{"codigo": "45231300", "nombre": "Trabajos de construcción de tuberías para agua y aguas residuales"}],
      "lugar": "Madrid", "nuts": "ES300", "nuts_nombre": "Madrid",
      "fecha_anuncio": "2026-09-02", "fin_plazo_ofertas": "2026-09-23", "dias_restantes": 13, "n_lotes": 0,
      "link": "https://contrataciondelestado.es/wps/poc?uri=deeplink:detalle_licitacion&idEvl=…",
      "actualizado": "2026-09-02T10:14:52+00:00"
    }
  ]
}

Python (httpx)

import httpx

api = httpx.Client(base_url="https://api.openmoney.es", headers={"X-API-Key": "om_…"}, timeout=30)

# licitaciones de obras en Cataluña que cierran en 15 días, por presupuesto
r = api.get("/licitaciones/abiertas", params={"tipo": "3", "nuts": "ES51", "dias": 15, "orden": "presupuesto", "limite": 100})
r.raise_for_status()
print(r.headers["X-RateLimit-Remaining"], "peticiones restantes hoy")
for x in r.json()["resultados"]:
    print(x["fin_plazo_ofertas"], x["organo_nombre"], x["presupuesto"], x["link"])

# novedades desde la última marca (guárdala: la siguiente consulta empieza en `siguiente`)
marca = {"desde": "2026-09-09T05:00:00Z", "tras": ""}
while True:
    n = api.get("/licitaciones/novedades", params={**marca, "limite": 500}).json()
    for x in n["expedientes"]:
        ...
    marca = n["siguiente"]
    if not n["mas"]:
        break

JavaScript (fetch)

const r = await fetch("https://api.openmoney.es/empresa/A28599033", { headers: { "X-API-Key": "om_…" } });
if (r.status === 429) throw new Error(`espera ${r.headers.get("Retry-After")} s`);
const empresa = await r.json();
console.log(empresa.nombre_canonico, empresa.por_anio.at(-1));

Ficha de una empresa, de un órgano o de un municipio

curl -H "X-API-Key: om_…" "https://api.openmoney.es/empresa/A28599033"
curl -H "X-API-Key: om_…" "https://api.openmoney.es/organo/L01280796"
curl -H "X-API-Key: om_…" "https://api.openmoney.es/municipio/28079"

Las fichas son documentos grandes (20-40 KB comprimidos) con todo lo que enseña la web: por año, mayores contrapartes, expedientes recientes, señales. Cambian una vez al día: cachéalas.

Referencia de rutas

Generada del OpenAPI de la API (versión 1.0). Salvo que se diga lo contrario, cada ruta pide la clave y consume una petición de la cuota.

Rutas que no están aquí: /cuenta/* y /lista-espera/* son las que usa la propia web con la sesión del navegador (entrar, salir, crear claves, la lista de espera de «¿Dónde abro?»); no forman parte del contrato de la API y pueden cambiar sin aviso. Para crear o revocar claves está tu cuenta.

Condiciones de uso y atribución

Al crear una clave aceptas las condiciones de uso del aviso legal, en particular su apartado API. En corto:

• La API es la única vía autorizada para leer OpenMoney con un programa: nada de rastrear la web, sus datos estructurados ni sus enlaces.
• La clave es personal: no se comparte, no se cede, no se publica ni se usa desde un navegador ajeno. Una cuenta, una persona.
• Puedes integrar los datos en tu producto o en tu análisis, mostrarlos a tus usuarios y citarlos, con la atribución «Datos: OpenMoney sobre PLACSP/BDNS» y un enlace a openmoney.es donde se muestren. No puedes extraer una parte sustancial de la base de datos, redistribuirla, revenderla ni montar con ella otro servicio o conjunto de datos, ni usar el contenido para entrenar modelos sin licencia escrita.
• Nada de lo que devuelve la API identifica a personas físicas, y así debe seguir: no intentes reidentificarlas.
• Ante un uso prohibido o un intento de saltarse los límites, la clave y la cuenta se revocan sin aviso.

Los datos de origen son públicos y siguen en sus fuentes (PLACSP, BDNS, Hacienda, INE); lo que aporta OpenMoney es la reconciliación, la limpieza y la estructura. Quien necesite un volcado completo debe obtenerlo de las fuentes oficiales.

Cambios

La versión va en / y en /health (api). Añadimos campos y rutas sin cambiar de versión; un cambio que quite o renombre algo se anuncia aquí con antelación y sube la versión.

• 1.0 · 10 de septiembre de 2026. Clave obligatoria en toda ruta de datos (X-API-Key), portal de claves en la cuenta, cuota diaria con cabeceras X-RateLimit-*, esta documentación y el OpenAPI público. Nuevas /licitaciones/resumen, /licitaciones/abiertas, /licitaciones/{id} y /licitaciones/novedades (expedientes en plazo, ficha con antecedentes y novedades desde una marca). Las rutas de fichas, búsqueda, administraciones, historias y mapas siguen igual que en la 0.1, ahora con clave.

Lo siguiente, por orden: pliegos, historial de anuncios y lotes en la ficha del expediente; convocatorias de subvenciones abiertas con su plazo; novedades por empresa (adjudicaciones y concesiones nuevas para una lista de NIF desde una marca).