¿Necesito registrarme para usar la API de OpenMercantil?

No para el tier gratuito (60 req/min, 200 req/día por IP). Para Profesional (5.000 req/día), MAX (50.000 req/día) o Enterprise debes registrarte en /mi-cuenta/registro y generar una API key desde tu panel.

¿Qué formato devuelve la API?

JSON UTF-8 estructurado con cabeceras CORS abiertas para uso desde frontend. OpenAPI 3.1 spec discoverable en /openapi.json. Swagger UI interactivo en /docs.

¿Bajo qué licencia están los datos de la API?

CC BY 4.0 (Creative Commons Attribution 4.0 International). Puedes redistribuir, modificar y usar comercialmente con atribución a OpenMercantil y referencia a la fuente original (BORME / BOE / etc.).

¿Cuáles son los rate limits exactos?

Free: 60 req/min y 200 req/día por IP (sin API key). Profesional 57 €/mes: 5.000 req/día con API key. MAX 197 €/mes: 50.000 req/día + webhooks + audit log. Enterprise: contractual y SLA.

¿Hay SDKs oficiales en Python o JavaScript?

No hay SDKs oficiales empaquetados, pero la API REST es directamente consumible con cualquier librería HTTP estándar (requests Python, fetch JS, curl). Ejemplos de uso documentados en /api/documentacion para Python, JavaScript, curl y HTTPie.

¿Puedo cargar datos bulk desde un dataset CSV en lugar de consumir API?

Sí. /descargas expone datasets CSV/JSON descargables bajo CC BY 4.0. También /catalog.rdf publica el catálogo DCAT 3.0 compatible con CKAN, data.gov, EU Open Data Portal para integración con data lakes.

API REST pública del BORME

Principios

Diseño de la API.

REST sobre JSON, respuestas UTF-8, códigos HTTP estándar.
Sin autenticación obligatoria para consultas de lectura. Free: 60 req/min y 200 req/día por IP. Planes superiores (Profesional 5.000 req/día, MAX 50.000 req/día, Enterprise 500.000+ req/día) según cuenta y API key.
Estable y versionada: endpoints bajo /api/v1/; cualquier breaking change pasará a /api/v2/.
CORS abierto para integración en frontend (Access-Control-Allow-Origin: *).
Datos trazables: cada registro conserva el identificador BORME-A-YYYY-NNN-NN de origen.
Licencia CC BY 4.0 sobre el dataset derivado.

Endpoints destacados

Catálogo público de 50+ endpoints.

Especificación machine-readable OpenAPI 3.1 completa en /openapi.json (alias /api/openapi.json). Docs interactivas (Swagger UI) en /docs. Catálogo DCAT-AP-ES en /catalog.rdf (RDF/XML, listo para data.europa.eu). También puedes pegar el openapi.json en Swagger Editor o importarlo en Postman/Insomnia.

01

Búsqueda por empresa/CIF

Consulta rápida sobre índice por prefijos.

GET /api/v1/search?q=telefonica

02

Ficha completa empresa

KPIs, timeline y actos clave listos para consumo.

GET /api/v1/company/{slug}

03

BORME diario

Sumario completo de un día con todos los actos.

GET /api/v1/daily/{YYYY-MM-DD}

04

Timeline multi-fuente

BORME + PLACSP + BDNS cronológico unificado.

GET /api/v1/company/{slug}/timeline

05

Contratación pública

Adjudicaciones PLACSP por empresa.

GET /api/v1/company/{slug}/contracts

06

Subvenciones BDNS

Ayudas públicas concedidas vía BDNS.

GET /api/v1/company/{slug}/grants

07

Propiedad industrial

Marcas + patentes agregadas (OEPM/EUIPO).

GET /api/v1/company/{slug}/ip

08

Catálogo de fuentes

37 fuentes públicas integradas con cobertura por empresa.

GET /api/v1/company/{slug}/sources

Ver los 50+ endpoints completos → openapi.json (OpenAPI 3.1) · docs interactivas en /docs (Swagger UI) · catálogo /catalog.rdf (DCAT-AP-ES). Incluye además: /events, /officers, /procurement, /grants, /sanctions, /risk-signals, /relationships, /sources, /lei, /cnmv, /bde, /aeat-moroso, /wikidata, /accounts, /ted, /grafo/{slug}, /grafo/persona/{slug}, /cnae/tree, /sector/{cnae}/companies, /sources/freshness, /health, /stats.

Ejemplo de respuesta

Una llamada, un JSON limpio.

GET /api/v1/company/inditex-s-a

{
  "slug": "inditex-s-a",
  "razon_social": "Industria de Diseño Textil, S.A.",
  "nif": "A15022510",
  "forma_juridica": "SA",
  "domicilio": {"provincia": "A Coruña", "municipio": "Arteixo"},
  "cnae": {"codigo": "4642", "division": "Comercio mayorista"},
  "capital_social_eur": 93499560,
  "lei": "959800S6S5JLNNEZAH54",
  "cotizada": {"mercado": "BME", "ticker": "ITX"},
  "actos_registrales": 1247,
  "ultimo_acto": "2026-04-19",
  "fuentes": ["BORME","CNMV","GLEIF","OEPM","BDNS"]
}

Casos de uso habituales

Para qué la utilizan.

·

Compliance / KYC

Verificar administradores vigentes y cambios societarios antes de contratar.

·

Inteligencia comercial

Identificar empresas de nueva constitución o con ampliaciones de capital en tu sector.

·

Periodismo de datos

Trazar conexiones entre personas y empresas en investigación pública.

·

Academia y econometría

Datasets longitudinales del tejido empresarial español desde 2009.

·

Alertas en tiempo cuasi real

Monitorizar nombramientos, concursos y disoluciones.

·

IA y RAG

Feed estructurado para agentes LLM que necesiten contexto mercantil oficial.

Buen uso

Límites y normas.

Free: 60 req/min y 200 req/día por IP (sin autenticación).
Planes superiores con API key personal: Profesional 5.000 req/día, MAX 50.000 req/día, Enterprise 500.000+ req/día.
Para cargas masivas, usa los datasets descargables en lugar de barrer la API.
Prohibido revender como «fuente oficial»; indica que los datos provienen del BOE/BORME y que OpenMercantil es intermediario.
Los datos personales solo pueden reutilizarse para finalidades compatibles con la transparencia mercantil (RGPD art. 5.1.b). Prohibido perfilar personas físicas con fines comerciales.

Empezar

Tu primera llamada en 30 segundos.

Sin registro. Abre tu terminal y prueba un curl. Si necesitas más cuota, regístrate y obtén tu API key.

Ver documentación completa Crear cuenta gratis ¿Uso intensivo? Escríbenos

200/díafree, sin auth

5k/díaprofesional

CC BY 4.0datasets descargables