Referencia v1

Documentacion API

Acceso programatico a busqueda de empresas, personas y reportes visuales.

Busqueda de empresas

GET /api/v1/search?q={texto}&limit=20

Devuelve coincidencias por nombre o CIF usando el indice por prefijos.

Reporte de empresa

GET /api/v1/company/{slug-cif}

KPIs, timeline y eventos de la empresa en JSON.

Eventos paginados

GET /api/v1/company/{slug-cif}/events?year=YYYY&page=1&page_size=50

Actos por anio paginados para respuestas ligeras.

Cargos de empresa

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

Administradores vigentes e historicos.

Busqueda de personas

GET /api/v1/person/search?q={nombre}&limit=20

Busca personas por nombre en el indice de cargos.

Ficha de persona

GET /api/v1/person/{slug}

Cargos activos, historicos y empresas vinculadas.

Resumen diario

GET /api/v1/summary/date/{YYYY-MM-DD}

Actos publicados en el BORME para una fecha, agrupados.

Ejemplo rapido

GET /api/v1/company/telefonica-sa-a28015865

{
  "company": {"name": "Telefonica SA", "cif": "A28015865"},
  "kpis": {"acts_count": 248, "first_seen": "2020-01-03", "last_seen": "2026-02-18"},
  "timeline": [{"period": "2026-02", "count": 4}],
  "events": [{"id": "BORME-A-2026-3024", "type": "NOMBRAMIENTO"}]
}