France SIRENE + BODACC Monitor

Daily feed of French company BODACC notices, optionally enriched with SIRENE data through the Recherche d’entreprises API. Schedule the Actor daily and keep the same state store between runs.

Input

Field	Default	Meaning
lookbackDays	2	Publication date lower bound, calculated in UTC.
families	creation, collective	Also accepts radiation, vente, modification.
departments	[]	Department codes. Empty includes all departments.
nafPrefixes	[]	Prefixes of SIRENE activite_principale. Requires enrichment.
onlyNew	true	Emit new and changed notices. Skip unchanged snapshots.
maxItems	100	Maximum results pushed, up to 10,000.
enrichWithSirene	true	Fetch an exact SIREN match from Recherche d’entreprises.
stateStoreName	france-sirene-bodacc-monitor-state	Persistent snapshot store.

The sample input requests at most two results. BODACC requests run at most once per second. SIRENE requests run at most five times per second. BODACC pagination stops at the API's 10,000-record window; narrow the date window or departments for larger feeds.

Output and state

Each dataset record contains a notice ID, publication date, family, notice type, SIREN, company name, legal form, activity, NAF code, commune, postcode, department, region, court, notice URL and source attribution. Collective notices include judgment nature and date. The sirene object contains company attributes and commune, without directors.

checkedAt is the collection time. changeType is new, changed or unchanged; changedFields lists changed output fields. Collection time does not trigger a change. Snapshots are stored under NOTICES only after successful dataset pushes. Setting onlyNew to false also emits unchanged notices. Each emitted result uses the result charging event.

Read RUN_SUMMARY in the default key-value store for fetched, eligible and pushed counts, errors and stop conditions. Actor output links point to the dataset and summary.

Personal data

Natural persons are detected from BODACC typePersonne = pp, SIRENE legal category 1000, or a category starting with 2. Their company name is null and personalDataMasked is true. Names, commercial names, enseignes and street addresses are excluded. Commune, postcode, SIREN and activity remain available. BODACC administration and SIRENE directors are never exported. A SIRENE result with a supplied diffusion status other than O is dropped.

Without SIRENE enrichment, masking uses BODACC person type and the Actor cannot check the latest SIRENE diffusion status. Unmatched SIRENs have the same limitation. Raw source records and judgment complements are excluded. Activity text is retained.

Source attribution and licence

Sources are BODACC commercial notices published by DILA and Recherche d’entreprises for SIRENE attributes from INSEE. Terms were checked on 2026-10-21; see TERMS.md.

Records carry license: "Licence Ouverte v2.0" and attribution: "BODACC (DILA) / SIRENE (INSEE), Licence Ouverte v2.0". Reuse requires source attribution and the source update date. Preserve publishedDate and checkedAt when redistributing. See the Licence Ouverte v2.0.

Local use

npm install
npm test
npm start

Tests use node:test and stub network requests. test/fixtures/synthetic.json is a synthetic privacy and pagination fixture. Real response fixture capture is pending API access. Local runs use the real APIs and the input in storage/key_value_stores/default/INPUT.json.

Verification status

On 2026-10-21, 18 dependency-free tests passed. npm install failed because DNS could not resolve registry.npmjs.org; the local npm cache could not satisfy an offline install. The full npm test run failed in four test files that need the missing Apify SDK. The one local Actor run stopped at that missing import and produced no dataset or RUN_SUMMARY.

BODACC fixture capture with curl also failed DNS resolution. The bundled fixture is synthetic. Capturing real API fixtures and completing the full test suite and live run remain required before deployment.