# French Company Search: SIREN, SIRET & Pappers Alternative (`boubap/france-companies-scraper`) Actor

Search millions of French companies (sole traders excluded) from the official SIRENE registry: SIREN, SIRET, NAF code, address, headcount, revenue, net income and VAT number. Filter by keyword, postal code, department, NAF code, size or legal form. No API key.

- **URL**: https://apify.com/boubap/france-companies-scraper.md
- **Developed by:** [Baptiste Bouton](https://apify.com/boubap) (community)
- **Categories:** Lead generation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$4.00 / 1,000 companies

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 Company Search: SIREN, SIRET & Pappers Alternative

**French company search** across millions of businesses in the official **SIRENE** registry (SIREN / SIRET), a **Pappers alternative** with no subscription: legal form, NAF (APE) activity code, headquarters address with GPS coordinates, headcount range, **revenue, net income** and **intra-community VAT number**. Sole traders are excluded, so the output holds zero personal data. Filter by keyword, postal code, department, NAF code, headcount, company size or legal form. Data comes from the French government's official API: no API key, no login, and it costs **$4 per 1,000 companies**.

### What you get vs a Pappers export

| Field | Included |
|---|---|
| SIREN / SIRET | Yes |
| Legal form, NAF code | Yes |
| Address + GPS coordinates | Yes |
| Headcount range | Yes |
| Revenue, net income | Yes (latest published accounts) |
| Intra-community VAT number | Yes |
| Director / manager names | No, excluded as personal data |

### Use cases

- **B2B lead generation in France**: every bakery in Paris 11e, every software company in Lyon, every SME with 50-99 employees in a region.
- **CRM enrichment**: add SIRET, VAT number, NAF code, headcount and revenue to your accounts.
- **KYB and supplier checks**: confirm that a company exists, is active, and get its legal form and VAT number.
- **Market sizing**: count and map companies by activity, size and location.
- **AI agents**: give an agent live French company data through the Apify MCP server.

### Input

```json
{
  "query": "boulangerie",
  "postalCodes": ["75011", "75012"],
  "nafCodes": ["10.71C"],
  "employeeRanges": ["11", "12"],
  "companySize": "PME",
  "activeOnly": true,
  "maxResults": 500
}
```

At least one filter is required. Filters combine with AND; values inside a list combine with OR.

| Field | Example |
|---|---|
| `query` | Name, brand, SIREN/SIRET or activity words: `boulangerie`, `Renault`, `812809234` |
| `postalCodes` | `75011`, `69003` |
| `departments` | `75`, `69`, `2A`, `971` |
| `nafCodes` | `62.01Z` software, `10.71C` bakeries, `56.10A` restaurants, `43.21A` electricians |
| `employeeRanges` | INSEE ranges: `11` = 10-19, `12` = 20-49, `21` = 50-99 … |
| `legalCategories` | `5710` SAS, `5499` SARL, `5720` SASU, `9220` association |
| `companySize` | `PME` (SME), `ETI` (mid-size), `GE` (large) |

### Output

```json
{
  "siren": "797515350",
  "siret": "79751535000024",
  "name": "BOULANGERIE CHAMBELLAND",
  "legalFormCode": "5710",
  "legalForm": "SAS",
  "nafCode": "10.71C",
  "address": "14 RUE TERNAUX 75011 PARIS",
  "postalCode": "75011",
  "city": "PARIS",
  "department": "75",
  "latitude": 48.86438301,
  "longitude": 2.37330495,
  "creationDate": "2013-09-23",
  "employeeRange": "20-49",
  "companySize": "PME",
  "active": true,
  "establishmentsCount": 3,
  "vatNumber": "FR31797515350",
  "financialYear": 2024,
  "revenue": 2646055,
  "netIncome": 2249,
  "url": "https://annuaire-entreprises.data.gouv.fr/entreprise/797515350"
}
```

`revenue` and `netIncome` come from the latest published annual accounts (`financialYear`); they are `null` when the company does not publish its accounts.

### Recipes

**All companies with NAF X in department Y**: set `nafCodes` and `departments`, leave `query` empty, raise `maxResults` up to 10,000.

**Enrich a CRM by SIREN**: run one search per SIREN with `query` set to the number; the first result is the match.

### Pricing

You pay **$0.004 per company** returned ($4 per 1,000). A search with no results costs nothing.

### FAQ

**Do I need an API key or a Pappers / INSEE account?** No. The Actor uses the free public API of the French government (recherche-entreprises.api.gouv.fr).

**Does it return company directors or sole traders?** No. To avoid personal data, directors are never returned and sole traders (entreprises individuelles, which are registered under a person's name) are excluded. You get companies, associations and public bodies only.

**How many results can one search return?** Up to 10,000 companies per search (a limit of the registry API). For larger extractions, split the search by department or postal code.

**How fresh is the data?** The registry is updated daily from INSEE and the RNE, and the Actor queries it live on every run.

# Actor input Schema

## `query` (type: `string`):

Company name, brand, SIREN/SIRET or activity keywords (e.g. boulangerie, logiciel, Renault).

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

Headquarters or establishment postal codes, e.g. 75011, 69003.

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

French department codes, e.g. 75, 69, 2A, 971.

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

Main activity codes with a dot, e.g. 62.01Z (software development), 10.71C (bakeries), 56.10A (restaurants).

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

Employee headcount ranges (INSEE).

## `legalCategories` (type: `array`):

INSEE legal category codes, e.g. 5710 (SAS), 5499 (SARL), 5720 (SASU), 9220 (association).

## `companySize` (type: `string`):

INSEE company category.

## `activeOnly` (type: `boolean`):

Leave out closed companies.

## `maxResults` (type: `integer`):

Upper limit of companies returned (the registry search serves up to 10,000 per search).

## Actor input object example

```json
{
  "query": "boulangerie",
  "postalCodes": [
    "75011"
  ],
  "activeOnly": true,
  "maxResults": 500
}
```

# 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 = {
    "query": "boulangerie",
    "postalCodes": [
        "75011"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("boubap/france-companies-scraper").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 = {
    "query": "boulangerie",
    "postalCodes": ["75011"],
}

# Run the Actor and wait for it to finish
run = client.actor("boubap/france-companies-scraper").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 '{
  "query": "boulangerie",
  "postalCodes": [
    "75011"
  ]
}' |
apify call boubap/france-companies-scraper --silent --output-dataset

```

## MCP server setup

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

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/U9Goo8kkNd07xG4xA/builds/7aYkpHTSPNLwhrZua/openapi.json