Lo que devuelve
Busque en el registro oficial de empresas del Reino Unido (Companies House) y obtenga registros limpios de empresas.
- Busque empresas por número de empresa: perfil, estado, códigos SIC, oficina registrada, nombres anteriores, plazos de cuentas y confirmación, cargas y banderas de insolvencia.
- Directivos y propietarios: oficiales actuales (rol, fecha de nombramiento, nacionalidad, ocupación) y personas con control significativo (naturalezas del control).
- Listas de clientes potenciales: búsqueda filtrada por nombre, ciudad o código postal, estado, tipo de empresa, código SIC y rango de fechas de constitución o disolución. Por ejemplo, cada consultoría de TI (62020) constituida en Manchester el mes pasado.
- Búsqueda por nombre clasificada por relevancia.
Un registro por empresa: companyNumber, companyName, status, type, incorporatedOn, dissolvedOn, sicCodes, address, postalCode, locality, url; con detalles también previousNames, nextAccountsDue, accountsOverdue, officers, significantControl y opcionalmente recentFilings.
Solicitud
POST https://api.pushbuild.com/uk-companies-house/run con un cuerpo JSON. Envíe su clave en el encabezado X-API-Key.
| Campo | Tipo | Descripción |
|---|---|---|
companyNumbers | lista de cadenas | Busque estas empresas directamente, por ejemplo 00445790. Cuando se establezca, se ignoran los campos de búsqueda inferiores. |
query | string | Búsqueda de nombre de empresa en texto libre clasificada por relevancia (hasta 1.000 resultados). |
nameIncludes | string | Búsqueda filtrada: el nombre de la empresa contiene este texto. |
nameExcludes | string | Búsqueda filtrada: el nombre de la empresa no contiene este texto. |
location | string | Ciudad, pueblo o código postal de la oficina registrada, por ejemplo Leeds o M1. |
statuses | lista de cadenas | por ejemplo, active, dissolved, liquidation, administration. |
companyTypes | lista de cadenas | por ejemplo, ltd, plc, llp, private-limited-guarant-nsc. |
sicCodes | lista de cadenas | Códigos de industria, por ejemplo 62020 (consultoría de TI), 56101 (restaurantes). |
incorporatedFrom | string | YYYY-MM-DD. Use con Incorporated to para listas de clientes potenciales de empresas nuevas. |
incorporatedTo | string | YYYY-MM-DD. |
dissolvedFrom | string | YYYY-MM-DD. |
dissolvedTo | string | YYYY-MM-DD. |
includeDetails | boolean | Obtenga perfil, directivos y propietarios para cada resultado de búsqueda (más lento). Siempre activo para números de empresa. Por defecto: false. |
includeOfficers | boolean | Oficiales actuales con rol, fecha de nombramiento, nacionalidad y ocupación. Por defecto: true. |
includeResignedOfficers | boolean | También liste oficiales que hayan renunciado. Por defecto: false. |
includeOwners | boolean | Personas con control significativo actuales y sus naturalezas de control. Por defecto: true. |
includeFilings | boolean | Las 25 presentaciones más recientes. Por defecto: false. |
maxItems | entero | Número máximo de elementos a devolver (1-500). Predeterminado: 100. |
Ejemplo
curl -X POST https://api.pushbuild.com/uk-companies-house/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "tesco", "maxItems": 20}'Respuesta
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Cada llamada devuelve hasta 500 elementos. Los registros que no pasan la validación o no se encuentran se marcan en los elementos y no se cobran.
Precios
Pague solo por los resultados devueltos: $0,80 por 1.000 empresas. Sin cargo por errores o búsquedas vacías.
Úselo desde Claude, ChatGPT o Cursor
Esta API también es un servidor MCP: https://api.pushbuild.com/mcp/uk-companies-house. Agréguela a cualquier asistente que soporte servidores MCP remotos, con su clave en el encabezado X-API-Key. Mismos precios. Configuración para cada aplicación.
Díganos qué necesitan construir.
Preguntas sobre esta API, volúmenes más altos, o una fuente de datos que necesiten que aún no cubrimos.
hello@pushbuild.com