Para desarrolladores

API REST — datos del Registro Mercantil

Acceso programático a empresas, administradores, capital social, sectores CNAE y direcciones. Datos derivados del BORME, actualizados a diario. JSON. Sin SDK necesario.

Plan Developer

99 €/mes

· 10.000 llamadas / mes
· 60 peticiones / minuto
· Todos los endpoints públicos
· Soporte por email

Crear clave en mi cuenta

¿Necesitas más? Contáctanos

Autenticación

Pasa la clave en la cabecera x-api-key. También se acepta Authorization: Bearer ces_... o el query ?api_key=.

cURL

curl -H "x-api-key: ces_..." \
  "https://www.companias.es/api/v1/companies/acme-sl-borme-12345"

JavaScript

const res = await fetch("https://www.companias.es/api/v1/companies?q=acme", {
  headers: { "x-api-key": "ces_..." }
});
const data = await res.json();

Endpoints

Base URL: https://www.companias.es/api/v1

Método	Ruta	Descripción
GET	/companies?q=acme&limit=20	Buscar empresas por nombre o NIF/CIF.
GET	/companies/{slug}	Detalle completo: empresa, administradores, finanzas, capital, BORME.
GET	/directors?q=lopez	Buscar administradores por nombre.
GET	/directors/{slug}	CV completo: nombramientos, sectores, co-administradores.
GET	/sectors	Lista de códigos CNAE con número de empresas.
GET	/sectors/{cnae}	Resumen de sector: KPIs, top empresas, top movers.
GET	/provinces/{slug}?sort=capital	Resumen y ranking de empresas por provincia.
GET	/addresses/{hash}	Detalle de dirección: empresas registradas, score de riesgo.
GET	/usage	Cuota y uso actual de tu clave API.

Límites y respuestas

Cada respuesta incluye cabeceras X-RateLimit-Remaining y X-Quota-Remaining.
Rebasar el límite por minuto devuelve 429 con cabecera Retry-After: 60.
Rebasar la cuota mensual devuelve 429 hasta el próximo ciclo.
Paginación: ?limit=50&offset=0 (máx. 100).
Datos servidos: BORME (Boletín Oficial del Estado · Registro Mercantil de España), refresco diario.

¿Necesitas un volumen mayor, SLA o webhooks? Cuéntanos tu caso.