API de datos de empresas de España: qué fuentes hay y cuándo usar cada una

En España la mayor parte de los datos oficiales de empresas es pública, y parte de ella es gratuita. Esta guía recorre las fuentes con honestidad, explica cuándo basta con la gratuita y cuándo compensa una API normalizada con monitorización, y muestra la consulta en tres llamadas.

Las fuentes oficiales de datos de empresas en España

Antes de contratar nada conviene saber qué existe y cuánto cuesta. Los datos del Registro Mercantil llegan al público por varias vías, y varias son gratuitas:

FuenteQué daCoste
BORME (BOE)El Boletín Oficial del Registro Mercantil: los actos inscritos de cada día (constituciones, nombramientos, ceses, ampliaciones de capital, disoluciones). El BOE lo publica como datos abiertos.Gratuito
Registradores de EspañaConsulta registral: notas simples, y cuentas depositadas por empresa. También publican datos abiertos.Las notas simples y las cuentas se piden de pago
Agencia Tributaria (AEAT)Comprobación de un NIF y consulta de números de IVA intracomunitario (VIES) en su sede electrónica.Gratuito
Proveedores comerciales de informesInformes de empresa con información comercial adicional.De pago, normalmente por informe o por contrato
Una API normalizada, como PrometiamLos datos del registro en JSON, con el mismo formato que otros países, por NIF o por nombre, y avisos por webhook.Precios públicos desde 9,99 € al mes

Cuándo basta con la fuente gratuita

Si necesita comprobar una empresa de vez en cuando, la fuente gratuita es suficiente: se busca el NIF en la sede de la Agencia Tributaria, se lee el BORME del día en el BOE y, si hace falta una prueba formal, se pide una nota simple al Registro Mercantil. También sirve una herramienta gratuita como buscar empresa por CIF o NIF, que devuelve denominación, forma jurídica y estado en un momento.

El BORME, por su parte, es un boletín en formato de texto y PDF: leerlo a escala exige descargarlo, interpretarlo y enlazar cada acto con la empresa. La guía de la API del BORME explica ese trabajo, y la comparativa de APIs del Registro Mercantil pone las opciones lado a lado.

Cuándo compensa una API normalizada

  • Muchas empresas. Verificar un lote de clientes o proveedores por NIF es una llamada de hasta 100 empresas, no cien búsquedas manuales.
  • Seguimiento. POST /monitor avisa por webhook cuando una empresa cambia de estado, se disuelve, coincide con una lista de sanciones (beta) o aparece un evento societario del BORME.
  • Más de un país. El mismo formato de respuesta sirve para España y para los otros países que cubre la API, con una sola clave.
  • Un asistente de IA. El servidor MCP expone las mismas consultas a Claude y Cursor.

Una consulta en tres llamadas

Primera llamada, buscar por NIF. Los ejemplos usan A46103834 (Mercadona); la respuesta trae una lista en data.

curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=ES&nif=A46103834' \
  -H 'Authorization: Bearer rk_live_...'
import requests

BASE = 'https://api.prometiam.com/functions/v1/risk-api'
H = {'Authorization': 'Bearer rk_live_...'}

r = requests.get(f'{BASE}/companies/search', headers=H,
                 params={'country': 'ES', 'nif': 'A46103834'})
empresa = r.json()['data'][0]
print(empresa['company_name'], empresa['status'])

Segunda, leer la ficha completa con el id que devolvió la búsqueda: GET /companies/{id}?include=risk_flags añade los administradores (el historial de actos inscritos) y el aviso de cierre provisional de hoja registral. Tercera, vigilar la empresa:

curl -X POST 'https://api.prometiam.com/functions/v1/risk-api/monitor' \
  -H 'Authorization: Bearer rk_live_...' \
  -H 'Content-Type: application/json' \
  -d '{"company_id": 812044, "country": "ES"}'

Qué devuelve para España

CampoQué significa
company_name, company_numberDenominación y NIF de la sociedad
status y local_statusEstado normalizado y la situación registral en sus propias palabras
legal_formForma jurídica (S.A., S.L., cooperativa)
founding_date y direcciónFecha de constitución y domicilio
vat_number y vat_number_sourceNúmero de IVA construido del NIF (ES más el NIF): el formato es correcto, pero la alta en el censo no se confirma; se comprueba con GET /vat/{número}
appointmentsAdministradores y otros cargos del Registro Mercantil, con sus fechas

Límites en España

  • Los concursos de acreedores de España se consultan en /search; el índice de insolvencias de la API cubre otros mercados.
  • Una sociedad cerrada por una fusión se sirve como cerrada (estado merged, local_status absorbed); los registros duplicados descartados nunca se sirven como empresas.
  • Las cuentas anuales de España solo se sirven para empresas cotizadas (informes ESEF; los de las empresas cotizadas españolas están disponibles gratuitamente en el sitio web de la CNMV). Las cuentas del resto de sociedades se depositan en el Registro Mercantil.
  • El cribado de sanciones es beta; el cribado PEP es beta y solo cubre España.
  • Un NIF malformado se rechaza con un error 400 validation_error: la letra de entidad y el carácter de control se comprueban, y un DNI o NIE tampoco se acepta.

Precio

La prueba gratuita dura 14 días e incluye 500 créditos; se pide una tarjeta, pero no se cobra nada durante la prueba. Después, Starter cuesta 9,99 € al mes con 1.000 créditos, Professional 29,99 € con 10.000 y Scale 99,99 € con 50.000; Enterprise tiene precio a medida. Una consulta de registro cuesta 1 crédito y los errores no cuestan nada. Los precios son públicos.

Páginas relacionadas

Empieza tu prueba gratuita de 14 días · Documentación de la API

La prueba dura 14 días e incluye 500 créditos. Se pide una tarjeta, pero no se cobra nada durante la prueba; después sigue el plan Starter (9,99 € al mes) salvo que la canceles.

Frequently asked questions

¿Existe una API gratuita del Registro Mercantil?
El BOE publica el BORME como datos abiertos, de forma gratuita, pero en un formato de boletín. Una API que devuelve la ficha de una empresa por NIF en JSON, con administradores y avisos, es un servicio de pago; la prueba de Prometiam es gratuita durante 14 días.
¿Puedo buscar una empresa española por NIF por API?
Sí: GET /companies/search?country=ES&nif=... devuelve la ficha del registro. Para una lista, POST /companies/lookup resuelve hasta 100 empresas por llamada y cada una cuenta como una consulta.
¿La API incluye las cuentas anuales de las pymes españolas?
No. Solo las de empresas cotizadas, con sus informes financieros anuales; las cuentas de las demás sociedades se piden al Registro Mercantil.
¿Puedo recibir un aviso cuando cambie una empresa?
Sí. Con POST /monitor recibe un webhook cuando cambia el estado de la empresa, se disuelve, aparece una coincidencia de sanciones (beta) o hay un evento societario del BORME. Starter incluye 25 empresas vigiladas, Professional 250 con webhooks y Scale 2.500.