# French Insolvency & Company Notices — BODACC Scraper (`studio-amba/bodacc-scraper`) Actor Search and extract French commercial announcements from BODACC. Find insolvencies, company registrations, dissolutions, transfers, and account filings. Filter by company name, SIREN, department, or notice type. No cookies, no login. - **URL**: https://apify.com/studio-amba/bodacc-scraper.md - **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community) - **Categories:** Business, Lead generation - **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 ## French Insolvency & Company Notices — BODACC Scraper Search and extract French commercial announcements from BODACC (Bulletin Officiel des Annonces Civiles et Commerciales). Find insolvencies, company registrations, dissolutions, business transfers, and account filings. Filter by company name, SIREN, department, notice type, or date range. No cookies, no login required. ### How to scrape BODACC data This actor queries the official BODACC open data API to deliver structured French commercial announcements. BODACC is France's mandatory publication bulletin for civil and commercial announcements — every company registration, modification, dissolution, insolvency proceeding, and account filing is published here. The database contains over 49 million announcements. #### Search by Company Name Enter a company name to find all official announcements about that company — registrations, modifications, insolvency proceedings, dissolutions, and account filings. #### Search by SIREN Number Look up all announcements for a specific company by its SIREN number. This gives you a complete legal timeline of any French company. #### Filter by Notice Category Focus on specific announcement types: insolvency proceedings (procedures collectives), new company registrations, modifications, deregistrations, account filings, or business sales/transfers. #### Credit Risk Monitoring Track insolvency announcements in a specific department or across all of France. Set up scheduled runs to monitor for new liquidations, receiverships (redressement judiciaire), and safeguard proceedings. ### What data does BODACC Scraper extract? | Field | Type | Description | |-------|------|-------------| | **companyName** | String | Company name (denomination) | | **siren** | String | 9-digit SIREN number | | **siret** | String | 14-digit SIRET number (when available) | | **noticeFamily** | String | Category: insolvency, registration, modification, etc. | | **noticeType** | String | Initial notice, judgment, or correction | | **publicationDate** | String | BODACC publication date | | **court** | String | Court name (tribunal) | | **city** | String | Company city | | **postalCode** | String | Postal code | | **department** | String | Department code | | **region** | String | Region code | | **judgmentType** | String | Type of court decision (for insolvency notices) | | **judgmentDate** | String | Date of court decision | | **legalAct** | String | Type of legal act (for registration/modification notices) | | **actDate** | String | Effective date of act | | **persons** | Array | Named persons with roles (directors, administrators) | | **establishments** | Array | Establishment details | | **url** | String | Direct link to BODACC notice | | **scrapedAt** | String | ISO timestamp | ### Example output ```json { "companyName": "SARL Restaurant Le Provence", "siren": "123456789", "siret": "", "noticeFamily": "Procedures collectives", "noticeType": "Jugement", "publicationDate": "2026-05-18", "court": "Tribunal de Commerce de Marseille", "city": "Marseille", "postalCode": "13001", "department": "13", "region": "93", "judgmentType": "Jugement d'ouverture de liquidation judiciaire", "judgmentDate": "2026-05-15", "legalAct": "", "actDate": "", "persons": [ { "name": "Jean Dupont", "role": "Gerant" }, { "name": "Marie Martin", "role": "Mandataire judiciaire" } ], "establishments": [ { "name": "Restaurant Le Provence", "address": "15 rue de la Republique, 13001 Marseille", "activity": "Restauration traditionnelle" } ], "sourceUrl": "", "url": "https://www.bodacc.fr/annonce/detail/A-2026-12345", "scrapedAt": "2026-05-20T14:30:00.000Z" } ```` ### Tips for best results - **Credit risk monitoring**: Filter by "Insolvency" category and run on a daily schedule. Get early warning when companies in your supply chain or customer base enter proceedings. - **Due diligence**: Search by SIREN to see the complete legal history of any French company — from registration through any proceedings to dissolution. - **Market intelligence**: Track new company registrations in a specific department to spot emerging businesses. - **Account monitoring**: Filter by "Account filings" to track when companies publish their annual accounts. - **Combine with enrichment**: Use SIREN numbers from BODACC results with our French Company Enrichment actor for full company profiles. ### How much does it cost? | Search size | Estimated time | Estimated cost | |-------------|---------------|----------------| | 20 notices | ~3 seconds | ~$0.002 | | 100 notices | ~10 seconds | ~$0.008 | | 1,000 notices | ~2 minutes | ~$0.06 | ### Can I use it as an API? ```python from apify_client import ApifyClient client = ApifyClient("YOUR_API_TOKEN") run = client.actor("studio-amba/bodacc-scraper").call(run_input={ "searchQuery": "liquidation judiciaire", "department": "75", "noticeFamily": "collective", "maxResults": 50, }) for notice in client.dataset(run["defaultDatasetId"]).iterate_items(): print(f"{notice['companyName']} | {notice['judgmentType']} | {notice['publicationDate']}") ``` ### Limitations - OpenDataSoft API caps offset pagination at 10,000 — use date-range windowing for bulk extraction - Nested JSON fields vary by notice type - Personal insolvency notices may have restricted data - Updated daily ### Other French data scrapers - **[French Company Enrichment](https://apify.com/studio-amba/french-company-enrichment)** — Full French company profiles from government API - **[French Procurement (BOAMP)](https://apify.com/studio-amba/boamp-scraper)** — French public procurement tenders ### Your feedback Found a bug or want a feature? Open an issue on the [Issues tab](https://console.apify.com/actors/studio-amba~bodacc-scraper/issues). # Actor input Schema ## `searchQuery` (type: `string`): Search by company name or keywords. Example: 'Carrefour', 'liquidation judiciaire', 'SAS'. ## `siren` (type: `string`): Look up announcements for a specific company by SIREN number. ## `noticeFamily` (type: `string`): Filter by announcement category. ## `department` (type: `string`): Filter by department code. Example: '75' for Paris. ## `dateFrom` (type: `string`): Only notices published on or after this date. Format: YYYY-MM-DD. ## `dateTo` (type: `string`): Only notices published on or before this date. Format: YYYY-MM-DD. ## `maxResults` (type: `integer`): Maximum number of announcements to return. ## `proxyConfiguration` (type: `object`): Apify proxy configuration. ## Actor input object example ```json { "searchQuery": "liquidation judiciaire", "noticeFamily": "all", "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": "liquidation judiciaire", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("studio-amba/bodacc-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": "liquidation judiciaire", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("studio-amba/bodacc-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": "liquidation judiciaire", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call studio-amba/bodacc-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=studio-amba/bodacc-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "French Insolvency & Company Notices — BODACC Scraper", "description": "Search and extract French commercial announcements from BODACC. Find insolvencies, company registrations, dissolutions, transfers, and account filings. Filter by company name, SIREN, department, or notice type. No cookies, no login.", "version": "0.0", "x-build-id": "T4Uw2IEx7p4XWo3c6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~bodacc-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-bodacc-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/studio-amba~bodacc-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-bodacc-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/studio-amba~bodacc-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-bodacc-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": { "searchQuery": { "title": "Company Name / Keywords", "type": "string", "description": "Search by company name or keywords. Example: 'Carrefour', 'liquidation judiciaire', 'SAS'." }, "siren": { "title": "SIREN Number", "type": "string", "description": "Look up announcements for a specific company by SIREN number." }, "noticeFamily": { "title": "Notice Category", "enum": [ "all", "collective", "creation", "modification", "radiation", "depot_comptes", "vente" ], "type": "string", "description": "Filter by announcement category.", "default": "all" }, "department": { "title": "Department", "type": "string", "description": "Filter by department code. Example: '75' for Paris." }, "dateFrom": { "title": "Published After", "type": "string", "description": "Only notices published on or after this date. Format: YYYY-MM-DD." }, "dateTo": { "title": "Published Before", "type": "string", "description": "Only notices published on or before this date. Format: YYYY-MM-DD." }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of announcements to return.", "default": 100 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Apify proxy configuration." } } }, "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 } } } } } } } } } } ```