APIEmpresas.es Verificación empresarial en segundos
Iniciar sesión

Documentación de la API

Bienvenido a la documentación oficial de APIEmpresas.es. Nuestra API te permite consultar datos mercantiles actualizados de empresas españolas de forma rápida y sencilla.

1. Introducción

La API está diseñada siguiendo principios REST. Todas las respuestas se devuelven en formato JSON y requieren una conexión segura vía HTTPS.

Base URL: https://apiempresas.es/api/v1

2. Autenticación

Para acceder a los endpoints debes incluir tu X-API-KEY en la cabecera de la petición. Puedes generar y copiar tu clave desde tu panel de control. 

GET /api/v1/companies?cif=B12345678 HTTP/1.1
Host: apiempresas.es
X-API-KEY: tu_api_key_aqui
Accept: application/json

3. Consulta por CIF

Obtén la ficha completa de una empresa proporcionando su CIF o NIF.

GET /companies

Parámetros

Campo Tipo Descripción
cif string Requerido. El CIF/NIF de la empresa (ej: B12345678).

Respuesta de éxito (200 OK)

{
  "success": true,
  "data": {
    "cif": "B12345678",
    "name": "EMPRESA DE EJEMPLO SL",
    "status": "ACTIVA",
    "province": "MADRID",
    "cnae": "6201",
    "cnae_label": "Actividades de programación informática"
  }
}

5. Ejemplos de Código

Implementa la conexión en minutos con estos ejemplos listos para usar.

PHP (cURL)

<?php
$apiKey = 'TU_API_KEY';
$cif = 'B12345678';
$url = 'https://apiempresas.es/api/v1/companies?cif=' . $cif;

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-API-KEY: ' . $apiKey,
    'Accept: application/json'
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
print_r($data);
?>

Laravel (HTTP Client)

use Illuminate\Support\Facades\Http;

$response = Http::withHeaders([
    'X-API-KEY' => 'TU_API_KEY'
])->get('https://apiempresas.es/api/v1/companies', [
    'cif' => 'B12345678'
]);

if ($response->successful()) {
    $data = $response->json();
}

CodeIgniter 4

$client = \Config\Services::curlrequest();

$response = $client->request('GET', 'https://apiempresas.es/api/v1/companies', [
    'headers' => [
        'X-API-KEY' => 'TU_API_KEY',
        'Accept'    => 'application/json'
    ],
    'query' => ['cif' => 'B12345678']
]);

$data = json_decode($response->getBody(), true);

Node.js (Fetch)

const fetch = require('node-fetch');

const getCompany = async (cif) => {
  const response = await fetch('https://apiempresas.es/api/v1/companies?cif=' + cif, {
    headers: { 'X-API-KEY': 'TU_API_KEY' }
  });
  const data = await response.json();
  console.log(data);
};

Python (Requests)

import requests

url = "https://apiempresas.es/api/v1/companies"
params = {"cif": "B12345678"}
headers = {"X-API-KEY": "TU_API_KEY"}

response = requests.get(url, params=params, headers=headers)
print(response.json())

JavaScript (Fetch Browser)

fetch('https://apiempresas.es/api/v1/companies?cif=B12345678', {
  headers: {
    'X-API-KEY': 'TU_API_KEY',
    'Accept': 'application/json'
  }
})
.then(res => res.json())
.then(data => console.log(data));

6. Postman Collection

Si prefieres probar la API directamente en Postman, puedes descargarte nuestra colección oficial e importarla con un clic.

Postman

Incluye todos los endpoints configurados, ejemplos de respuestas y variables de entorno.

📥 Descargar Colección Postman