Spanish Company Formations (BORME)

Extract structured company incorporation notices from the official BOE BORME OpenData API. Choose a publication date range and optionally filter by exact province or keywords. Output is one JSON record per constitution notice.

Input

• dateFrom, dateTo: publication dates (YYYY-MM-DD); defaults to today / start date.
• provinces: optional exact BORME province names.
• keywords: optional case-insensitive company-name or objeto-social terms.
• includeAdministrators: opt in to names published in BORME; off by default.
• maxCompanies: 1-10,000 records; default 500.

See the exact customer examples in STORE_LISTING.md.

Output

Each record includes companyName, publicationDate, province, municipality, objectPurpose, capitalEur, optional administrators, derived sectorTag, officialActId, official XML/PDF links, attribution, and parser version. Use officialActId for downstream deduplication.

Date-range product, not a monitor

Version 1 does not retain cross-run customer state and does not claim “only new since last run.” For repeat schedules, supply the intended one-day range and deduplicate on officialActId in the receiving system. This avoids shared-state leakage, accidental cross-filter suppression, state resets, and ambiguous behavior when users backfill or change filters.

Source, attribution, and status

The Actor calls https://www.boe.es/datosabiertos/api/borme/sumario/{YYYYMMDD} and the official Section A XML links returned by that API. No browser scraping is used.

Basado en datos de la Agencia Estatal Boletín Oficial del Estado. Source: https://www.boe.es

This is an independent, derived data extractor. It is not an official BOE/AEBOE product and is not endorsed by them. Parsed JSON is non-official; the signed PDF linked in each record is authoritative. municipality is inferred from notice text. sectorTag is a deterministic, non-official heuristic. Either may be null or imperfect.

Operational limits

The Actor is sequential and waits 150 ms between province documents. Weekends and holidays with no issue are skipped. Administrator names are opt-in and users remain responsible for lawful personal-data reuse.

Pricing

$0.05 per Actor start plus $0.0015 per result (Result is the primary event; Apify platform usage is included). This is experimental launch pricing for the first 30-60 days, not permanent pricing.

Local validation

npm ci
npm test
node test/validate-store-package.js