# France Annuaire Entreprises Scraper (SIRENE) (`parseforge/france-annuaire-entreprises-scraper`) Actor

Search the French national business registry (SIRENE) and pull rich company records: SIREN, SIRET, legal name, headquarters, NAF activity, employee band, registration date, directors, capital, status and geo coords. Free filtering by name, sector or location across 30M+ active French firms.

- **URL**: https://apify.com/parseforge/france-annuaire-entreprises-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Business, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $18.00 / 1,000 result items

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true)

## 🇫🇷 France Annuaire Entreprises Scraper

> 🚀 **Pull rich company records from the French national business registry (SIRENE) in seconds.**

> 🕒 **Last updated:** 2026-05-06 · **📊 42 fields** per record · **30M+ active French companies** · **101 départements** · directors, capital, NAF codes, geo coordinates, status

The **France Annuaire Entreprises Scraper** searches the official French national business registry (Annuaire des entreprises, powered by SIRENE) and returns structured records for any company registered in France. SIRENE is the canonical reference maintained by INSEE and is updated daily as companies form, change ownership, or close.

The scraper covers all **30 million active companies and self-employed individuals** across **101 départements**, every NAF/APE activity code, and every legal form. Filters run server-side, so a single run can isolate active bakeries in Paris, every consulting SAS in Lyon, or all registered farms in Brittany.

| 🎯 Target Audience | 💡 Primary Use Cases |
|---|---|
| B2B sales, market research, compliance teams, fintech KYC, journalists, gov-tech analysts | Lead lists by NAF code, KYC and ownership checks, sector benchmarking, regional market sizing, news investigations on French firms |

---

### 📋 What the France Annuaire Entreprises Scraper does

Five filtering workflows in a single run:

- 🔍 **Free-text search.** Match by company name, SIREN, SIRET, or director name across the full registry.
- 🏷️ **NAF/APE filter.** Restrict by INSEE activity code, e.g. `47.11D` for hypermarkets or `62.01Z` for software publishers.
- 📍 **Département filter.** Scope to one of 101 French départements by 2-digit code (75 for Paris, 13 for Bouches-du-Rhône).
- ⚖️ **Legal form filter.** Filter by INSEE legal-nature code (SAS, SARL, SA, micro-entrepreneur, association).
- 🟢 **Status filter.** Active only, closed only, or both.

> 💡 **Why it matters:** clean, server-side filtering removes the parser-and-pagination work from your team and keeps your dataset fresh on every run.

---

### 🎬 Full Demo

_🚧 Coming soon: a 3-minute walkthrough showing how to go from sign-up to a downloaded dataset._

---

### ⚙️ Input

<table>
<thead>
<tr><th>Input</th><th>Type</th><th>Default</th><th>Behavior</th></tr>
</thead>
<tbody>
<tr><td><code>maxItems</code></td><td>integer</td><td><code>10</code></td><td>Records to return. Free plan caps at 10, paid plan up to 1,000,000.</td></tr>
<tr><td><code>query</code></td><td>string</td><td><code>"carrefour"</code></td><td>Free text. Matches name, SIREN, SIRET, or director.</td></tr>
<tr><td><code>department</code></td><td>string</td><td><code>""</code></td><td>2-digit département code. Empty = nationwide.</td></tr>
<tr><td><code>naturejuridique</code></td><td>string</td><td><code>""</code></td><td>INSEE legal-nature code.</td></tr>
<tr><td><code>activite</code></td><td>string</td><td><code>""</code></td><td>NAF/APE activity code.</td></tr>
<tr><td><code>etat_administratif</code></td><td>string</td><td><code>""</code></td><td>`A` active, `C` closed, empty = both.</td></tr>
</tbody>
</table>

**Example: 100 active bakeries in Paris.**

```json
{
    "maxItems": 100,
    "query": "boulangerie",
    "department": "75",
    "etat_administratif": "A"
}
````

**Example: all consulting SAS in Lyon.**

```json
{
    "maxItems": 500,
    "department": "69",
    "naturejuridique": "5710",
    "activite": "70.22Z"
}
```

***

### 📊 Output

Each record contains **42 fields**. Download the dataset as CSV, Excel, JSON, or XML.

#### 🧾 Schema

| Field | Type | Example |
|---|---|---|
| 🆔 `siren` | string | `"552120222"` |
| 🏢 `nomComplet` | string | `"CARREFOUR HYPERMARCHES"` |
| 📋 `siege.siret` | string | `"55212022200013"` |
| 📍 `siege.adresse` | string | `"93 AV DE PARIS, 91300 MASSY"` |
| 🏙️ `siege.commune` | string | `"MASSY"` |
| 🗺️ `siege.departement` | string | `"91"` |
| 🌐 `siege.latitude` | number | null | `48.7306` |
| 🌐 `siege.longitude` | number | null | `2.2757` |
| 🏷️ `natureJuridique` | string | `"5710"` |
| 🛠️ `activitePrincipale` | string | `"47.11F"` |
| 📅 `dateCreation` | string | `"1991-12-23"` |
| 👥 `trancheEffectifSalarie` | string | null | `"50"` |
| 👤 `dirigeants` | array | `[ { name, role } ]` |
| 🟢 `etatAdministratif` | string | `"A"` |
| 🔗 `registryUrl` | string | `"https://annuaire-entreprises.data.gouv.fr/..."` |
| 🕒 `scrapedAt` | ISO 8601 | `"2026-05-06T00:00:00.000Z"` |

#### 📦 Sample records

<details>
<summary><strong>🛒 Major retailer</strong></summary>

```json
{"siren":"652014051","nomComplet":"CARREFOUR","siege":{"siret":"65201405100012","adresse":"93 AV DE PARIS, 91300 MASSY","departement":"91"},"natureJuridique":"5710","activitePrincipale":"70.10Z","dateCreation":"1965-12-31","etatAdministratif":"A"}
```

</details>

<details>
<summary><strong>🥖 Local bakery</strong></summary>

```json
{"siren":"452983201","nomComplet":"BOULANGERIE DUPONT","siege":{"adresse":"12 RUE DU FAUBOURG SAINT-DENIS, 75010 PARIS","departement":"75"},"natureJuridique":"5499","activitePrincipale":"10.71B","etatAdministratif":"A"}
```

</details>

***

### ✨ Why choose this Actor

| | Capability |
|---|---|
| 🇫🇷 | **Authoritative source.** SIRENE is maintained by INSEE and is the legal reference for company existence in France. |
| 🔄 | **Daily updates.** New incorporations, ownership changes, and closures hit SIRENE within 24 hours. |
| 🎯 | **Server-side filters.** Combine query, NAF, département, legal form, and status in one run. |
| 🏷️ | **Rich metadata.** Directors, capital, employee bands, geo coordinates, registry links per record. |
| ⚡ | **Fast.** 100 records in under 30 seconds. |

***

### 📈 How it compares to alternatives

| Approach | Cost | Coverage | Refresh | Filters | Setup |
|---|---|---|---|---|---|
| **⭐ This Actor** | $5 free credit | **30M+** companies | Daily refresh | name, NAF, dept, form, status | ⚡ 2 min |
| Pappers / Societe.com paid | €69+/month | Same SIRENE base | Daily | Yes (paid) | 🐢 Account setup |
| Raw INSEE bulk dump | Free | All | Monthly | None (bulk file) | 🐢 ETL pipeline |
| Manual lookups | Free | Manual | Live | Manual | 🕒 One at a time |

Pick this Actor when you want broad coverage, server-side filtering, and no pipeline maintenance.

***

### 🚀 How to use

1. 📝 **Sign up.** [Create a free account with $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) (takes 2 minutes).
2. 🌐 **Open the Actor.** Go to the France Annuaire Entreprises Scraper page on the Apify Store.
3. 🎯 **Set input.** Pick your filters and `maxItems`.
4. 🚀 **Run it.** Click **Start** and let the Actor collect your data.
5. 📥 **Download.** Grab your results in the **Dataset** tab as CSV, Excel, JSON, or XML.

> ⏱️ Total time from signup to downloaded dataset: **3-5 minutes.** No coding required.

***

### 💼 Business use cases

<table>
<tr>
<td width="50%" valign="top">

#### 💼 Sales & Lead Gen

- Industry-targeted prospect lists by NAF code
- Regional outbound territories by département
- Decision-maker lookups via dirigeants
- Keep CRM data fresh on a schedule

</td>
<td width="50%" valign="top">

#### 🏦 Compliance & KYC

- Verify legal status before contracting
- Beneficial-ownership trails
- Daily monitoring of counterparties
- Sanctions screening enrichment

</td>
</tr>
<tr>
<td width="50%" valign="top">

#### 📊 Market Research

- Sector size and density by département
- Track new incorporations
- Build market maps for investor pitches
- Founder demographics

</td>
<td width="50%" valign="top">

#### 📰 Journalism & Civic

- Verify French companies named in stories
- Investigate ownership networks
- Track shell-company patterns
- Map regional economic activity

</td>
</tr>
</table>

***

### 🔌 Automating France Annuaire Entreprises Scraper

Control the scraper programmatically for scheduled runs and pipeline integrations:

- 🟢 **Node.js.** Install the `apify-client` NPM package.
- 🐍 **Python.** Use the `apify-client` PyPI package.
- 📚 See the [Apify API documentation](https://docs.apify.com/api/v2) for full details.

The [Apify Schedules feature](https://docs.apify.com/platform/schedules) lets you trigger this Actor on any cron interval. Hourly, daily, or weekly refreshes keep downstream databases in sync automatically.

***

### 🌟 Beyond business use cases

Data like this powers more than commercial workflows. The same structured records support research, education, civic projects, and personal initiatives.

<table>
<tr>
<td width="50%">

#### 🎓 Research and academia

- Company demographics for economics papers
- Cite versioned SIRENE pulls
- Course exercises on business registers
- Reproducible ownership network research

</td>
<td width="50%">

#### 🎨 Personal and creative

- Side projects and indie B2B tools
- Local market dashboards
- Hobbyist data exploration
- Newsletter research

</td>
</tr>
<tr>
<td width="50%">

#### 🤝 Non-profit and civic

- Map social-economy enterprises
- Civic transparency on local business density
- Investigate corporate concentration
- Open data contributions

</td>
<td width="50%">

#### 🧪 Experimentation

- Train classification models on legal forms
- Test French B2B product hypotheses
- Prototype agent pipelines
- Validate market-entry scenarios

</td>
</tr>
</table>

***

### 🤖 Ask an AI assistant about this scraper

Open a ready-to-send prompt about this ParseForge actor in the AI of your choice:

- 💬 [**ChatGPT**](https://chat.openai.com/?q=How%20do%20I%20use%20the%20France%20Annuaire%20Entreprises%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)
- 🧠 [**Claude**](https://claude.ai/new?q=How%20do%20I%20use%20the%20France%20Annuaire%20Entreprises%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)
- 🔍 [**Perplexity**](https://perplexity.ai/search?q=How%20do%20I%20use%20the%20France%20Annuaire%20Entreprises%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)
- 🅒 [**Copilot**](https://copilot.microsoft.com/?q=How%20do%20I%20use%20the%20France%20Annuaire%20Entreprises%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)

***

### ❓ Frequently Asked Questions

#### 🧩 How does it work?

Set query, NAF code, département, legal form, or status filters. The Actor calls the official annuaire-entreprises endpoint and emits one structured record per company. Filters run server-side.

#### 🔄 How fresh is the data?

SIRENE is updated daily by INSEE. Every Actor run pulls the latest snapshot.

#### 📊 How many fields per record?

Up to 42 including SIREN, SIRET, full address, geo coordinates, NAF code, legal form, capital, dirigeants, and status.

#### 👥 Does it include directors?

Yes. The `dirigeants` field returns an array of named officers with role when present in the public registry.

#### ⚖️ Is this data public?

Yes. SIRENE is published under the Etalab open license, which permits commercial reuse with attribution.

#### 🔁 Can I schedule recurring runs?

Yes. Use Apify Schedules to refresh hourly, daily, or weekly.

#### 🌍 Does it cover overseas territories?

Yes. SIRENE includes mainland France and all overseas departments and collectivities.

#### 💳 Do I need a paid Apify plan?

No. The free plan covers preview runs (10 records). Paid lifts the cap and unlocks scheduling.

#### 🆘 What if a run fails?

Apify retries transient errors automatically. Partial datasets are preserved.

#### 🔌 What about closed companies?

Set `etat_administratif` to `C` to filter to closed-only for offboarding research.

***

### 🔌 Integrate with any app

France Annuaire Entreprises Scraper connects to any cloud service via [Apify integrations](https://apify.com/integrations):

- [**Make**](https://docs.apify.com/platform/integrations/make) - Automate multi-step workflows
- [**Zapier**](https://docs.apify.com/platform/integrations/zapier) - Connect with 5,000+ apps
- [**Slack**](https://docs.apify.com/platform/integrations/slack) - Get run notifications in your channels
- [**Airbyte**](https://docs.apify.com/platform/integrations/airbyte) - Pipe data into your warehouse
- [**GitHub**](https://docs.apify.com/platform/integrations/github) - Trigger runs from commits and releases
- [**Google Drive**](https://docs.apify.com/platform/integrations/drive) - Export datasets straight to Sheets

You can also use webhooks to trigger downstream actions when a run finishes.

***

### 🔗 Recommended Actors

- [**🌐 GLEIF LEI Scraper**](https://apify.com/parseforge/gleif-lei-scraper) - Global Legal Entity Identifier records
- [**🇮🇸 Iceland Skatturinn Companies**](https://apify.com/parseforge/iceland-skatturinn-companies-scraper) - Icelandic tax registry company search
- [**📈 SEC EDGAR Full-Text Search**](https://apify.com/parseforge/sec-edgar-full-text-search-scraper) - Search every SEC filing back to 2001
- [**🏛️ FINRA BrokerCheck Scraper**](https://apify.com/parseforge/finra-brokercheck-scraper) - U.S. broker-dealer profiles and disclosures
- [**🌏 World Bank Indicators Scraper**](https://apify.com/parseforge/worldbank-indicators-scraper) - Country economic indicators across 60+ years

> 💡 **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge) for more reference-data scrapers.

***

**🆘 Need Help?** [**Open our contact form**](https://tally.so/r/BzdKgA) to request a new scraper, propose a custom data project, or report an issue.

***

> **⚠️ Disclaimer:** this Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by INSEE, Annuaire des Entreprises, or any agency of the French Republic. All trademarks mentioned are the property of their respective owners. Only publicly available open data is collected.

# Actor input Schema

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

Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000

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

Company name, SIREN, or SIRET to search. Searches across French company registry.

## `department` (type: `string`):

Filter by French département code (e.g. '75' for Paris, '13' for Marseille).

## `naturejuridique` (type: `string`):

INSEE legal form code (e.g. '5710' for SAS, '5499' for SA).

## `activite` (type: `string`):

NAF/APE activity code, e.g. '47.11D' for hypermarchés.

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

Filter by company state.

## Actor input object example

```json
{
  "maxItems": 10,
  "query": "carrefour",
  "etat_administratif": ""
}
```

# Actor output Schema

## `overview` (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 = {
    "maxItems": 10,
    "query": "carrefour",
    "department": "",
    "naturejuridique": "",
    "activite": ""
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/france-annuaire-entreprises-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 = {
    "maxItems": 10,
    "query": "carrefour",
    "department": "",
    "naturejuridique": "",
    "activite": "",
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/france-annuaire-entreprises-scraper").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "maxItems": 10,
  "query": "carrefour",
  "department": "",
  "naturejuridique": "",
  "activite": ""
}' |
apify call parseforge/france-annuaire-entreprises-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=parseforge/france-annuaire-entreprises-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "France Annuaire Entreprises Scraper (SIRENE)",
        "description": "Search the French national business registry (SIRENE) and pull rich company records: SIREN, SIRET, legal name, headquarters, NAF activity, employee band, registration date, directors, capital, status and geo coords. Free filtering by name, sector or location across 30M+ active French firms.",
        "version": "1.0",
        "x-build-id": "3NgMf5FyZ6Drg1yQW"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/parseforge~france-annuaire-entreprises-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-parseforge-france-annuaire-entreprises-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/parseforge~france-annuaire-entreprises-scraper/runs": {
            "post": {
                "operationId": "runs-sync-parseforge-france-annuaire-entreprises-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/parseforge~france-annuaire-entreprises-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-parseforge-france-annuaire-entreprises-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "maxItems": {
                        "title": "Max Items",
                        "minimum": 1,
                        "maximum": 1000000,
                        "type": "integer",
                        "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000"
                    },
                    "query": {
                        "title": "Search query",
                        "type": "string",
                        "description": "Company name, SIREN, or SIRET to search. Searches across French company registry."
                    },
                    "department": {
                        "title": "Département (2-digit)",
                        "type": "string",
                        "description": "Filter by French département code (e.g. '75' for Paris, '13' for Marseille)."
                    },
                    "naturejuridique": {
                        "title": "Legal nature code",
                        "type": "string",
                        "description": "INSEE legal form code (e.g. '5710' for SAS, '5499' for SA)."
                    },
                    "activite": {
                        "title": "Activity code (NAF/APE)",
                        "type": "string",
                        "description": "NAF/APE activity code, e.g. '47.11D' for hypermarchés."
                    },
                    "etat_administratif": {
                        "title": "Administrative state",
                        "enum": [
                            "",
                            "A",
                            "C"
                        ],
                        "type": "string",
                        "description": "Filter by company state.",
                        "default": ""
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
