# France Societe.com Company Scraper (`minute_contest/societe-com-scraper`) Actor Scrape French company data from Societe.com - directors, simplified financials, shareholders, subsidiaries, and corporate relationships. The richest free French company data source with no API. - **URL**: https://apify.com/minute\_contest/societe-com-scraper.md - **Developed by:** [minute contest](https://apify.com/minute_contest) (community) - **Categories:** Business, Lead generation, Automation - **Stats:** 2 total users, 2 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 company records 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 ## France Company Scraper - Societe.com | Donnees d'entreprises francaises Scrape French company data from Societe.com - directors, financials, shareholders, subsidiaries, and corporate network for any French company. Aggregates INSEE, INPI, and BODACC data. No API exists for this data. ### Quick Start Click **Try it** and paste this input: ```json { "searchQuery": "Total Energies", "maxResults": 10 } ```` ### Sample Output ```json { "companyName": "TOTALENERGIES SE", "siren": "542051180", "siret": "54205118000066", "legalForm": "SA a conseil d'administration", "nafCode": "70.10Z", "nafDescription": "Activites des sieges sociaux", "address": "2 Place Jean Millier, La Defense 6", "postalCode": "92400", "city": "Courbevoie", "capital": "6 596 521 497,50 EUR", "creationDate": "1924-03-24", "status": "Active", "employeeCount": "100 000+", "revenue": "218 945 000 000 EUR", "netResult": "15 764 000 000 EUR", "directors": [ { "name": "POUYANNE Patrick", "role": "President-Directeur General", "appointmentDate": "2015-10-29" } ], "shareholders": ["Etat Francais", "BlackRock"], "subsidiaries": "1 200+", "brands": ["TotalEnergies", "Elf"], "sourceUrl": "https://www.societe.com/societe/totalenergies-se-542051180.html" } ``` ### Pricing | Volume | Cost | |--------|------| | Start cost | $0.005 | | Per result | $0.005 | | ~100 results | ~$0.51 | | ~1,000 results | ~$5.01 | | ~10,000 results | ~$50.01 | No subscriptions, no minimum commitment - pay only for what you use. ### Features - **Search by company name** - partial match across all French companies - **Direct SIREN lookup** - provide 9-digit SIREN numbers for exact company pages - **Search by manager name** - find all companies where a person holds a director role - **Full company identity** - SIREN, SIRET, legal form, NAF code, address, capital, creation date, status - **Director extraction** - names, roles (President, Gerant, DG, etc.), appointment dates - **Simplified financials** - last reported revenue and net result - **Shareholder and subsidiary data** - ownership chains and corporate network ### Input Parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `searchQuery` | string | No | - | Company name to search (partial match) | | `sirenNumbers` | string\[] | No | - | List of 9-digit SIREN numbers for direct lookup | | `managerName` | string | No | - | Search by director/manager name | | `includeFinancials` | boolean | No | `true` | Scrape the /bilan/ financial data page | | `includeDirectors` | boolean | No | `true` | Scrape the /dirigeants/ directors page | | `maxResults` | integer | No | `50` | Max search results to process | | `proxyConfiguration` | object | No | - | Apify Proxy settings (residential recommended) | At least one of `searchQuery`, `sirenNumbers`, or `managerName` must be provided. #### More Input Examples **Direct SIREN lookup (multiple companies):** ```json { "sirenNumbers": ["542051180", "652014051", "662042449"], "includeFinancials": true, "includeDirectors": true } ``` **Search by director name:** ```json { "managerName": "Dupont Jean", "maxResults": 20 } ``` **Fast lookup - identity only (no financials/directors pages):** ```json { "sirenNumbers": ["542051180"], "includeFinancials": false, "includeDirectors": false } ``` ### Output Fields | Field | Type | Description | |-------|------|-------------| | `companyName` | string | Official company name (denomination sociale) | | `siren` | string | 9-digit SIREN identification number | | `siret` | string | 14-digit SIRET number (siege social) | | `legalForm` | string | Legal form - SARL, SAS, SA, SCI, EURL, etc. | | `nafCode` | string | NAF/APE activity code (e.g. 62.01Z) | | `nafDescription` | string | NAF activity description in French | | `address` | string | Registered address (siege social) | | `postalCode` | string | 5-digit French postal code | | `city` | string | City | | `capital` | string | Registered share capital | | `creationDate` | string | Date of company creation | | `status` | string | Company status - Active, En liquidation, Radiee, etc. | | `employeeCount` | string | Employee count or range | | `revenue` | string | Last reported revenue (chiffre d'affaires) | | `netResult` | string | Last reported net result (resultat net) | | `directors` | array | Directors with name, role, appointmentDate | | `shareholders` | array | Shareholder names if available | | `subsidiaries` | string | Number of subsidiaries if listed | | `brands` | array | Brand/trademark names if listed | | `sourceUrl` | string | URL of the Societe.com company page | ### Use Cases - **B2B prospecting** - build targeted lead lists by industry (NAF code), size, or region, enriched with director names - **Due diligence** - verify company identity, legal status, financial health, and management team before deals - **Competitive intelligence** - monitor competitor financials, director changes, and subsidiary networks - **M\&A research** - map corporate structures, identify subsidiaries, cross-reference director networks - **KYC/AML compliance** - verify French company registration, active status, and beneficial ownership chains ### Data Source & Compliance All data comes from [Societe.com](https://www.societe.com/) - France's most comprehensive free company data platform. Societe.com aggregates official data from: - **INSEE** (Institut National de la Statistique et des Etudes Economiques) - company registry - **INPI** (Institut National de la Propriete Industrielle) - trademarks and IP - **BODACC** (Bulletin Officiel des Annonces Civiles et Commerciales) - legal announcements The data is publicly accessible and free to browse. Director names are public information filed with official French registries (RCS). The Actor implements respectful rate limiting (3-5 seconds between page loads). Users are responsible for their own compliance with GDPR and French data protection law. ### European Business Data Suite This Actor is part of a growing collection of European company data actors. No subscriptions, no minimum commitment - pay only for what you use. | Country | Actor | Data Source | What it does | |---------|-------|-------------|-------------| | **France** | **Societe.com Scraper** | Societe.com | Company identity, directors, financials, network | | **Spain** | [Company Directory](https://apify.com/minute_contest/spain-company-directory-scraper) | OpenData Registradores | NIF, officers, CNAE codes, legal form | | **Poland** | [Financial Statements](https://apify.com/minute_contest/poland-krs-financial-scraper) | eKRS | Balance sheets, income statements | | **Poland** | [Board Members](https://apify.com/minute_contest/krs-fullnames-scraper) | KRS | Full non-anonymized director names | | **Poland** | [Debtor Registry](https://apify.com/minute_contest/krz-debtor-scraper) | KRZ | Bankruptcy, restructuring, enforcement | | **Poland** | [Financial Supervision](https://apify.com/minute_contest/knf-registry-scraper) | KNF | 75,000+ regulated financial entities | | **Poland** | [Court Gazette](https://apify.com/minute_contest/msig-scraper) | MSiG | Court announcements since 2001 | | **Poland** | [Land Registry](https://apify.com/minute_contest/ekw-ksiegi-wieczyste-scraper) | EKW | Property ownership, mortgages | | **Poland** | [Beneficial Owners](https://apify.com/minute_contest/crbr-beneficial-owners-scraper) | CRBR | UBO verification by NIP/KRS | | **Poland** | [Abusive Clauses](https://apify.com/minute_contest/uokik-clauses-scraper) | UOKiK | 7,500+ banned contract clauses | | **Poland** | [Waste Registry](https://apify.com/minute_contest/bdo-waste-registry-scraper) | BDO | 674,000+ waste management entities | > **Full suite**: [apify.com/minute\_contest](https://apify.com/minute_contest) ### Informations en francais #### Qu'est-ce que cet acteur ? Cet acteur Apify permet d'extraire automatiquement les donnees d'entreprises francaises depuis **Societe.com** - le plus grand site gratuit de consultation de donnees d'entreprises en France. Societe.com regroupe les informations de l'INSEE, de l'INPI et du BODACC, mais ne propose aucune API publique. Cet acteur automatise la collecte de donnees structurees - fiche d'identite, dirigeants, bilans simplifies, actionnaires et filiales. #### Pour qui ? Cet outil s'adresse aux **equipes commerciales B2B** qui construisent des listes de prospects enrichies avec les noms de dirigeants et les donnees financieres, aux **cabinets de due diligence** verifiant la sante financiere et le statut juridique des entreprises, aux **analystes M\&A** cartographiant les reseaux de filiales et les mandats croises de dirigeants, ainsi qu'aux **equipes compliance** effectuant des verifications KYC/AML sur des entites francaises. #### Quelles donnees peut-on obtenir ? L'acteur extrait la **fiche d'identite complete** (SIREN, SIRET, forme juridique, code NAF, adresse, capital, date de creation, statut), la **liste des dirigeants** avec leurs fonctions et dates de nomination, les **donnees financieres simplifiees** (chiffre d'affaires, resultat net), les **actionnaires**, le nombre de **filiales**, et les **marques deposees** associees a l'entreprise. La recherche est possible par nom d'entreprise, numero SIREN, ou nom de dirigeant. #### Comment demarrer ? Lancez l'acteur sur la plateforme Apify en indiquant un nom d'entreprise, un ou plusieurs numeros SIREN, ou un nom de dirigeant. Pour l'integration dans vos systemes (CRM, base de donnees de prospects, outils de compliance), utilisez l'API Apify pour declencher l'acteur et recuperer les resultats au format JSON. Pas d'abonnement - vous payez uniquement a l'utilisation. ### Limitations - **Rate limiting** - Societe.com has anti-bot measures. The Actor uses 3-5 second delays between pages. Budget ~10-15 seconds per company with all options enabled. - **Financial data depth** - only simplified financial data (revenue, net result) is extracted. Full balance sheets and multi-year comparisons are not covered. - **Proxy recommended** - residential proxies are strongly recommended. Without proxies, the site may block requests after a few pages. - **Data freshness** - data depends on when INSEE/INPI/BODACC publish updates. There can be a lag of weeks or months for some fields. - **CAPTCHA** - if Societe.com triggers a CAPTCHA, the affected page will be skipped. Residential proxies reduce CAPTCHA frequency. - **DOM selectors** - Societe.com may change their HTML structure. If extraction breaks, the Actor may need selector updates. # Actor input Schema ## `searchQuery` (type: `string`): Search by company name (partial match). Example: 'Total Energies', 'Carrefour', 'BNP Paribas' ## `sirenNumbers` (type: `array`): List of 9-digit SIREN numbers to look up directly. Each SIREN is navigated individually for exact-match results. ## `managerName` (type: `string`): Search by manager or director name. Example: 'Dupont Jean', 'Martin Pierre'. Returns companies where this person holds a role. ## `includeFinancials` (type: `boolean`): Whether to navigate to the /bilan/ page and scrape simplified financial data (revenue, net result). Adds one extra page load per company. ## `includeDirectors` (type: `boolean`): Whether to navigate to the /dirigeants/ page and scrape the full director list with roles and appointment dates. Adds one extra page load per company. ## `maxResults` (type: `integer`): Maximum number of company records to return from search results. Default: 50. ## `proxyConfiguration` (type: `object`): Apify Proxy configuration. Residential proxies recommended - Societe.com has anti-bot measures. ## Actor input object example ```json { "searchQuery": "Total Energies", "includeFinancials": true, "includeDirectors": true, "maxResults": 50, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `companyData` (type: `string`): Company identity, directors, financial data, shareholders, and corporate network from Societe.com. # 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": "Total Energies", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("minute_contest/societe-com-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 = { "searchQuery": "Total Energies", "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("minute_contest/societe-com-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 '{ "searchQuery": "Total Energies", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call minute_contest/societe-com-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=minute_contest/societe-com-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "France Societe.com Company Scraper", "description": "Scrape French company data from Societe.com - directors, simplified financials, shareholders, subsidiaries, and corporate relationships. The richest free French company data source with no API.", "version": "1.0", "x-build-id": "xJyddaNGlBRTS4i8m" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/minute_contest~societe-com-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-minute_contest-societe-com-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/minute_contest~societe-com-scraper/runs": { "post": { "operationId": "runs-sync-minute_contest-societe-com-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/minute_contest~societe-com-scraper/run-sync": { "post": { "operationId": "run-sync-minute_contest-societe-com-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", "required": [ "proxyConfiguration" ], "properties": { "searchQuery": { "title": "Company Name", "type": "string", "description": "Search by company name (partial match). Example: 'Total Energies', 'Carrefour', 'BNP Paribas'" }, "sirenNumbers": { "title": "SIREN Numbers", "type": "array", "description": "List of 9-digit SIREN numbers to look up directly. Each SIREN is navigated individually for exact-match results.", "items": { "type": "string" } }, "managerName": { "title": "Manager / Director Name", "type": "string", "description": "Search by manager or director name. Example: 'Dupont Jean', 'Martin Pierre'. Returns companies where this person holds a role." }, "includeFinancials": { "title": "Include Financial Data", "type": "boolean", "description": "Whether to navigate to the /bilan/ page and scrape simplified financial data (revenue, net result). Adds one extra page load per company.", "default": true }, "includeDirectors": { "title": "Include Directors", "type": "boolean", "description": "Whether to navigate to the /dirigeants/ page and scrape the full director list with roles and appointment dates. Adds one extra page load per company.", "default": true }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of company records to return from search results. Default: 50.", "default": 50 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Apify Proxy configuration. Residential proxies recommended - Societe.com has anti-bot measures." } } }, "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 } } } } } } } } } } ```