Para desarrolladores

API de EmpresasUK

Consulta empresas registradas en el Reino Unido —datos registrales, directivos, PSC, cargas, contratos públicos y sectores SIC traducidos al español— desde tu propio software. Pensada para despachos jurídicos, CRM, due diligence automatizada y enriquecimiento de leads.

Despachos jurídicos

Integra los datos en tu gestor sin tener que abrir otra pestaña. Acceso instantáneo a directivos, PSC y cargas.

CRM y leads

Enriquece tu base con cargas pendientes, contratos públicos y perfil de riesgo para priorizar comerciales.

Producto propio

Muestra fichas de empresas británicas en tu propio panel, plataforma de comparación o marketplace.

Autenticación

La API se autentica con una API key que se genera desde tu panel de cuenta. La key se envía en cada petición en uno de estos dos encabezados:

Authorization: Bearer euk_live_xxxxxxxxxxxxxxxxxxxxx
# o bien
X-API-Key: euk_live_xxxxxxxxxxxxxxxxxxxxx

Las keys solo están disponibles en el plan Agencia y superiores. La key se muestra una sola vez en el momento de crearla — guárdala en un gestor de secretos seguro. En BD se almacena solo el hash sha-256.

Endpoint · Buscar empresas

GET https://empresasuk.com/api/v1/empresas

Devuelve una lista paginada con los filtros que apliques.

Parámetro	Tipo	Descripción
`q`	string	Texto en el nombre de la empresa (búsqueda parcial).
`sic`	string	Código SIC 2007 (4-5 dígitos). Busca en SIC1 a SIC4.
`estado`	string	active \| dissolved \| liquidation \| administration.
`ciudad`	string	Búsqueda parcial en la ciudad del domicilio social.
`perfil`	string	Clasificación interna del perfil de la empresa.
`pagina`	int	Página (1 por defecto).
`por_pagina`	int	Resultados por página. Máximo 100. Por defecto 25.

Ejemplo

curl "https://empresasuk.com/api/v1/empresas?q=tesco&estado=active&por_pagina=10" \
  -H "Authorization: Bearer $EMPRESASUK_API_KEY"

Respuesta

{
  "total": 142,
  "pagina": 1,
  "por_pagina": 10,
  "empresas": [
    {
      "numero": "00445790",
      "nombre": "TESCO PLC",
      "estado": "active",
      "tipo": "plc",
      "ciudad": "WELWYN GARDEN CITY",
      "codigo_postal": "AL7 1GA",
      "fecha_constitucion": "1947-11-27",
      "sic1": "47110",
      "num_cargas_pendientes": 2,
      "num_contratos_publicos": 0,
      "valor_total_contratos_publicos": 0,
      "perfil": { "clasificacion": "bajo_perfil_con_alertas" }
    }
  ]
}

Endpoint · Datos completos de una empresa

GET https://empresasuk.com/api/v1/empresa/{numero}

Devuelve el bloque completo que usamos internamente para generar los informes PDF: ficha registral, directivos activos y cesados con cargos y nacionalidades, personas con control significativo (PSC), cargas inscritas con importes y estado, contratos públicos adjudicados, sectores SIC traducidos al español, etc.

Ejemplo

curl "https://empresasuk.com/api/v1/empresa/00445790" \
  -H "Authorization: Bearer $EMPRESASUK_API_KEY"

La respuesta es un objeto JSON con las claves empresa, directivos, psc, cargas, contratos, sectores. Estructura estable: documentamos cambios incompatibles con al menos 60 días de aviso por email a las keys activas.

Límites y códigos de error

El plan Agencia incluye 1.000 consultas/mes por API key. Cada respuesta incluye los encabezados:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 873

Códigos posibles:

Status	Motivo	Cuándo ocurre
`200`	`ok`	Petición correcta.
`400`	`*_invalido`	Algún filtro no cumple el formato (sic no numérico, estado no permitido, etc.).
`401`	`falta_api_key / api_key_invalida`	Sin key, key mal formada o revocada.
`403`	`plan_insuficiente / organizacion_invalida`	La key es válida pero el plan del dueño ya no es Agencia o superior.
`404`	`empresa_no_encontrada`	El número CH no está en nuestra base.
`429`	`rate_limit_mensual`	Has consumido las 1.000 consultas del mes. Resetea el día 1.
`500`	`error_db`	Error interno; reintenta o avísanos.

Empezar

Contrata el plan Agencia.
Entra en tu panel de cuenta, busca la sección Cuenta Agencia · API keys y pulsa Crear key. Copia el plaintext que aparece — es la única vez que se mostrará.
Haz tu primera petición con el ejemplo curl de arriba sustituyendo la variable de entorno por tu key.

¿Necesitas un volumen mayor o un endpoint que no aparece?

Escríbenos desde el formulario de contacto y miramos un plan Enterprise a medida.