# French Company Enrichment — SIREN/SIRET Lookup (`studio-amba/french-company-enrichment`) Actor Enrich French company data from the official government registry. Look up by company name, SIREN, SIRET, postal code, or NAF code. Returns company name, legal form, address, directors, NAF activity codes, employee count, revenue, and all establishments. No cookies, no login. - **URL**: https://apify.com/studio-amba/french-company-enrichment.md - **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community) - **Categories:** E-commerce - **Stats:** 3 total users, 2 monthly users, 66.7% runs succeeded, 1 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 ## French Company Enrichment — SIREN/SIRET Data Lookup Enrich French company data from the official government registry. Look up by company name, SIREN, SIRET, postal code, department, or NAF activity code. Returns company name, legal form, address, directors, NAF codes, employee count, revenue, GPS coordinates, and all establishment locations. No cookies, no login required. ### How to scrape French company data This actor queries the official French government enterprise API (DINUM / INSEE) to deliver structured company data. The registry covers every French business entity — over 25 million active and inactive establishments across metropolitan France and overseas territories. #### Search by Company Name Enter a company name or keyword. The API performs full-text search across all registered French companies and returns matching results ranked by relevance. #### Search by SIREN Number Look up a specific company by its 9-digit SIREN number for an exact match. Every French legal entity has a unique SIREN assigned by INSEE at creation. #### Filter by Location, Activity, or Legal Form Narrow results by postal code, department, NAF activity code, or legal form category. Combine filters to build precisely targeted company lists. ### What data does French Company Enrichment extract? | Field | Type | Description | |-------|------|-------------| | **companyName** | String | Official registered company name | | **siren** | String | 9-digit SIREN number | | **siret** | String | 14-digit SIRET (SIREN + NIC) for headquarters | | **legalForm** | String | Legal form (SAS, SARL, SA, EURL, SCI, etc.) | | **category** | String | Company category (PME, ETI, GE, etc.) | | **status** | String | Active or closed | | **creationDate** | String | Date of creation | | **address** | String | Full headquarters address | | **postalCode** | String | Postal code | | **city** | String | City name | | **department** | String | Department code (75 = Paris, 13 = Bouches-du-Rhone) | | **region** | String | Region | | **latitude** | Number | GPS latitude | | **longitude** | Number | GPS longitude | | **nafCode** | String | NAF/APE activity code | | **nafDescription** | String | Activity description in French | | **nafSection** | String | Activity section letter | | **employeeBand** | String | Employee count band | | **isEmployer** | Boolean | Whether company has declared employees | | **revenue** | Number | Annual revenue (chiffre d'affaires) when available | | **revenueYear** | String | Year of revenue data | | **netProfit** | Number | Net profit (resultat net) when available | | **directors** | Array | Company directors with name, role, and birth year | | **collectiveAgreements** | Array | IDCC codes for applicable collective agreements | | **complianceFlags** | Object | ESS, bio, RGE, qualiopi, and 10+ compliance labels | | **establishments** | Array | All establishment locations (if enabled) | | **totalEstablishments** | Integer | Total number of establishments | | **url** | String | Link to annuaire-entreprises.data.gouv.fr | | **scrapedAt** | String | ISO timestamp of extraction | ### Input Parameters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | **Company Name / Keywords** | String | — | Search by name or keywords | | **SIREN Number** | String | — | 9-digit SIREN for exact lookup | | **Postal Code** | String | — | Filter by postal code | | **Department** | String | — | Filter by department code | | **NAF/APE Code** | String | — | Filter by activity code | | **Legal Form** | String | — | Filter by legal form | | **Active Companies Only** | Boolean | `true` | Exclude closed companies | | **Include Establishments** | Boolean | `false` | Also fetch all establishment locations | | **Max Results** | Integer | `100` | Maximum companies to return | | **Proxy Configuration** | Object | Residential | Proxy settings | ### Example output ```json { "companyName": "Carrefour", "siren": "652014051", "siret": "65201405100666", "legalForm": "SA a conseil d'administration", "category": "GE", "status": "active", "creationDate": "1959-07-01", "address": "93 Avenue de Paris, 91300 Massy", "postalCode": "91300", "city": "Massy", "department": "91", "region": "Ile-de-France", "latitude": 48.7312, "longitude": 2.2712, "nafCode": "70.10Z", "nafDescription": "Activites des sieges sociaux", "nafSection": "M", "employeeBand": "10000+", "isEmployer": true, "revenue": 94137000000, "revenueYear": "2024", "netProfit": 1362000000, "directors": [ { "name": "Bompard", "firstName": "Alexandre", "role": "Directeur general", "birthYear": 1972 }, { "name": "Lagarde", "firstName": "Abigail", "role": "President du conseil d'administration", "birthYear": 1966 } ], "collectiveAgreements": ["2216"], "complianceFlags": { "ess": false, "bio": false, "rge": false }, "establishments": [], "totalEstablishments": 4982, "url": "https://annuaire-entreprises.data.gouv.fr/entreprise/652014051", "scrapedAt": "2026-05-20T14:30:00.000Z" } ```` ### Tips for best results - **Lead generation**: Search by NAF code + department to find all businesses in a specific industry and region. Example: NAF 56.10A (restaurants) in department 75 (Paris). - **CRM enrichment**: Feed a list of SIREN numbers to enrich your CRM contacts with official data including directors, revenue, and employee counts. - **Financial screening**: Revenue and net profit data is available for ~40% of companies. Filter by category "GE" (grandes entreprises) or "ETI" (intermediate) for better coverage. - **Director research**: Every company result includes up to 5 directors with their roles and birth years — useful for KYC, compliance, and B2B prospecting. - **Compliance checks**: The complianceFlags field shows ESS (social economy), bio, RGE (energy), qualiopi (training), and 10+ other official labels. ### How much does it cost? French Company Enrichment runs on the Apify platform. You pay only for compute resources used. | Search size | Estimated time | Estimated cost | |-------------|---------------|----------------| | 10 companies | ~5 seconds | ~$0.003 | | 100 companies | ~30 seconds | ~$0.02 | | 1,000 companies | ~5 minutes | ~$0.15 | | 10,000 companies | ~50 minutes | ~$1.20 | The underlying government API is free and fast. Costs are purely Apify compute. Apify's free tier includes $5 of monthly compute — enough to enrich thousands of companies. ### Can I integrate? Yes. Send enriched French company data directly to your tools: - **Google Sheets** — Build a live French company database, enriched on schedule - **HubSpot / Salesforce** — Enrich CRM contacts with official company data, directors, and revenue - **Slack** — Get notified when companies matching your criteria are found - **Webhooks** — Push to any HTTP endpoint for custom enrichment pipelines ### Can I use it as an API? Yes. Call French Company Enrichment programmatically: #### Python — Enrich by NAF code and department ```python from apify_client import ApifyClient client = ApifyClient("YOUR_API_TOKEN") run = client.actor("studio-amba/french-company-enrichment").call(run_input={ "searchQuery": "boulangerie", "department": "75", "maxResults": 50, }) for company in client.dataset(run["defaultDatasetId"]).iterate_items(): print(f"{company['companyName']} (SIREN {company['siren']}) — {company['city']} — {company['nafDescription']}") ``` #### JavaScript — Lookup by SIREN ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_API_TOKEN' }); const run = await client.actor('studio-amba/french-company-enrichment').call({ siren: '652014051', includeEstablishments: true, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach(c => console.log(`${c.companyName} | ${c.totalEstablishments} locations | Revenue: ${c.revenue}`)); ``` ### FAQ #### What is a SIREN number? SIREN (Systeme d'Identification du Repertoire des Entreprises) is a unique 9-digit identifier assigned by INSEE to every French legal entity. It remains constant throughout the company's life. #### What is a SIRET number? SIRET = SIREN (9 digits) + NIC (5 digits). It identifies a specific establishment (physical location) of a company. A company with 10 offices has 1 SIREN and 10 SIRETs. #### What are NAF codes? NAF (Nomenclature d'Activites Francaise) codes classify companies by economic activity, equivalent to NACE codes in Europe. Each company has a principal NAF code. Example: 62.01Z = Computer programming. #### Where does this data come from? This actor uses the official French government API (DINUM/INSEE), the same data source behind annuaire-entreprises.data.gouv.fr. The data is authoritative, updated regularly, and free to access. #### How current is the revenue data? Revenue (chiffre d'affaires) and profit data comes from annual filings. There is typically a 1-2 year lag. Not all companies are required to publish financials — coverage is approximately 40%. ### Limitations - Revenue and profit data is available for approximately 40% of companies (smaller companies can opt out of publication) - Director data shows up to 5 directors per company - The government API returns max 25 results per page — large extractions need pagination - Some very new companies may not yet appear in the API - Employee count is provided as a band (e.g., "50 to 99") rather than exact numbers ### Other European company register scrapers Working with European business data? Combine with these tools: - **[Belgian Company Enrichment](https://apify.com/studio-amba/kbo-enrichment)** — Belgian KBO/BCE company register - **[German Company Register](https://apify.com/studio-amba/handelsregister-scraper)** — German Handelsregister - **[Dutch Company Register](https://apify.com/studio-amba/kvk-scraper)** — Dutch KVK register ### Your feedback Found a bug or want a feature? Open an issue on the [Issues tab](https://console.apify.com/actors/studio-amba~french-company-enrichment/issues). Your feedback helps improve this actor. # Actor input Schema ## `searchQuery` (type: `string`): Search for companies by name or keywords. Example: 'Carrefour', 'BNP Paribas', 'boulangerie'. ## `siren` (type: `string`): Look up a specific company by its 9-digit SIREN number. ## `postalCode` (type: `string`): Filter by postal code (code postal). Example: '75001'. ## `department` (type: `string`): Filter by department code. Example: '75' for Paris, '13' for Bouches-du-Rhone. ## `nafCode` (type: `string`): Filter by NAF activity code. Example: '62.01Z' for programming, '56.10A' for restaurants. ## `legalForm` (type: `string`): Filter by legal form category. Example: 'SAS', 'SARL', 'SA'. ## `activeOnly` (type: `boolean`): Only return active companies (exclude closed/dissolved). ## `includeEstablishments` (type: `boolean`): Include all establishment locations (etablissements) for each company. ## `maxResults` (type: `integer`): Maximum number of companies to return. ## `proxyConfiguration` (type: `object`): Apify proxy configuration. The government API rarely blocks, but proxies help with large runs. ## Actor input object example ```json { "searchQuery": "Carrefour", "activeOnly": true, "includeEstablishments": false, "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # 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 = { "searchQuery": "Carrefour", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("studio-amba/french-company-enrichment").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 = { "searchQuery": "Carrefour", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("studio-amba/french-company-enrichment").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 '{ "searchQuery": "Carrefour", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call studio-amba/french-company-enrichment --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=studio-amba/french-company-enrichment", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "French Company Enrichment — SIREN/SIRET Lookup", "description": "Enrich French company data from the official government registry. Look up by company name, SIREN, SIRET, postal code, or NAF code. Returns company name, legal form, address, directors, NAF activity codes, employee count, revenue, and all establishments. No cookies, no login.", "version": "0.0", "x-build-id": "t8l5D2hhZy1yGizqg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~french-company-enrichment/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-french-company-enrichment", "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/studio-amba~french-company-enrichment/runs": { "post": { "operationId": "runs-sync-studio-amba-french-company-enrichment", "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/studio-amba~french-company-enrichment/run-sync": { "post": { "operationId": "run-sync-studio-amba-french-company-enrichment", "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": { "searchQuery": { "title": "Company Name / Keywords", "type": "string", "description": "Search for companies by name or keywords. Example: 'Carrefour', 'BNP Paribas', 'boulangerie'." }, "siren": { "title": "SIREN Number", "type": "string", "description": "Look up a specific company by its 9-digit SIREN number." }, "postalCode": { "title": "Postal Code", "type": "string", "description": "Filter by postal code (code postal). Example: '75001'." }, "department": { "title": "Department", "type": "string", "description": "Filter by department code. Example: '75' for Paris, '13' for Bouches-du-Rhone." }, "nafCode": { "title": "NAF/APE Code", "type": "string", "description": "Filter by NAF activity code. Example: '62.01Z' for programming, '56.10A' for restaurants." }, "legalForm": { "title": "Legal Form", "type": "string", "description": "Filter by legal form category. Example: 'SAS', 'SARL', 'SA'." }, "activeOnly": { "title": "Active Companies Only", "type": "boolean", "description": "Only return active companies (exclude closed/dissolved).", "default": true }, "includeEstablishments": { "title": "Include Establishments", "type": "boolean", "description": "Include all establishment locations (etablissements) for each company.", "default": false }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of companies to return.", "default": 100 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Apify proxy configuration. The government API rarely blocks, but proxies help with large runs." } } }, "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 } } } } } } } } } } ```