API pública · v1 · OpenAPI 3.1

Datos de empresas francesas en tus aplicaciones

Una API REST sencilla sobre SIRENE/INSEE: búsqueda, unidades legales, establecimientos, directivos y cuentas anuales. Autenticación por clave, respuestas JSON, cuotas claras.

Obtener una clave API Ver la referencia Probar la API

Empieza en 3 pasos

De la clave a tu primera llamada en minutos.

Activa el acceso de desarrollador

Inicia sesión y añade tu empresa para desbloquear el espacio de API.

Mi espacio

Genera una clave API

Crea una clave pk_live_ y su secreto sk_live_. El secreto se muestra una sola vez — cópialo.

Crear una clave

Haz tu primera llamada

Envía tus dos cabeceras y consulta una empresa por su SIREN.

Ver los endpoints

Una petición, una respuesta JSON

Autentica cada llamada con tu clave y tu secreto. La respuesta va envuelta en { success, data, timestamp }.

URL base

https://companyfrance.fr/api/v1

curl "https://companyfrance.fr/api/v1/unite-legale/552032534" \
  -H "X-API-Key: pk_live_..." \
  -H "X-API-Secret: sk_live_..."

Endpoints principales

Ver la referencia completa

GET

/searchBuscar unidades legales (q, naf, código postal…)

GET

/search/dirigeantsEmpresas por directivo (búsqueda inversa)

GET

/search/adresseEmpresas por dirección (búsqueda inversa)

GET

/unite-legale/{siren}Ficha completa de una unidad legal

GET

/unite-legale/{siren}/etablissementsEstablecimientos (paginados)

GET

/unite-legale/{siren}/dirigeantsDirectivos de la empresa

GET

/unite-legale/{siren}/financesCuentas anuales (Pro/Enterprise)

GET

/etablissement/{siret}Ficha de un establecimiento

Especificación OpenAPI

Formato de respuesta

Todas las respuestas siguen { success, data | error, timestamp }.

Cuotas y límites

Cada respuesta devuelve las cabeceras X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset.