# French Companies by Area - Official Sirene B2B Lists (`edgarfinance/france-companies-by-area`) Actor

Lists French companies from the official Sirene register (API Recherche d'entreprises) by postcode, city, department, region or radius, NAF code, headcount or creation date, returning SIREN, head office SIRET, address, GPS, NAF and size without personal data, charged per company listed.

- **URL**: https://apify.com/edgarfinance/france-companies-by-area.md
- **Developed by:** [Edgar Finance](https://apify.com/edgarfinance) (community)
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 company listeds

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

## French Companies by Area: official Sirene B2B lists by postcode, city, department or radius

Build **clean B2B prospecting lists of French companies** straight from the **official French company register**. Choose an area (postcodes, INSEE city codes, departments, regions, or a point and a radius) and an activity (NAF / APE code or section), add optional filters (headcount range, PME / ETI / GE category, creation date, active only), and get one row per company with SIREN, head office SIRET, address and GPS position, NAF code and label, size, legal form and VAT number.

The data comes from the **official government API "Recherche d'entreprises"** (DINUM), built on the **INSEE Sirene** register. It is the official alternative to scraping business directories such as PagesJaunes: no scraping, no login, no proxy, no API key, and **no personal data**.

### Why this Actor

- **Official and up to date**: the same register as annuaire-entreprises.data.gouv.fr, updated daily.
- **Complete lists, not just the first 10,000**: the public API stops at 10,000 results per query. The Actor splits large areas automatically (region, then departments, then city code ranges, then activity codes) and removes duplicates, so a whole department or region can be listed.
- **Privacy by design (GDPR)**: individual entrepreneurs (sole traders, micro-entrepreneurs) are never listed, nor companies whose name is the name of a person, and no officer name ever appears in the output. See "Privacy rule" below.
- **Prospecting opt-outs removed by default**: companies flagged in the register as opposed to commercial use of their data are left out (you can keep them for market studies).
- **Head office or local presence**: list the companies based in the area, or every company with an establishment there (shops, branches, sites), with that local establishment's address.
- **Stable, documented output**: 44 fields in the same order on every row, NAF and legal form labels included. Ready for Excel, Google Sheets, a CRM or a database.
- **Pay only for companies delivered**: you are charged per company listed. Excluded companies, duplicates and API errors cost nothing.

### Use cases

- B2B prospecting lists by territory: "all restaurants in Lyon 3e", "plumbers within 20 km of Nantes", "IT services companies in Ile-de-France with 10 to 49 employees".
- New company lists: companies created in the last 3 or 6 months in a department.
- Market sizing and territorial studies: number of companies per activity, size and city.
- Sales territory planning and site selection, with GPS coordinates of each head office.

### Input

Pick **one kind of area**, or none for the whole of France:

| Field | Type | Description |
|---|---|---|
| `postalCodes` | list of strings | Postcodes (5 digits), for example `69003`. |
| `cityCodes` | list of strings | INSEE city codes (5 characters, not postcodes), for example `69123` Lyon, `75056` Paris (districts included). |
| `departments` | list of codes | Department codes: `01` to `95`, `2A`, `2B`, `971` to `976`. |
| `regions` | list of codes | Region codes, for example `11` Ile-de-France, `84` Auvergne-Rhone-Alpes. |
| `latitude`, `longitude`, `radiusKm` | numbers | A point (WGS84) and a radius from 0.1 to 50 km (5 km if empty). |
| `locationMatch` | `headOffice` (default) or `anyEstablishment` | Head office in the area, or any establishment in the area. |

Then optional filters:

| Field | Type | Description |
|---|---|---|
| `nafCodes` | list of strings | NAF rev. 2 codes: subclass `56.10A` or `5610A`, class `56.10`, group `56.1` or division `56`. |
| `nafSections` | list of letters | NAF sections A to U. |
| `employeeRanges` | list of codes | INSEE headcount ranges: `NN`, `00`, `01`, `02`, `03`, `11`, `12`, `21`, `22`, `31`, `32`, `41`, `42`, `51`, `52`, `53`. |
| `companyCategories` | list | `PME`, `ETI`, `GE`. |
| `createdAfter`, `createdBefore` | date | `YYYY-MM-DD` or a relative duration such as `6 months`. |
| `onlyActive` | boolean, default true | Active companies only. |
| `excludeProspectingOptOut` | boolean, default true | Leave out companies opposed to prospecting. |
| `maxItems` | integer, default 1,000 | Maximum number of companies listed (and charged). |
| `maxRequestsPerSecond` | integer 1 to 7, default 6 | Politeness limit towards the public API. |

Example: restaurants based in Lyon 3e.

```json
{
    "postalCodes": ["69003"],
    "nafCodes": ["56.10A"],
    "maxItems": 500
}
```

Example: IT companies (NAF division 62) of 10 to 49 employees created since 2020, within 10 km of Nantes city centre.

```json
{
    "latitude": 47.2184,
    "longitude": -1.5536,
    "radiusKm": 10,
    "nafCodes": ["62"],
    "employeeRanges": ["11", "12"],
    "createdAfter": "2020-01-01"
}
```

### Output

One row per company. Real example from the register (La Poste, listed with `postalCodes: ["75015"]` and `nafCodes: ["53.10Z"]`), local establishment fields omitted:

```json
{
    "siren": "356000000",
    "headOfficeSiret": "35600000000048",
    "name": "LA POSTE",
    "acronym": null,
    "legalFormCode": "5510",
    "legalForm": "SA nationale à conseil d'administration",
    "nafCode": "53.10Z",
    "nafLabel": "Activités de poste dans le cadre d'une obligation de service universel",
    "nafSection": "H",
    "nafSectionLabel": "TRANSPORTS ET ENTREPOSAGE",
    "nafCode2025": "53.10Y",
    "employeeRangeCode": "53",
    "employeeRange": "10000+",
    "employeesMin": 10000,
    "employeesMax": null,
    "employeeRangeYear": "2024",
    "companyCategory": "GE",
    "companyCategoryYear": "2024",
    "creationDate": "1991-01-01",
    "administrativeStatus": "active",
    "closureDate": null,
    "establishmentsCount": 13136,
    "openEstablishmentsCount": 8866,
    "headOfficeAddress": "9 RUE DU COLONEL PIERRE AVIA 75015 PARIS",
    "headOfficePostalCode": "75015",
    "headOfficeCity": "PARIS",
    "headOfficeCityCode": "75115",
    "headOfficeDepartment": "75",
    "headOfficeRegionCode": "11",
    "headOfficeLatitude": 48.831515159,
    "headOfficeLongitude": 2.2780898787,
    "distanceKm": null,
    "vatNumber": "FR39356000000",
    "prospectingOptOut": false,
    "lastUpdated": "2026-11-06T10:02:26",
    "annuaireUrl": "https://annuaire-entreprises.data.gouv.fr/entreprise/356000000",
    "source": "API Recherche d'entreprises (DINUM) on INSEE Sirene data, Licence Ouverte Etalab 2.0"
}
```

With `locationMatch: "anyEstablishment"`, the `localEstablishment*` fields give the company's establishment inside the area (for example the Gérardmer post office: `"localEstablishmentSiret": "35600000046943"`, `"localEstablishmentAddress": "14 BOULEVARD KELSCH 88400 GERARDMER"`). With a radius, `distanceKm` gives the distance to the point.

#### All fields

- **Identity**: `siren`, `headOfficeSiret`, `name`, `acronym`, `legalFormCode`, `legalForm`, `vatNumber`.
- **Activity**: `nafCode`, `nafLabel`, `nafSection`, `nafSectionLabel`, `nafCode2025`.
- **Size**: `employeeRangeCode`, `employeeRange`, `employeesMin`, `employeesMax`, `employeeRangeYear`, `companyCategory`, `companyCategoryYear`.
- **Life cycle**: `creationDate`, `administrativeStatus`, `closureDate`, `establishmentsCount`, `openEstablishmentsCount`, `lastUpdated`.
- **Head office**: `headOfficeAddress`, `headOfficePostalCode`, `headOfficeCity`, `headOfficeCityCode`, `headOfficeDepartment`, `headOfficeRegionCode`, `headOfficeLatitude`, `headOfficeLongitude`.
- **Area match**: `distanceKm`, `localEstablishmentSiret`, `localEstablishmentIsHeadOffice`, `localEstablishmentAddress`, `localEstablishmentPostalCode`, `localEstablishmentCity`, `localEstablishmentLatitude`, `localEstablishmentLongitude`.
- **Compliance and provenance**: `prospectingOptOut`, `annuaireUrl`, `source`.

The dataset has four views (Overview, Location, Local establishments, Legal and size profile). A `SUMMARY` record in the key-value store gives the counters of the run: companies listed and checked, duplicates, companies left out per reason (including the privacy rule), queries and requests made, splits, and whether the list is complete.

### Privacy rule

Nothing personal leaves this Actor. A company is never listed when:

1. it is an **individual entrepreneur** (legal form 1000: sole traders, micro-entrepreneurs), whose name is a person's name;
2. the register gives **no company name** (only a person's name);
3. it is a **group of persons** without legal personality: "indivision", "société créée de fait", "société en participation" (legal forms 2110, 2120, 2210, 2220, 2310, 2320, 2385);
4. its register entry is only **partially public** (diffusion status P);
5. its name or acronym **contains the name of a person**: the surname or first name of one of its officers who is a natural person, or a common French first name (about 1,100 names from the INSEE first-name file; words such as "Saint Jean" are recognised as place names).

Officer names are read from the API answer only to apply rule 5, in memory, then dropped: they are never written to the dataset, the logs or the key-value store. Address complements ("c/o", building names) are removed from addresses, as they can contain a person's name. The rule errs on the side of exclusion. Known limit: a company named only after a person who is not one of its listed officers (for example a former owner) cannot always be recognised.

### Pricing

Pay per event: **$1.00 per 1,000 companies listed** ($0.001 per company), plus the standard Apify run start fee. Companies left out by the filters or the privacy rule, duplicates and failed requests are free. `maxItems` caps the number of companies (and the cost) of a run, and you can also set a maximum cost per run in Apify: the Actor stops cleanly and keeps everything already delivered.

### Use with AI agents (MCP)

This Actor is designed to be called by AI agents through the [Apify MCP server](https://mcp.apify.com) (`https://mcp.apify.com`), which exposes its title, description, input schema and output schema. Every input field has a description, allowed values and an example, and every output field has a type, a meaning and an example, so an agent can build the input and read the results without guessing.

- Actor ID: `edgarfinance/france-companies-by-area`
- Load it as a tool: `https://mcp.apify.com?tools=edgarfinance/france-companies-by-area`, or let the agent find it with `search-actors` and run it with `call-actor`.
- The run returns a dataset: read it with `get-dataset-items` (one item per company), and the counters with `get-key-value-store-record`, key `SUMMARY`.
- Keep runs small and cheap: set `maxItems` in the input (each company listed is charged $0.001), and use `maxTotalChargeUsd` in the call options for a hard cost limit.
- Typical agent requests: "list software companies (NAF 62.01Z) with 10 to 49 employees in department 33", "restaurants within 2 km of 45.7578, 4.8320", "companies created in the last 3 months in postcode 69003".

Minimal input:

```json
{ "postalCodes": ["69003"], "nafCodes": ["56.10A"], "maxItems": 20 }
```

Each dataset item then looks like the output example above (`siren`, `name`, `nafCode`, `nafLabel`, `headOfficeAddress`, `headOfficeLatitude`, `headOfficeLongitude`, `employeeRange`, `vatNumber`...). Invalid input (two kinds of area, unknown NAF code, bad postcode) makes the run fail at once with a readable message and no charge.

### FAQ

**How fast is it?** The public API allows about 7 requests per second and returns 25 companies per page. A postcode with 1,000 companies takes well under a minute; a whole department with tens of thousands of companies takes a few minutes.

**Is the list complete?** Yes for most searches: large areas are split geographically, which loses nothing (for a whole-France search, companies with no establishment in a French region, such as companies registered only abroad, are left aside). When a single city and activity still exceed 10,000 companies, the Actor splits by activity and headcount range, which can miss the rare companies without these codes in the register; the `SUMMARY` record says so (`complete`, `note`, `truncatedQueries`).

**Why are there no phone numbers or e-mails?** The official register does not publish them. Use the `siren` or the website of each company to enrich your list.

**Why is a well-known company missing?** It may be filtered out on purpose: head office outside the area (use `locationMatch: "anyEstablishment"`), opposition to prospecting (set `excludeProspectingOptOut` to false), or a name containing a person's name (privacy rule). The `SUMMARY` record counts each reason.

**Can I use the data commercially?** Yes, under the Licence Ouverte / Open Licence Etalab 2.0, with the source mentioned (the `source` field of each row does it). For direct marketing, also respect the GDPR and the prospecting rules that apply to your use; companies opposed to prospecting are removed by default.

### Limits

- Area: one kind per run, up to 200 postcodes or city codes. Radius search: 50 km at most (API limit).
- The radius search cannot filter headcount, category or status on the API side: those filters are applied after reading, which makes radius searches slower on dense areas.
- A run checks at most 100,000 companies (or 100 times `maxItems` if higher): it stops with a clear message when the filters keep too few of them, for example a narrow creation date over a whole region.
- Data is the public register data only: no phone, e-mail, website, officers or revenue.

### Data source and licence

Data: API Recherche d'entreprises, operated by DINUM (direction interministérielle du numérique), built on the INSEE Sirene register. Sirene data is published under the **Licence Ouverte / Open Licence Etalab 2.0** (https://www.data.gouv.fr/pages/legal/licences/etalab-2-0); the API is open without account or key, within 7 requests per second. Activity and legal form labels: INSEE nomenclatures. You may reuse the data, including commercially, provided you mention the source (for example "Source: INSEE Sirene, via API Recherche d'entreprises"). Every output row carries this mention in the `source` field.

This Actor is an independent tool. It is not affiliated with, or endorsed by, the French administration.

# Actor input Schema

## `postalCodes` (type: `array`):

French postcodes (5 digits), for example 69003 or 88400. Use only one kind of area per run. Up to 200 postcodes.

## `cityCodes` (type: `array`):

INSEE commune codes (code officiel géographique, 5 characters), not postcodes: for example 69123 for Lyon, 75056 for Paris, 2A004 for Ajaccio. Paris, Lyon and Marseille codes include all their districts. Up to 200 codes.

## `departments` (type: `array`):

French departments, by official code (01 to 95, 2A, 2B, 971 to 976). A whole department can hold tens of thousands of companies: combine it with an activity filter or set maxItems.

## `regions` (type: `array`):

French regions, by official code (for example 11 = Ile-de-France, 84 = Auvergne-Rhone-Alpes).

## `latitude` (type: `number`):

Latitude of the centre point in decimal degrees (WGS84), for example 45.7578. Use with longitude and radiusKm instead of the other area fields.

## `longitude` (type: `number`):

Longitude of the centre point in decimal degrees (WGS84), for example 4.8320.

## `radiusKm` (type: `number`):

Search radius around the point, from 0.1 to 50 km (limit of the public API). 5 km when left empty. Only with latitude and longitude.

## `locationMatch` (type: `string`):

headOffice (default): list companies whose head office (siege) is in the area. anyEstablishment: also list companies based elsewhere that have an establishment in the area; that local establishment is returned in the localEstablishment\* fields.

## `nafCodes` (type: `array`):

French NAF rev. 2 activity codes. Accepts a subclass (56.10A or 5610A), a class (56.10), a group (56.1) or a division (56); broader codes are expanded to all their subclasses. Examples: 56.10A restaurants, 62.01Z software development, 43.22A plumbing, 86.23Z dentists. List: https://www.insee.fr/fr/information/2406147

## `nafSections` (type: `array`):

Broad NAF sections (letters A to U). Ignored for codes already given in nafCodes, except that nafCodes outside these sections are dropped.

## `employeeRanges` (type: `array`):

INSEE salaried headcount ranges (tranche d'effectif salarie), as declared in the register. NN means no salaried employee reported or unknown, which covers most very small companies.

## `companyCategories` (type: `array`):

INSEE size category: PME (small and medium, under 250 employees), ETI (intermediate, 250 to 4,999), GE (large, 5,000 or more). Companies without a computed category are excluded when this filter is set.

## `createdAfter` (type: `string`):

Keep companies created on or after this date: an absolute date YYYY-MM-DD or a relative duration such as "6 months" (that long before the run). Useful for lists of new companies.

## `createdBefore` (type: `string`):

Keep companies created on or before this date: YYYY-MM-DD or a relative duration such as "10 years".

## `onlyActive` (type: `boolean`):

true (default): only companies whose legal unit is active in the register. false: closed companies are included too (administrativeStatus tells which).

## `excludeProspectingOptOut` (type: `boolean`):

true (default): leave out companies flagged as opposed to the commercial use of their register data (field opposition_diffusion_commerciale of the API). Recommended for direct marketing. false: keep them, with prospectingOptOut = true.

## `maxItems` (type: `integer`):

The run stops after this many companies are listed (each listed company is one charged event). Default 1,000.

## `maxRequestsPerSecond` (type: `integer`):

Politeness limit towards the public API (its hard limit is 7 per second per IP). Leave the default unless several runs share the same IP.

## Actor input object example

```json
{
  "postalCodes": [
    "69003",
    "69006"
  ],
  "cityCodes": [
    "69123"
  ],
  "departments": [
    "88"
  ],
  "regions": [
    "44"
  ],
  "latitude": 45.7578,
  "longitude": 4.832,
  "radiusKm": 2,
  "locationMatch": "headOffice",
  "nafCodes": [
    "56.10A",
    "56.10C"
  ],
  "nafSections": [
    "I"
  ],
  "employeeRanges": [
    "11",
    "12",
    "21"
  ],
  "companyCategories": [
    "PME"
  ],
  "createdAfter": "2025-01-01",
  "createdBefore": "2020-12-31",
  "onlyActive": true,
  "excludeProspectingOptOut": true,
  "maxItems": 500,
  "maxRequestsPerSecond": 6
}
```

# Actor output Schema

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

All listed companies as JSON items, one per company. Add \&format=csv or \&format=xlsx to download a table.

## `overview` (type: `string`):

Same items reduced to the main prospecting fields (dataset view "overview").

## `summary` (type: `string`):

JSON counters of the run: listed, companiesScanned, duplicates, excluded (per reason, including the privacy rule), queries, requests, splits, truncatedQueries, failedQueries, stoppedByMaxItems, stoppedByBudget, stoppedByScanLimit, complete, note.

# 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 = {
    "postalCodes": [
        "69003"
    ],
    "nafCodes": [
        "56.10A"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("edgarfinance/france-companies-by-area").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 = {
    "postalCodes": ["69003"],
    "nafCodes": ["56.10A"],
}

# Run the Actor and wait for it to finish
run = client.actor("edgarfinance/france-companies-by-area").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 '{
  "postalCodes": [
    "69003"
  ],
  "nafCodes": [
    "56.10A"
  ]
}' |
apify call edgarfinance/france-companies-by-area --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,edgarfinance/france-companies-by-area"
        }
    }
}
```

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/CFMsJ5LCmc9ufb3Ub/builds/SUVo7kUkhugLNtjML/openapi.json
