French Legal Announcements · BODACC Scraper

Pull official French legal announcements in minutes: monitor new company registrations, insolvency proceedings, business sales, and annual account filings — filtered by keyword, date range, department, or SIREN. No API key. No login. Data comes directly from the official BODACC register (bodacc.fr), published by DILA (French government).

Built for: Daily lead gen · Keyword-based prospecting · Risk monitoring · Compliance & KYB · M&A sourcing · CRM enrichment

Optional Google Maps enrichment — for each matched announcement, the actor searches Google Maps and merges the business profile (phone, website, hours, rating) when a confident match is found. Each matched result is billed as a separate pay-per-event charge.

Want the full company profile for a SIREN? Use the French Companies Scraper — paste SIRENs and get directors, financials, address, VAT, and more.

---

What does this Actor do?

The BODACC (Bulletin Officiel des Annonces Civiles et Commerciales) is France's official legal gazette. Every business day it publishes thousands of court-validated announcements covering the entire French company lifecycle.

Mode	Input	Behavior
Date range	Start and end date	All announcements published in that window, filtered by type, keyword, and/or department. Default: yesterday → today — ideal for daily scheduled runs.
SIREN list	One or more 9-digit SIRENs	Every announcement ever published for those companies — full history.

---

What types of announcements are available?

Type	familleavis	Use case
Creation	creation	New company registrations — fresh lead pipeline
Modification	modification	Changes to existing companies
Radiation	radiation	Deregistrations / closures
Insolvency	collective	Redressement, liquidation — risk signals, debt recovery
Business sales	vente	Cessions de fonds de commerce — M&A sourcing
Immatriculation	immatriculation	RCS/RM registrations
Accounts filing	dpc	Annual accounts deposited — financial monitoring
Other notices	divers	Miscellaneous legal notices

---

What data does it extract?

Category	Fields
Identity	announcement_id, date, announcement_type, siren, company, trade_name, person_type
Location	city, postal_code, department, department_code, region
Registration details	legal_form, capital_eur, management, address, activity, registration_date, activity_start_date
Insolvency details	court, judgment_type, judgment_date, judgment_details
Sale details	sale_origin, seller_name, seller_siren
Source	url — direct link to the announcement on bodacc.fr
Maps enrichment	maps_name, maps_phone, maps_website, maps_category, maps_address, maps_rating, maps_reviews, maps_hours, maps_url, maps_score

---

Input examples

Quickest start — paste a BODACC URL

Run a search on bodacc.fr, apply your filters, copy the URL, and paste it into searchUrl. The actor extracts keyword, types, dates, and departments automatically.

{
  "mode": "dateRange",
  "searchUrl": "https://www.bodacc.fr/pages/annonces-commerciales/?q=peinture&refine.familleavis=creation&q.from_date=dateparution%3E%3D%222026-01-01%22",
  "maxResults": 0
}

Multi-keyword lead gen with Google Maps enrichment

{
  "mode": "dateRange",
  "keywords": ["paysagiste", "espaces verts", "élagage", "jardinage"],
  "announcementTypes": ["creation"],
  "dateFrom": "2026-02-01",
  "dateTo": "2026-05-10",
  "maxResults": 0,
  "enrichWithMaps": true,
  "mapsWorkers": 3,
  "mapsMinScore": 7
}

Multi-keyword lead gen — paysagistes created in the last 3 months

{
  "mode": "dateRange",
  "keywords": ["paysagiste", "espaces verts", "jardinage", "élagage", "tonte"],
  "announcementTypes": ["creation"],
  "dateFrom": "2026-02-10",
  "dateTo": "2026-05-10",
  "maxResults": 0
}

Date range — all registrations and insolvencies yesterday (default)

{
  "mode": "dateRange",
  "announcementTypes": ["creation", "collective"],
  "maxResults": 0
}

Date range — new companies in Paris in April 2026

{
  "mode": "dateRange",
  "announcementTypes": ["creation"],
  "dateFrom": "2026-04-01",
  "dateTo": "2026-04-30",
  "departments": ["75"],
  "maxResults": 0
}

SIREN list — full announcement history for specific companies

{
  "mode": "sirens",
  "sirens": ["552032534", "380129866"]
}

---

All input parameters

Parameter	Type	Default	Description
searchUrl	string	—	Full URL from bodacc.fr — keyword, types, dates, and departments are extracted automatically.
mode	string	"dateRange"	dateRange or sirens.
keyword	string	—	Single full-text keyword (e.g. peinture).
keywords	string[]	—	Multiple keywords, one per line — combined with OR logic. Takes priority over keyword.
announcementTypes	string[]	["creation", "collective"]	Types to include. Values: creation, modification, radiation, collective, vente, immatriculation, dpc, divers.
dateFrom	string	yesterday	[Date range] Start date YYYY-MM-DD.
dateTo	string	today	[Date range] End date YYYY-MM-DD.
departments	string[]	(all France)	[Date range] Optional department codes (e.g. "75", "69").
sirens	string[]	—	[SIREN mode] One SIREN per line (9 digits).
maxResults	integer	500	Max announcements. 0 = no cap.

Google Maps enrichment parameters (API-only or via Console)

Parameter	Type	Default	Description
enrichWithMaps	boolean	false	Enable Google Maps enrichment. Each matched result is billed as a separate pay-per-event charge.
mapsWorkers	integer	3	Number of browser tabs running Maps searches in parallel. Higher is faster; use 5 for large runs, 1–2 to reduce memory. Min 1, max 10.
mapsMinScore	integer	7	Minimum match confidence score (0–10) to accept a Maps result. 7 = strict (recommended). Requires openaiApiKey for GPT-validated scores.
openaiApiKey	string	—	If provided, GPT-4o-mini validates ambiguous matches and returns a confidence score. Without it, fast regex matching is used (default score: 8 on match, 0 on miss).

---

How to use (Apify Console)

Date range with Maps enrichment (lead gen with contact data)

1. Select Date range.
2. Fill in Keywords list, Announcement types, and From / To date — or paste a BODACC URL.
3. Enable Enrich with Google Maps.
4. Set Maps workers to 3 (safe default) and Minimum match score to 7.
5. Optionally provide an OpenAI API key for GPT-validated matching.
6. Click Start — matched businesses will have phone, website, and hours added automatically.

Each Maps match is billed as a separate pay-per-event charge. Use mapsMinScore: 7 or higher to minimise false positives.

Date range with keyword (lead gen)

1. Select Date range.
2. Paste a BODACC search URL — or fill in Keywords list, Announcement types, and From / To date manually.
3. Optionally add Department codes to focus on a region.
4. Set Max announcements to 0 for no cap.
5. Click Start — export from the Dataset tab or download output.csv.

Tip: schedule this Actor to run every morning to build a fresh daily lead list.

SIREN list

1. Select SIREN list.
2. Paste SIRENs (one per line).
3. Click Start — get the full announcement history for each company.

---

Output example

{
  "announcement_id": "A202600883630",
  "date": "2026-05-09",
  "announcement_type": "creation",
  "company": "BOULANGER, Jean, Laurent",
  "trade_name": "LB Run Multiservices",
  "siren": "104211982",
  "person_type": "individual",
  "city": "Le Tampon",
  "postal_code": "97430",
  "department_code": "974",
  "department": "La Réunion",
  "region": "La Réunion",
  "court": "Greffe du Tribunal Mixte de Commerce de Saint-Pierre",
  "activity": "Prestations de petit bricolage, petits travaux de peinture, pose de revêtements, entretien d'espaces verts.",
  "registration_date": "2026-04-29",
  "activity_start_date": "2026-05-18",
  "sale_origin": "Création",
  "url": "https://www.bodacc.fr/pages/annonces-commerciales-detail/?q.id=id:A202600883630",
  "maps_found": 1,
  "maps_name": "LB Run Multiservices",
  "maps_phone": "06 12 34 56 78",
  "maps_website": "https://lb-run-multiservices.fr",
  "maps_category": "Homme toutes mains",
  "maps_address": "10 Rue Alverdy, 97430 Le Tampon",
  "maps_rating": 4.8,
  "maps_reviews": 23,
  "maps_hours": "Lun-Sam 8h–18h",
  "maps_url": "https://www.google.com/maps/place/...",
  "maps_score": 9
}

---

Local development

npm install
npm start

Edit input.json at the repo root to change the run parameters locally. Results are written to output.csv and storage/. Both are excluded from the push bundle via .apifyignore.

Memory: The BODACC fetching phase needs ~256MB. If enrichWithMaps: true, allocate at least 1024MB (each browser tab uses ~200MB). Default actor.json is set to 1024MB to cover both cases safely.

---

Companion actors

• French Companies Scraper — search companies by filters or enrich SIRENs with directors, financials, and VAT
• French Establishments Scraper — get every SIRET (branch address, NAF, status) for a list of SIRENs

---

Support

Contact corentin@outreacher.fr for custom data pipelines or scheduled monitoring setups.