# France Company Register (Recherche Entreprises / INSEE SIRENE) (`gettingtechnicl/france-company-register`) Actor

Extract company data from France Company Register (Recherche Entreprises / INSEE SIRENE) via its official public JSON API. Search by q, activite principale, categorie entreprise and export 134 structured fields per company as JSON, CSV or Excel - reliable, with no fragile HTML scraping.

- **URL**: https://apify.com/gettingtechnicl/france-company-register.md
- **Developed by:** [Terry Gluff](https://apify.com/gettingtechnicl) (community)
- **Categories:** Lead generation, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 verified record extracteds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## France Company Register (Recherche Entreprises / INSEE SIRENE)

Extract company data from France Company Register (Recherche Entreprises / INSEE SIRENE) via its official public JSON API. Search by q, activite principale, categorie entreprise and export 134 structured fields per company as JSON, CSV or Excel - reliable, with no fragile HTML scraping.

### What you get

Every record is delivered as a clean, structured row you can export to **JSON, CSV, or Excel**. Fields include:

- `siren`
- `siren_conserve`
- `nom_complet`
- `nom_raison_sociale`
- `sigle`
- `nombre_etablissements`
- `nombre_etablissements_ouverts`
- `siege_activite_principale`
- `siege_activite_principale_naf25`
- `activite_principale_registre_metier`
- `siege_annee_tranche_effectif_salarie`
- `siege_adresse`
- `siege_caractere_employeur`
- `cedex`
- `code_pays_etranger`
- `siege_code_postal`
- `siege_commune`
- `complement_adresse`
- `coordonnees`
- `siege_date_creation`
- `siege_date_debut_activite`
- `siege_date_fermeture`
- `siege_date_mise_a_jour`
- `siege_date_mise_a_jour_insee`
- `departement`
- `distribution_speciale`
- `siege_epci`
- `siege_est_siege`
- `siege_etat_administratif`
- `geo_adresse`
- `siege_geo_id`
- `indice_repetition`
- `siege_latitude`
- `libelle_cedex`
- `siege_libelle_commune`
- `libelle_commune_etranger`
- `libelle_pays_etranger`
- `libelle_voie`
- `siege_liste_enseignes`
- `siege_liste_finess`

### Input

Configure the run with these options (all optional -- leave blank to fetch everything):

- **Q** — Termes pour une recherche textuelle (dénomination et/ou adresse, dirigeants, élus) ou recherche directe (SIREN, SIRET).
- **Activite Principale** — Le code NAF ou code APE, un code d'activité suivant la nomenclature de l'INSEE . Ce paramètre accepte une valeur unique ou une liste de valeurs séparées par des virgules. Il ne s'applique qu'à l'unité légale, et non à ses établissements.
- **Categorie Entreprise** — Catégorie d'entreprise de l'unité légale . Ce paramètre accepte une valeur unique ou une liste de valeurs séparées par des virgules.
- **Code Collectivite Territoriale** — Code affilié à une collectivité territoriale (Commune - code INSEE, EPCI - n° SIREN, Département - Code INSEE + "D" (sauf cas particulier), Région - Code INSEE)
- **Convention Collective Renseignee** — Entreprises ayant au moins un établissement dont la convention collective est renseignée.
- **Code Postal** — Code postal en 5 chiffres. Ce paramètre filtre sur les établissements et accepte une valeur unique ou une liste de valeurs séparées par des virgules.
- **Code Commune** — Code commune (INSEE) en 5 caractères . Ce paramètre filtre sur les établissements et accepte une valeur unique ou une liste de valeurs séparées par des virgules.
- **Departement** — Code de département en deux ou trois chiffres . Ce paramètre filtre sur les établissements et accepte une valeur unique ou une liste de valeurs séparées par des virgules.
- **Region** — Code de région en deux chiffres . Ce paramètre filtre sur les établissements et accepte une valeur unique ou une liste de valeurs séparées par des virgules.
- **Epci** — Liste des epci valides . Ce paramètre filtre sur les établissements et accepte une valeur unique ou une liste de valeurs séparées par des virgules.
- **Egapro Renseignee** — Uniquement les entreprises ayant un index égapro renseigné
- **Est Achats Responsables** — Uniquemement les entreprises ayant le label Relations Fournisseurs et Achats Responsables (RFAR).
- **Est Alim Confiance** — Uniquement les entreprises ayant au moins un établissement avec un résultat de contrôle sanitaire Alim'Confiance.
- **Est Association** — Uniquement les entreprises ayant un identifiant d'association ou une nature juridique avec mention "association" (5195, 9210, 9220, 9221, 9222, 9223, 9224, 9230, 9240, 9260).
- **Est Bio** — Uniquement les entreprises ayant un établissement certifié par l'agence bio
- **Est Collectivite Territoriale** — Uniquement les collectivités territoriales.
- **Est Entrepreneur Individuel** — Uniquement les entreprises individuelles.
- **Est Entrepreneur Spectacle** — Uniquement les entreprises ayant une licence d'entrepreneur du spectacle.
- **Est Ess** — Uniquement les entreprises appartenant au champ de l'économie sociale et solidaire.
- **Est Finess** — Uniquement les entreprises du domaine sanitaire et social (FINESS). Recherche à la fois dans les identifiants FINESS Géographiques des établissements et FINESS Juridiques des entreprises.
- **Maximum results** — cap how many records to return.

### How to use

1. Click **Start** (or call the Actor via the [Apify API](https://docs.apify.com/api/v2) or a client SDK).
2. Set any filters you need and run it.
3. Download the results as JSON, CSV, or Excel from the run's dataset.

### Pricing

This Actor uses **pay-per-result** pricing: you are billed only for the records it returns, with no monthly subscription.

### Notes

This Actor collects publicly available data. Please use it responsibly and in line with the source website's terms of service.

# Actor input Schema

## `q` (type: `string`):

Termes pour une recherche textuelle (dénomination et/ou adresse, dirigeants, élus) ou recherche directe (SIREN, SIRET).

## `activite_principale` (type: `string`):

Le code NAF ou code APE, un code d'activité suivant la nomenclature de l'INSEE . Ce paramètre accepte une valeur unique ou une liste de valeurs séparées par des virgules. Il ne s'applique qu'à l'unité légale, et non à ses établissements.

## `categorie_entreprise` (type: `string`):

Catégorie d'entreprise de l'unité légale . Ce paramètre accepte une valeur unique ou une liste de valeurs séparées par des virgules.

## `code_collectivite_territoriale` (type: `string`):

Code affilié à une collectivité territoriale (Commune - code INSEE, EPCI - n° SIREN, Département - Code INSEE + "D" (sauf cas particulier), Région - Code INSEE)

## `convention_collective_renseignee` (type: `boolean`):

Entreprises ayant au moins un établissement dont la convention collective est renseignée.

## `code_postal` (type: `string`):

Code postal en 5 chiffres. Ce paramètre filtre sur les établissements et accepte une valeur unique ou une liste de valeurs séparées par des virgules.

## `code_commune` (type: `string`):

Code commune (INSEE) en 5 caractères . Ce paramètre filtre sur les établissements et accepte une valeur unique ou une liste de valeurs séparées par des virgules.

## `departement` (type: `string`):

Code de département en deux ou trois chiffres . Ce paramètre filtre sur les établissements et accepte une valeur unique ou une liste de valeurs séparées par des virgules.

## `region` (type: `string`):

Code de région en deux chiffres . Ce paramètre filtre sur les établissements et accepte une valeur unique ou une liste de valeurs séparées par des virgules.

## `epci` (type: `string`):

Liste des epci valides . Ce paramètre filtre sur les établissements et accepte une valeur unique ou une liste de valeurs séparées par des virgules.

## `egapro_renseignee` (type: `boolean`):

Uniquement les entreprises ayant un index égapro renseigné

## `est_achats_responsables` (type: `boolean`):

Uniquemement les entreprises ayant le label Relations Fournisseurs et Achats Responsables (RFAR).

## `est_alim_confiance` (type: `boolean`):

Uniquement les entreprises ayant au moins un établissement avec un résultat de contrôle sanitaire Alim'Confiance.

## `est_association` (type: `boolean`):

Uniquement les entreprises ayant un identifiant d'association ou une nature juridique avec mention "association" (5195, 9210, 9220, 9221, 9222, 9223, 9224, 9230, 9240, 9260).

## `est_bio` (type: `boolean`):

Uniquement les entreprises ayant un établissement certifié par l'agence bio

## `est_collectivite_territoriale` (type: `boolean`):

Uniquement les collectivités territoriales.

## `est_entrepreneur_individuel` (type: `boolean`):

Uniquement les entreprises individuelles.

## `est_entrepreneur_spectacle` (type: `boolean`):

Uniquement les entreprises ayant une licence d'entrepreneur du spectacle.

## `est_ess` (type: `boolean`):

Uniquement les entreprises appartenant au champ de l'économie sociale et solidaire.

## `est_finess` (type: `boolean`):

Uniquement les entreprises du domaine sanitaire et social (FINESS). Recherche à la fois dans les identifiants FINESS Géographiques des établissements et FINESS Juridiques des entreprises.

## `est_organisme_formation` (type: `boolean`):

Uniquement les entreprises ayant un établissement organisme de formation

## `est_patrimoine_vivant` (type: `boolean`):

Uniquement les entreprises ayant le label Entreprise du Patrimoine Vivant (EPV)

## `est_qualiopi` (type: `boolean`):

Uniquement les entreprises ayant ayant une certification de la marque « Qualiopi »

## `est_rge` (type: `boolean`):

Uniquement les entreprises reconnues garantes de l'Environnement (RGE).

## `est_siae` (type: `boolean`):

Uniquement les structures d'insertion par l'activité économique (SIAE).

## `est_administration` (type: `boolean`):

Uniquement les structures reconnues comme administration. Attention : Ce filtre se base sur cette liste ici . Ce filtre n'est pas exhaustif et peut retourner des faux positifs.

## `est_societe_mission` (type: `boolean`):

Uniquement les sociétés qui appartiennent au champ des sociétés à mission.

## `est_uai` (type: `boolean`):

Uniquement les entreprises ayant un établissement UAI (Unité Administrative Immatriculée).

## `etat_administratif` (type: `string`):

État administratif de l'unité légale. "A" pour Active, "C" pour Cessée.

## `id_convention_collective` (type: `string`):

Identifiant de Convention Collective d'un établissement d'une entreprise.

## `id_finess` (type: `string`):

Identifiant FINESS Géographique d'un établissement (9 chiffres). Cette recherche interroge uniquement les FINESS Géographiques des établissements.

## `id_rge` (type: `string`):

Identifiant RGE (reconnues garantes de l'Environnement) d'un établissement d'une entreprise.

## `id_uai` (type: `string`):

Identifiant UAI d'un établissement d'une entreprise.

## `nature_juridique` (type: `string`):

Catégorie juridique de l'unité légale. Ce paramètre accepte une valeur unique ou une liste de valeurs séparées par des virgules.

## `section_activite_principale` (type: `string`):

Section de l'activité principale : \* `A` - Agriculture, sylviculture et pêche \* `B` - Industries extractives \* `C` - Industrie manufacturière \* `D` - Production et distribution d'électricité, de gaz, de vapeur et d'air conditionné \* `E` - Production et distribution d'eau ; assainissement, gestion des déchets et dépollution \* `F` - Construction \* `G` - Commerce ; réparation d'automobiles et de motocycles \* `H` - Transports et entreposage \* `I` - Hébergement et restauration \* `J` - Information et communication \* `K` - Activités financières et d'assurance \* `L` - Activités immobilières \* `M` - Activités spécialisées, scientifiques et techniques \* `N` - Activités de services administratifs et de soutien \* `O` - Administration publique \* `P` - Enseignement \* `Q` - Santé humaine et action sociale \* `R` - Arts, spectacles et activités récréatives \* `S` - Autres activités de services \* `T` - Activités des ménages en tant qu'employeurs ; activités indifférenciées des ménages en tant que producteurs de biens et services pour usage propre \* `U` - Activités extra-territoriales Ce paramètre accepte une valeur unique ou une liste de valeurs séparées par des virgules.

## `tranche_effectif_salarie` (type: `string`):

Tranche d'effectif salarié de l'entreprise . Ce paramètre accepte une valeur unique ou une liste de valeurs séparées par des virgules.

## `nom_personne` (type: `string`):

Nom d'une personne partie prenante de l'entreprise (dirigeant ou élu).

## `prenoms_personne` (type: `string`):

Prenom(s) d'une personne partie prenante de l'entreprise (dirigeant ou élu).

## `date_naissance_personne_min` (type: `string`):

Valeur minimale de la date de naissance d'une personne partie prenante de l'entreprise (dirigeant ou élu). Formats acceptés : aaaa-mm-jj ou aaaa-mm. Le jour, s'il est fourni, est ignoré : la recherche s'effectue au mois près.

## `date_naissance_personne_max` (type: `string`):

Valeur maximale de la date de naissance d'une personne partie prenante de l'entreprise (dirigeant ou élu). Formats acceptés : aaaa-mm-jj ou aaaa-mm. Le jour, s'il est fourni, est ignoré : la recherche s'effectue au mois près.

## `type_personne` (type: `string`):

Type de la partie prenante de l'entreprise, dirigeant ou élu.

## `ca_min` (type: `integer`):

Valeur minimale du chiffre d'affaire de l'entreprise

## `ca_max` (type: `integer`):

Valeur maximale du chiffre d'affaire de l'entreprise

## `resultat_net_min` (type: `integer`):

Valeur minimale du résultat net de l'entreprise

## `resultat_net_max` (type: `integer`):

Valeur maximale du résultat net de l'entreprise

## `limite_matching_etablissements` (type: `integer`):

Nombre d'établissements connexes inclus dans la réponse (matching_etablissements). Valeur entre 1 et 100.

## `minimal` (type: `boolean`):

Permet de retourner une réponse minmale, qui exclut les champs secondaires. Voir "include" pour en savoir plus.

## `include` (type: `string`):

ATTENTION : Ce paramètre ne peut être appelé qu'avec le champ "minimal=True". Permet de ne demander que certains des champs secondaires. Valeurs possibles : \* complements \* dirigeants \* finances \* matching_etablissements \* siege \* score \* tva Par défaut tous les champs sont inclus sauf le score. Ce paramètre accepte une valeur unique ou une liste de valeurs séparées par des virgules.

## `page_etablissements` (type: `integer`):

Numéro de page pour la pagination des établissements connexes (matching_etablissements).

## `sort_by_size` (type: `boolean`):

Permet de trier les résultats par taille d'entreprise (nombre d'établissements).

## `max_items` (type: `integer`):

Maximum number of records to fetch and push to the dataset.

## `proxyConfiguration` (type: `object`):

Apify Proxy configuration. Defaults to Apify Proxy (datacenter): many sites serve REDUCED or blocked content to Apify's bare platform IP but full content through a proxy (BuyRentKenya returned 5 vs 25 listings, run 41307), so a proxy is used by default for complete, reliable results. Switch to Residential here if a site also blocks datacenter IPs.

## Actor input object example

```json
{
  "q": "restaurant",
  "limite_matching_etablissements": 10,
  "page_etablissements": 1,
  "max_items": 3,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "q": "restaurant",
    "max_items": 3,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("gettingtechnicl/france-company-register").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "q": "restaurant",
    "max_items": 3,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("gettingtechnicl/france-company-register").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "q": "restaurant",
  "max_items": 3,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call gettingtechnicl/france-company-register --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,gettingtechnicl/france-company-register"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/LkjYjChuWcln1tFiD/builds/6TqYupmzxDpICfEMr/openapi.json