BODACC · French Legal Announcements by Date or SIREN
Pricing
from $3.49 / 1,000 announcement retrieveds
Export official French legal announcements — registrations, insolvencies, business sales — by date, keyword, region, or SIREN. Companion Actor: French Companies. Public gazette. No API key.
All notable changes to this Actor are documented in this file.
The format follows Keep a Changelog . Actor versions use MAJOR.MINOR (Apify convention).
apify run.runPreset in Console).enrichWithCompanyProfile).full, lead_gen, insolvency column sets.announcement_id, announcement_type).refine repeated = AND).registre="…" exact match.collections format, RUN_LOG URL /records/RUN_LOG.enrichWithMaps, Puppeteer, OpenAI matching, maps-enrichment billing event, and all maps_* fields. Actor is HTTP-only (~512 MB default memory).maxResults in SIREN mode — cap now applies across the full SIREN list, not per company (e.g. 10 SIRENs × 500 no longer yields up to 5,000 billed rows).maxResults cannot be exceeded under concurrent pagination.npm run test:ci) via GitHub Actions.actor.json — Bronze→Gold discounts on announcement rows.queryBuilder unit tests aligned with ODS v1 buildParams / buildApiUrl API.title, description, seoDescription) refreshed; Actor version 1.4, isPublic: true.enrichWithMaps) — optional two-phase pipeline: Phase 1 fetches all BODACC records via HTTP; Phase 2 launches Puppeteer workers to search Google Maps for each announcement and merges the business profile when a confident match is found. Added fields: maps_found, maps_name, maps_phone, maps_website, maps_category, maps_address, maps_rating, maps_reviews, maps_hours, maps_url, maps_score, maps_search_query.mapsWorkers input — number of parallel browser tabs (1–10, default 3). Each tab runs an independent Maps search; cap to avoid OOM.mapsMinScore input — minimum match confidence score (0–10, default 7) to accept a Maps result. Scores below threshold are discarded.openaiApiKey input — when provided, GPT-4o-mini validates ambiguous matches and returns a numeric confidence score (0–10). Without it, a fast regex-based name matcher is used (score 8 on match, 0 on miss).trade_name extracted from BODACC listepersonnes (nomCommercial / nomUsage). Used as the primary search term for Maps enrichment.Actor.chargeEvent('maps-enrichment') is called for each accepted Maps match.searched/total, match count, throughput (rec/s), and ETA.src/lib/mapsEnricher.js — self-contained Puppeteer module with PagePool (worker pool), namesMatch (token-based fuzzy matching), buildSearchName (trade name or first+last name), and validateWithLLM (GPT-4o-mini scoring with regex fallback). All logic is isolated for unit-testability.defaultRunOptions.memoryMbytes raised from 256 to 1024 — required when enrichWithMaps: true (each Puppeteer tab uses ~200MB).defaultRunOptions.timeout raised from 3600s to 7200s to accommodate large Maps enrichment runs.maxMemoryMbytes raised from 1024 to 4096.actor.json version updated to 1.2.actor.json generatedBy updated to Cursor with Claude.✓ → plain Match: label) to conform to premium/Store log style.searchUrl input field); the actor extracts keyword, types, date range, and departments automatically. Manual fields override URL values when both are set.keyword) — full-text filter passed directly to the API (e.g. peinture, plomberie). Matches company names, activity descriptions, and free-text fields.keywords list) — one keyword per line, combined with OR logic (e.g. peinture OR peintre OR paysagiste). Takes priority over the single keyword field.creation type added to announcement types — the API's primary value for new registrations (distinct from immatriculation). Default types updated from ["immatriculation", "collective"] to ["creation", "collective"].modification, radiation, dpc, divers added to available announcement types with correct labels.output.csv — results are now written progressively to output.csv at the project root during local runs (same behaviour as the other actors in this repo).csvWriter.js — dedicated CSV writer with BODACC-specific columns: announcement_id, date, announcement_type, company, siren, person_type, city, postal_code, department, region, activity, legal_form, capital_eur, management, registration_date, activity_start_date, judgment_type, judgment_date, url, etc./api/records/1.0/search/) — the v2.1 API's q parameter was treated as a relevance score (not a strict filter), returning inflated total_count figures. The v1 API matches the website behaviour exactly (e.g. peinture + creation + 2026 → 1 877 results, not 203 506).creation family now correctly triggers registration field extraction (legal_form, capital_eur, management, address, activity, etc.) — previously only immatriculation and vente did.bodacc.fr/api/explore/v2.1).dateRange (filter by date, types, departments) and sirens (full announcement history per SIREN).immatriculation), insolvency (collective), business sales (vente), accounts filings (depot), other notices (avis).dateFrom / dateTo default to yesterday → today when omitted — ready for daily scheduled runs out of the box.registre array, legal form, capital, directors, activity, address, judgment details (type, date, liquidator info), direct bodacc.fr URL.transformAnnouncement pure function: parses nested JSON strings from the API (listepersonnes, acte, jugement, listeetablissements) into flat, clean records with empty fields omitted.buildWhereClause pure helper: constructs ODS SQL where clauses from filters — unit-testable without network.buildWhereClause (type filter, date range, department, SIREN, combined), extractSiren (various formats), transformAnnouncement (registration, insolvency, minimal/empty input), HTTP retry logic (computeBackoffMs, parseRetryAfterMs, fetchWithRetry).dataset_schema.json with overview view showing key columns.