# France Companies (SIRENE) Scraper (`seemuapps/pappers-sirene-scraper`) Actor Search 26M+ French companies in the official SIRENE registry — by name, location, NAF code, or SIREN/SIRET — and export to a dataset. - **URL**: https://apify.com/seemuapps/pappers-sirene-scraper.md - **Developed by:** [Andrew](https://apify.com/seemuapps) (community) - **Categories:** E-commerce, Lead generation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 ## France Companies (SIRENE) Scraper Search the official French SIRENE registry of 26+ million companies — by name, location, NAF activity code, manager, or SIREN/SIRET — and export clean records to a dataset. Powered by the official `recherche-entreprises.api.gouv.fr` government data source. ### What you get For every matching company: - **Identity**: SIREN, SIRET (siège), legal name (`nom_complet`, `nom_raison_sociale`), brand (`sigle`) - **Status**: `etat_administratif` (active/closed), creation/closure dates, last update - **Activity**: NAF code, section, employee bracket, company size category (PME/ETI/GE) - **Address**: full address, postal code, commune, département, region, GPS coordinates - **Establishments**: open count, total count - **Financials**: latest revenue (CA) and net result with the year - **Dirigeants**: managers, board, auditors — names, roles, birth years - **Labels**: bio, RGE, Qualiopi, ESS, association, training organization, mission-driven, etc. - **Direct links** to Pappers.fr and the official Annuaire des Entreprises ### Use cases - **B2B prospecting** — build prospect lists by industry, region, or company size - **CRM enrichment** — look up companies by SIREN/SIRET to fill in legal name, address, manager info - **KYC and compliance** — verify legal status, dirigeants, and certifications - **Market research** — count companies in a département, NAF code, or revenue band - **Sales territory planning** — geographic search around any GPS coordinate ### How to use Choose **one or more** of these search modes: 1. **Free-text search** — type a company name, brand, address, or manager name in the **Search query** field 2. **SIREN / SIRET batch** — paste 9-digit SIRENs or 14-digit SIRETs one per line 3. **Geographic search** — enter latitude, longitude, and radius (max 50 km) 4. **Filter-only search** — leave query blank and just set filters (département, NAF code, employee bracket, certifications, etc.) Then set **Max results** (up to 10,000 — the API's hard cap) and run. ### Filters | Filter | Example | Effect | |---|---|---| | Département code | `75` | Only Paris companies | | Region code | `11` | Only Île-de-France | | Postal code | `75008` | Only this postal code | | NAF activity code | `62.01Z` | Software development companies | | Company size | `PME` / `ETI` / `GE` | Filter by INSEE size category | | Employee bracket | `21` (50-99) | Filter by employee count | | Manager last/first name | `MARTIN` / `JEAN` | Find companies whose dirigeant matches | | Certifications | bio, RGE, Qualiopi, ESS, association, training org | Boolean filters | | Min/max revenue (€) | `1000000` | Revenue range | | Administrative status | `A` (active) / `C` (closed) | Default: active only | ### Output format Each dataset record: ```json { "siren": "552081317", "siret_siege": "55208131766522", "nom_complet": "ELECTRICITE DE FRANCE (EDF)", "nom_raison_sociale": "ELECTRICITE DE FRANCE", "sigle": "EDF", "categorie_entreprise": "GE", "date_creation": "1955-01-01", "etat_administratif": "A", "activite_principale": "35.11Z", "tranche_effectif_salarie": "53", "adresse": "22-30 22 AVENUE DE WAGRAM 75008 PARIS", "code_postal": "75008", "commune": "PARIS", "departement": "75", "region": "11", "latitude": 48.876, "longitude": 2.298, "ca": 118690000000, "resultat_net": 11854000000, "annee_finances": "2024", "dirigeants": [ { "type": "personne_physique", "nom": "FONTANA", "prenoms": "BERNARD", "qualite": "Président du conseil d'administration et directeur général", "annee_naissance": "1961", "siren_morale": null, "denomination_morale": null } ], "pappers_url": "https://www.pappers.fr/entreprise/552081317", "annuaire_entreprises_url": "https://annuaire-entreprises.data.gouv.fr/entreprise/552081317", "scraped_at": "2026-05-03T12:00:00.000Z" } ```` ### Data source This actor wraps the official `recherche-entreprises.api.gouv.fr` API maintained by Etalab (French government), which combines INSEE SIRENE, RNE, and INPI data. No API key required, no scraping. # Actor input Schema ## `query` (type: `string`): Free-text search — company name, brand, address, manager name, etc. Leave blank to search by location, SIREN/SIRET, or filters only. ## `sirenList` (type: `array`): Look up specific companies by their 9-digit SIREN. Each value is queried individually. ## `siretList` (type: `array`): Look up specific establishments by their 14-digit SIRET. ## `lat` (type: `string`): Decimal latitude of the centre point, e.g. 48.8566. Combine with Longitude + Radius. ## `lon` (type: `string`): Decimal longitude of the centre point, e.g. 2.3522. Combine with Latitude + Radius. ## `radius` (type: `integer`): Search radius in kilometres for the geographic search. Maximum 50 km. ## `departement` (type: `string`): Filter by département (e.g. 75 for Paris, 13 for Bouches-du-Rhône). ## `region` (type: `string`): Filter by region (INSEE region code, e.g. 11 for Île-de-France, 93 for PACA). ## `codePostal` (type: `string`): 5-digit French postal code, e.g. 75008. ## `codeNaf` (type: `string`): NAF/APE code (e.g. 62.01Z for software development). Comma-separate to query multiple codes. ## `categorieEntreprise` (type: `string`): Filter by INSEE company size category: PME (small/medium), ETI (intermediate), or GE (large enterprise). ## `trancheEffectif` (type: `string`): Filter by employee count bracket (INSEE codes — pick a range from the dropdown). ## `nomDirigeant` (type: `string`): Filter to companies whose dirigeant matches this last name. ## `prenomsDirigeant` (type: `string`): Filter to companies whose dirigeant matches this first name. ## `estAssociation` (type: `boolean`): Restrict to non-profit associations registered under the French 1901 law. ## `estBio` (type: `boolean`): Restrict to companies certified for organic (bio) production by Agence Bio. ## `estRge` (type: `boolean`): Restrict to companies holding the RGE (Reconnu Garant de l'Environnement) energy renovation label. ## `estQualiopi` (type: `boolean`): Restrict to professional training organizations holding the Qualiopi quality certification. ## `estEss` (type: `boolean`): Restrict to companies in the Économie Sociale et Solidaire (cooperatives, mutuals, foundations). ## `estOrganismeFormation` (type: `boolean`): Restrict to declared professional training organizations (organismes de formation). ## `caMin` (type: `integer`): Minimum annual revenue (chiffre d'affaires) in euros. ## `caMax` (type: `integer`): Maximum annual revenue (chiffre d'affaires) in euros. ## `etatAdministratif` (type: `string`): Filter by administrative status: A = active, C = ceased (closed). Default is active only. ## `maxResults` (type: `integer`): Maximum companies to return (the API caps total results at 10,000). ## Actor input object example ```json { "query": "boulangerie", "radius": 5, "categorieEntreprise": "", "trancheEffectif": "", "estAssociation": false, "estBio": false, "estRge": false, "estQualiopi": false, "estEss": false, "estOrganismeFormation": false, "etatAdministratif": "A", "maxResults": 100 } ``` # Actor output Schema ## `results` (type: `string`): Each record: SIREN, SIRET (siège), legal name, address, NAF code, employee bracket, dirigeants, financials, certification labels, and links. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "query": "boulangerie" }; // Run the Actor and wait for it to finish const run = await client.actor("seemuapps/pappers-sirene-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "query": "boulangerie" } # Run the Actor and wait for it to finish run = client.actor("seemuapps/pappers-sirene-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 '{ "query": "boulangerie" }' | apify call seemuapps/pappers-sirene-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=seemuapps/pappers-sirene-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "France Companies (SIRENE) Scraper", "description": "Search 26M+ French companies in the official SIRENE registry — by name, location, NAF code, or SIREN/SIRET — and export to a dataset.", "version": "1.0", "x-build-id": "6tdHRdehZsNZIRAtL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/seemuapps~pappers-sirene-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-seemuapps-pappers-sirene-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/seemuapps~pappers-sirene-scraper/runs": { "post": { "operationId": "runs-sync-seemuapps-pappers-sirene-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/seemuapps~pappers-sirene-scraper/run-sync": { "post": { "operationId": "run-sync-seemuapps-pappers-sirene-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": { "query": { "title": "Search query", "type": "string", "description": "Free-text search — company name, brand, address, manager name, etc. Leave blank to search by location, SIREN/SIRET, or filters only." }, "sirenList": { "title": "SIREN batch (9-digit identifiers)", "type": "array", "description": "Look up specific companies by their 9-digit SIREN. Each value is queried individually.", "items": { "type": "string" } }, "siretList": { "title": "SIRET batch (14-digit establishment identifiers)", "type": "array", "description": "Look up specific establishments by their 14-digit SIRET.", "items": { "type": "string" } }, "lat": { "title": "Latitude (geographic search)", "type": "string", "description": "Decimal latitude of the centre point, e.g. 48.8566. Combine with Longitude + Radius." }, "lon": { "title": "Longitude (geographic search)", "type": "string", "description": "Decimal longitude of the centre point, e.g. 2.3522. Combine with Latitude + Radius." }, "radius": { "title": "Radius (km)", "minimum": 1, "maximum": 50, "type": "integer", "description": "Search radius in kilometres for the geographic search. Maximum 50 km.", "default": 5 }, "departement": { "title": "Département code", "type": "string", "description": "Filter by département (e.g. 75 for Paris, 13 for Bouches-du-Rhône)." }, "region": { "title": "Region code", "type": "string", "description": "Filter by region (INSEE region code, e.g. 11 for Île-de-France, 93 for PACA)." }, "codePostal": { "title": "Postal code", "type": "string", "description": "5-digit French postal code, e.g. 75008." }, "codeNaf": { "title": "NAF activity code", "type": "string", "description": "NAF/APE code (e.g. 62.01Z for software development). Comma-separate to query multiple codes." }, "categorieEntreprise": { "title": "Company size category", "enum": [ "", "PME", "ETI", "GE" ], "type": "string", "description": "Filter by INSEE company size category: PME (small/medium), ETI (intermediate), or GE (large enterprise).", "default": "" }, "trancheEffectif": { "title": "Employee bracket", "enum": [ "", "00", "01", "02", "03", "11", "12", "21", "22", "31", "32", "41", "42", "51", "52", "53" ], "type": "string", "description": "Filter by employee count bracket (INSEE codes — pick a range from the dropdown).", "default": "" }, "nomDirigeant": { "title": "Manager last name", "type": "string", "description": "Filter to companies whose dirigeant matches this last name." }, "prenomsDirigeant": { "title": "Manager first name(s)", "type": "string", "description": "Filter to companies whose dirigeant matches this first name." }, "estAssociation": { "title": "Only associations (loi 1901)", "type": "boolean", "description": "Restrict to non-profit associations registered under the French 1901 law.", "default": false }, "estBio": { "title": "Only bio-certified", "type": "boolean", "description": "Restrict to companies certified for organic (bio) production by Agence Bio.", "default": false }, "estRge": { "title": "Only RGE (energy renovation certified)", "type": "boolean", "description": "Restrict to companies holding the RGE (Reconnu Garant de l'Environnement) energy renovation label.", "default": false }, "estQualiopi": { "title": "Only Qualiopi-certified training orgs", "type": "boolean", "description": "Restrict to professional training organizations holding the Qualiopi quality certification.", "default": false }, "estEss": { "title": "Only ESS (social/solidarity economy)", "type": "boolean", "description": "Restrict to companies in the Économie Sociale et Solidaire (cooperatives, mutuals, foundations).", "default": false }, "estOrganismeFormation": { "title": "Only training organizations", "type": "boolean", "description": "Restrict to declared professional training organizations (organismes de formation).", "default": false }, "caMin": { "title": "Min revenue (EUR)", "type": "integer", "description": "Minimum annual revenue (chiffre d'affaires) in euros." }, "caMax": { "title": "Max revenue (EUR)", "type": "integer", "description": "Maximum annual revenue (chiffre d'affaires) in euros." }, "etatAdministratif": { "title": "Administrative status", "enum": [ "", "A", "C" ], "type": "string", "description": "Filter by administrative status: A = active, C = ceased (closed). Default is active only.", "default": "A" }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum companies to return (the API caps total results at 10,000).", "default": 100 } } }, "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 } } } } } } } } } } ```