# Infogreffe Scraper (`nocodeventure/infogreffe-scraper-french-company-registry`) Actor Apify Actor that scrapes French trade register data from Infogreffe — companies (with profiles and establishments) or directors (with roles at linked companies). - **URL**: https://apify.com/nocodeventure/infogreffe-scraper-french-company-registry.md - **Developed by:** [No-Code Venture](https://apify.com/nocodeventure) (community) - **Categories:** Automation, Integrations, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 results 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 ## Infogreffe Scraper Apify Actor that scrapes French trade register data from [Infogreffe](https://www.infogreffe.fr/) — **companies** (with profiles and establishments) or **directors** (with roles at linked companies). ### Search modes | Mode | Input `searchMode` | What you get | |------|-------------------|--------------| | Companies | `entreprises` | One row per company: search summary, full profile, establishments list | | Directors | `personnes` | One row per person: search summary, detailed roles per company | ### Input | Field | Description | Default | |-------|-------------|---------| | `searchMode` | `entreprises` or `personnes` | `entreprises` | | `phrase` | Search text (required) | — | | `maxPages` | Max search pages (`0` = unlimited) | `0` | | `pageSize` | Results per page (1–50) | `10` | | `inclureFermes` | Include closed establishments (companies) | `true` | | `maxEstablishmentPages` | Cap establishment pages per company (`0` = all) | `0` | | `typeEntreprise` | Company status filter for director roles | `ACTIVE` | | `maxFonctionPages` | Cap role pages per director (`0` = all) | `0` | | `etat`, `statut`, `typeEntite`, `activite`, `critereGeographique` | Optional company search filters | `[]` | | `maxConcurrency` | Parallel requests | `5` | | `maxRequestsPerMinute` | Rate limit | `120` | | `proxyConfiguration` | Apify proxy | disabled | Filter enum values are maintained in [`.actor/enums/`](.actor/enums/) (edit those files when Infogreffe adds options). #### Example — companies ```json { "searchMode": "entreprises", "phrase": "DOT", "maxPages": 1, "pageSize": 10 } ```` #### Example — directors ```json { "searchMode": "personnes", "phrase": "DOT", "maxPages": 1, "pageSize": 10 } ``` ### Output - **Companies:** `resultType: "entreprise"`, flattened fields plus `searchHit`, `detail`, `etablissements`. - **Directors:** `resultType: "personne"`, name fields plus `searchHit`, `fonctionsParEntreprise`. Use dataset views **Companies** or **Directors** in the Apify Console. ### Pricing (Pay Per Event) You pay per **scrape step** (billed events in Console): | Event | Description | |-------|-------------| | `infogreffe-search` | Registry search (each results page) | | `infogreffe-detail` | Company profile | | `infogreffe-establishments` | Company establishments (each page) | | `infogreffe-fonctions` | Director roles (each page) | | `event-proxy` | Apify proxy enabled (no proxy group), once per run | | `event-proxy-group` | Apify proxy with a proxy group, once per run | Company runs typically use more steps per result than director runs. Proxy events are charged once at startup when `proxyConfiguration.useApifyProxy` is true (see `chargeForProxyUsage` in `src/main.ts`). Dataset rows may also incur `apify-default-dataset-item` if configured on the Actor. ### Notes - Respect Infogreffe terms of service and rate limits; use a proxy for large scrapes. - Enum files under `.actor/enums/` are the source of truth for filter values; keep `input_schema.json` in sync when adding codes. ### Legal disclaimer This Actor is an **independent tool**. It is **not affiliated with, endorsed by, or operated by** Infogreffe, Greffe du tribunal de commerce, INPI, or any French public authority. Output is collected from publicly accessible registry endpoints for **research and automation purposes only**. It does **not** constitute legal, tax, or compliance advice. Always verify company identifiers, statuses, and director information against official sources before relying on them in professional or legal matters. **Your responsibilities:** You are solely responsible for using this Actor lawfully, including compliance with: - Infogreffe and related operators’ terms of use and acceptable use policies - Applicable French and EU law, including **GDPR** and the *Loi Informatique et Libertés* when processing personal data (e.g. director names and birth details) - Any licensing, attribution, or reuse rules that apply to trade register data in your jurisdiction Configure reasonable `maxPages`, `pageSize`, `maxConcurrency`, and `maxRequestsPerMinute` so you do not overload the service. Do not use the Actor to collect or process data you are not permitted to hold. **No warranty:** This software is provided **“as is”**, without warranties of any kind. The authors and distributors are not liable for damages, losses, or legal consequences arising from its use. Consult qualified counsel if you are unsure whether your use case is permitted. # Actor input Schema ## `searchMode` (type: `string`): Search French companies (entreprises) or directors (dirigeants / personnes). ## `phrase` (type: `string`): Free-text search query (company name, director name, etc.). ## `maxPages` (type: `integer`): Maximum number of search result pages to scrape per run (0 = unlimited). ## `pageSize` (type: `integer`): Number of search results per page (max 50). ## `inclureFermes` (type: `boolean`): When scraping companies, include closed establishments in the establishments step. ## `maxEstablishmentPages` (type: `integer`): Cap establishment pagination per company (0 = all pages). ## `typeEntreprise` (type: `string`): When scraping directors, filter linked companies by status on the roles step. ## `maxFonctionPages` (type: `integer`): Cap director-roles pagination per person (0 = all pages). ## `etat` (type: `array`): Filter companies by registration state. Leave empty to include all. ## `statut` (type: `array`): Filter companies by status code. Leave empty to include all. ## `typeEntite` (type: `array`): Filter by entity type. Leave empty to include all. ## `activite` (type: `array`): Filter by activity sector code (01–99). Leave empty to include all. ## `critereGeographique` (type: `array`): Geographic filter codes. Leave empty to include all. Extend .actor/enums/critereGeographique.json when codes are known. ## `maxConcurrency` (type: `integer`): Maximum number of concurrent requests. ## `maxRequestsPerMinute` (type: `integer`): Rate limit cap. Lower if you see rate-limit errors without a proxy. ## `proxyConfiguration` (type: `object`): Proxy settings. Recommended for large scrapes to avoid rate limiting. ## Actor input object example ```json { "searchMode": "entreprises", "phrase": "DOT", "maxPages": 1, "pageSize": 10, "inclureFermes": true, "maxEstablishmentPages": 0, "typeEntreprise": "ACTIVE", "maxFonctionPages": 0, "etat": [], "statut": [], "typeEntite": [], "activite": [], "critereGeographique": [], "maxConcurrency": 5, "maxRequestsPerMinute": 120, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `companies` (type: `string`): No description ## `directors` (type: `string`): No description ## `dataset` (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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "phrase": "DOT", "maxPages": 1 }; // Run the Actor and wait for it to finish const run = await client.actor("nocodeventure/infogreffe-scraper-french-company-registry").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 = { "phrase": "DOT", "maxPages": 1, } # Run the Actor and wait for it to finish run = client.actor("nocodeventure/infogreffe-scraper-french-company-registry").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 '{ "phrase": "DOT", "maxPages": 1 }' | apify call nocodeventure/infogreffe-scraper-french-company-registry --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=nocodeventure/infogreffe-scraper-french-company-registry", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Infogreffe Scraper", "description": "Apify Actor that scrapes French trade register data from Infogreffe — companies (with profiles and establishments) or directors (with roles at linked companies).", "version": "0.0", "x-build-id": "WWzGnQIkoXBZ7cnYX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nocodeventure~infogreffe-scraper-french-company-registry/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nocodeventure-infogreffe-scraper-french-company-registry", "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/nocodeventure~infogreffe-scraper-french-company-registry/runs": { "post": { "operationId": "runs-sync-nocodeventure-infogreffe-scraper-french-company-registry", "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/nocodeventure~infogreffe-scraper-french-company-registry/run-sync": { "post": { "operationId": "run-sync-nocodeventure-infogreffe-scraper-french-company-registry", "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": [ "phrase" ], "properties": { "searchMode": { "title": "Search mode", "enum": [ "entreprises", "personnes" ], "type": "string", "description": "Search French companies (entreprises) or directors (dirigeants / personnes).", "default": "entreprises" }, "phrase": { "title": "Search phrase", "type": "string", "description": "Free-text search query (company name, director name, etc.)." }, "maxPages": { "title": "Max search pages", "minimum": 0, "type": "integer", "description": "Maximum number of search result pages to scrape per run (0 = unlimited).", "default": 0 }, "pageSize": { "title": "Results per page", "minimum": 1, "maximum": 50, "type": "integer", "description": "Number of search results per page (max 50).", "default": 10 }, "inclureFermes": { "title": "Include closed establishments", "type": "boolean", "description": "When scraping companies, include closed establishments in the establishments step.", "default": true }, "maxEstablishmentPages": { "title": "Max establishment pages per company", "minimum": 0, "type": "integer", "description": "Cap establishment pagination per company (0 = all pages).", "default": 0 }, "typeEntreprise": { "title": "Company status filter (directors)", "enum": [ "ACTIVE" ], "type": "string", "description": "When scraping directors, filter linked companies by status on the roles step.", "default": "ACTIVE" }, "maxFonctionPages": { "title": "Max role pages per director", "minimum": 0, "type": "integer", "description": "Cap director-roles pagination per person (0 = all pages).", "default": 0 }, "etat": { "title": "État", "type": "array", "description": "Filter companies by registration state. Leave empty to include all.", "items": { "type": "string", "enum": [ "ACTIVE" ], "enumTitles": [ "Active" ] }, "default": [] }, "statut": { "title": "Statut", "type": "array", "description": "Filter companies by status code. Leave empty to include all.", "items": { "type": "string", "enum": [ "B", "D" ], "enumTitles": [ "B", "D" ] }, "default": [] }, "typeEntite": { "title": "Type d'entité", "type": "array", "description": "Filter by entity type. Leave empty to include all.", "items": { "type": "string", "enum": [ "ENTREPRISE" ], "enumTitles": [ "Entreprise" ] }, "default": [] }, "activite": { "title": "Activité (sector)", "type": "array", "description": "Filter by activity sector code (01–99). Leave empty to include all.", "items": { "type": "string", "enum": [ "01", "02", "03", "04", "05", "06", "07", "08", "09", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31", "32", "33", "34", "35", "36", "37", "38", "39", "40", "41", "42", "43", "44", "45", "46", "47", "48", "49", "50", "51", "52", "53", "54", "55", "56", "57", "58", "59", "60", "61", "62", "63", "64", "65", "66", "67", "68", "69", "70", "71", "72", "73", "74", "75", "76", "77", "78", "79", "80", "81", "82", "83", "84", "85", "86", "87", "88", "89", "90", "91", "92", "93", "94", "95", "96", "97", "98", "99" ] }, "default": [] }, "critereGeographique": { "title": "Critère géographique", "type": "array", "description": "Geographic filter codes. Leave empty to include all. Extend .actor/enums/critereGeographique.json when codes are known.", "items": { "type": "string" }, "default": [] }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 5, "type": "integer", "description": "Maximum number of concurrent requests.", "default": 5 }, "maxRequestsPerMinute": { "title": "Max requests per minute", "minimum": 1, "maximum": 600, "type": "integer", "description": "Rate limit cap. Lower if you see rate-limit errors without a proxy.", "default": 120 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Recommended for large scrapes to avoid rate limiting.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } } ```