# France Company Search: SIREN Lookup, Lists & Group Links (`yzy001/france-company-search`) Actor

probe

- **URL**: https://apify.com/yzy001/france-company-search.md
- **Developed by:** [宗諭 楊](https://apify.com/yzy001) (community)
- **Categories:** Lead generation, Business, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 company rows

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 Search: SIREN Lookup, Lists & Group Links

Search the official French company register, the one behind the government's Annuaire des Entreprises: INSEE's Sirene register joined with INPI's national company register (RNE) and public labels. The Actor works in three ways. **Lookup** checks a list of SIREN, SIRET or VAT numbers and returns one row per identifier. **Search** builds a company list from NAF activity codes, department, postal code, region, legal form, size, headcount, revenue and labels. **Group** starts from a company and follows the companies that run it, and the companies it runs, through corporate officers recorded in the RNE.

Every row has the company's identity, status, legal form, NAF activity, head office, size and headcount band, published revenue and net income, VAT number, labels and the officers that are companies. Sole traders and the names of individual people are never returned. Companies that objected to commercial prospecting are left out of search lists by default.

### What you get for each company

| Field | Meaning |
|---|---|
| `siren`, `name`, `displayName`, `acronym` | SIREN (9 digits), legal name, the registry's display name with trade names, acronym |
| `status`, `createdOn`, `ceasedOn` | `ACTIVE` or `CEASED`, creation date, cessation date |
| `legalFormCode`, `legalForm` | INSEE legal category (catégorie juridique), e.g. 5710 SAS, 5499 SARL, 5599 SA |
| `nafCode`, `nafLabel`, `nafSection`, `nafCode2025` | Main activity: NAF rev. 2 code and label, section, and the NAF 2025 code INSEE has started to assign |
| `sizeCategory`, `headcountBand`, `headcountBandLabel`, `headcountMin`, `headcountMax`, `headcountYear` | `SME`, `MID_SIZE` or `LARGE`; INSEE's employee band and the range it stands for |
| `vatNumber`, `otherVatNumbers` | The VAT number the registry lists (standard numeric key first) |
| `headOffice` | SIRET, address, postal code, city, commune code, department, region, country, coordinates, open or closed |
| `establishments`, `openEstablishments` | Number of establishments, and how many are open |
| `revenueEur`, `netIncomeEur`, `latestFinancialYear`, `financials` | Latest published accounts and every year the registry has |
| `labels` | RGE, Qualiopi, ESS, organic, SIAE, mission-driven company, training organisation, EPV, entertainment licence, association, RFAR, FINESS |
| `corporateOfficers` | Officers that are companies: SIREN, name, role (président, gérant, administrateur, commissaire aux comptes...) and a role type |
| `personOfficerCount` | How many officers are individual people (their names are not returned) |
| `prospectingOptOut` | `true` when the company objected to the reuse of its register data for commercial prospecting |
| `partialDiffusion` | `true` when the company asked for partial diffusion: its address is then hidden |
| `registryUrl` | The company's page on the Annuaire des Entreprises |

Lookup rows add `query`, `queryType` (`SIREN`, `SIRET`, `VAT`), `matchStatus` (`FOUND`, `FOUND_COMPANY_NOT_ESTABLISHMENT`, `NOT_FOUND`, `INVALID_ID`, `EXCLUDED_SOLE_TRADER`) and, for a SIRET, the `establishment` with its own address and status. Search rows with a location filter add `matchingEstablishments`. Group rows add `rootSiren`, `level`, `viaSiren`, `viaRole` and `viaRelationshipType`.

### Lookup

Give up to 1,000 identifiers. Each one is checked before it is looked up: SIREN and SIRET check digits, and the key of a French VAT number. A number that fails comes back as `INVALID_ID` with the reason, for example "the VAT key should be 32 for SIREN 403052111". A SIRET returns the company and that establishment's own address, opening and closing dates and trade names. A valid number the public register does not hold is `NOT_FOUND`: either it was never assigned, or the company refused public diffusion. Ceased companies are returned with their status and cessation date.

### Search

Combine any of the filters; within one filter the values are alternatives (NAF 43.21A or 43.22A), between filters they all apply. The registry matches a company when any of its establishments is in the area you chose. With "Location applies to" set to head office (the default) only companies whose head office is in the area are kept, because that is what a list of "companies in Lyon" usually means: in a test search of software companies in the Rhône department, 19 of 60 companies matched by an establishment there also had their head office there. `matchingEstablishments` shows which establishments matched.

The registry returns at most 10,000 matches for one search. When the filters match more, the run summary says so; split the search by department or NAF code to reach the rest.

### Prospecting opt-outs

French companies can object to the reuse of their register data for commercial prospecting (GDPR article 21(2), Code de commerce article R.123-320). Search mode leaves those companies out by default and counts them in the run summary; in the software search above, 86 companies were left out for this reason next to 60 kept. Turn the option off only for uses other than prospecting, such as market research or supplier checks. Lookup and group modes always return the company and show `prospectingOptOut`, because you named the companies yourself.

### Group links

French groups usually run their subsidiaries through the parent company acting as their président, gérant or director, and the RNE records that officer by SIREN. Group mode follows those links:

- **Up**: the officers of the starting company that are companies (its président, gérant, board members, partners), then their officers, and so on.
- **Down**: the companies in which the starting company is an officer, then theirs.

`level` is negative above the starting company and positive below it; `viaSiren` and `viaRole` give the link. By default legal representatives, partners with unlimited liability, board members and GIE members count as links; auditors, liquidators and "other" roles do not unless you add them. A company officer registered abroad has no SIREN and appears as a row with `matchStatus` `NO_FRENCH_RECORD` and its name.

These are management links, not a shareholding register: share percentages are not public in this source. Downward links are found by searching the company's name and keeping only companies whose officer list carries its SIREN, so every link returned is exact, but some can be missed. In a test of 50 known links, 48 were found within 20 result pages; the two missed parents had very short names ("I S I", "L.G."). Each name search that had more result pages than allowed is listed in the run summary under `incompleteDownwardSearches`, and the status message counts them. To map a whole group, start from the top holding.

### Personal data

Sole traders (entrepreneur individuel, legal form 1000) are never returned, in any mode: their company name is the person's own name. A sole trader's number in lookup comes back as `EXCLUDED_SOLE_TRADER` without any other field. Officers who are individual people are only counted. Officers that are companies are listed with their SIREN and name.

### Things to know

- Financial figures exist only for companies that published their accounts; a missing figure means not published, not zero.
- `vatNumber` is the number the registry lists; some companies have none listed, and some bodies have extra numbers with letter keys in `otherVatNumbers`. Current validity for intra-EU trade is checked by the EU's VIES service, not here.
- The registry is updated daily from Sirene and the RNE; `updatedAt` is the date of the last change to the company's record.
- The register allows a limited number of requests per second from cloud servers. The Actor paces its requests and waits when asked to; a run that is refused for too long fails with a clear message rather than returning partial results as complete.
- Source data: Licence Ouverte 2.0.

# Actor input Schema

## `mode` (type: `string`):

search builds a company list from the filters below. lookup returns one row per identifier in ids. group starts from the companies in ids and follows corporate officers up and down.

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

Optional. Company name, address or brand, as on the Annuaire des Entreprises (at least 3 characters unless a filter is set).

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

INSEE NAF rev. 2 codes such as 62.01Z or 6201Z (any of them).

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

Broad activity sections (any of them).

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

Department codes such as 75, 69, 2A or 974 (any of them).

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

Five-digit postal codes (any of them).

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

Regions (any of them).

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

The registry matches a company when any of its establishments is in the area. HEAD_OFFICE keeps only companies whose head office is there.

## `legalFormCodes` (type: `array`):

INSEE legal category codes (catégorie juridique), e.g. 5710 SAS, 5499 SARL, 5599 SA, 6540 SCI, 9220 association. Code 1000 (sole trader) is not available.

## `sizeCategories` (type: `array`):

INSEE size category (any of them).

## `headcountBands` (type: `array`):

INSEE employee bands (any of them).

## `minRevenueEur` (type: `integer`):

Optional. Only companies whose latest published revenue is at least this.

## `maxRevenueEur` (type: `integer`):

Optional. Only companies whose latest published revenue is at most this.

## `labels` (type: `array`):

Only companies carrying all of these labels.

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

Search and group modes: leave out ceased companies. Lookup always returns the status.

## `excludeProspectingOptOuts` (type: `boolean`):

Search mode: leave out companies that objected to the reuse of their register data for commercial prospecting (GDPR art. 21(2)). Turn off only for uses other than prospecting.

## `ids` (type: `array`):

Lookup: up to 1,000 identifiers, one row each. Group: up to 50 starting companies.

## `direction` (type: `string`):

Group mode: follow officers up (companies that are officers of the starting company), down (companies where it is an officer), or both.

## `maxDepth` (type: `integer`):

Group mode: how many links to follow in each direction (1-5).

## `relationshipTypes` (type: `array`):

Group mode: which officer roles count as a link. Auditors, liquidators and 'other' roles are not followed unless you add them.

## `maxSearchPagesPerCompany` (type: `integer`):

Group mode, downward: result pages (25 each) to scan when searching a company's name for the companies it runs (1-100).

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

Stop after this many rows (1-10,000; the registry returns at most 10,000 matches per search).

## Actor input object example

```json
{
  "mode": "search",
  "nafCodes": [
    "62.01Z"
  ],
  "departments": [
    "69"
  ],
  "locationMatch": "HEAD_OFFICE",
  "onlyActive": true,
  "excludeProspectingOptOuts": true,
  "direction": "both",
  "maxDepth": 2,
  "relationshipTypes": [
    "LEGAL_REPRESENTATIVE",
    "PARTNER",
    "BOARD",
    "MEMBER"
  ],
  "maxSearchPagesPerCompany": 20,
  "maxItems": 50
}
```

# Actor output Schema

## `items` (type: `string`):

Company rows.

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

Registry match counts, companies left out and why, incomplete group searches, request counts, caveats.

# 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 = {
    "mode": "search",
    "nafCodes": [
        "62.01Z"
    ],
    "departments": [
        "69"
    ],
    "maxItems": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("yzy001/france-company-search").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 = {
    "mode": "search",
    "nafCodes": ["62.01Z"],
    "departments": ["69"],
    "maxItems": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("yzy001/france-company-search").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 '{
  "mode": "search",
  "nafCodes": [
    "62.01Z"
  ],
  "departments": [
    "69"
  ],
  "maxItems": 50
}' |
apify call yzy001/france-company-search --silent --output-dataset

```

## MCP server setup

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

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/HTOFGCYfFO2pcHWJn/builds/fXbLJ7YM5BtnB6FaX/openapi.json
