All notable changes to this Actor will be documented in this file.
- Initial release: SEC EDGAR Form D (Regulation D capital-raise) → structured B2B leads.
- EDGAR Full-Text Search pagination over
forms=D with startdt / enddt date range
and optional free-text query filter.
primary_doc.xml deep-fetch per filing — extracts 27 structured fields plus a
nested list of officers/directors/promoters with names and locations.- Pydantic v2
ActorInput model with default 30-day date window, ISO date
validation, and start_date <= end_date enforcement.
- Pydantic v2
ResultRow + nested RelatedPerson models — single source of truth
for input_schema.json and dataset_schema.json.
- Post-filters:
state_filter (issuer state) and min_offering_amount_usd;
applied before the per-row PPE charge so users pay only for kept rows.
- Amendment toggle:
include_amendments=false (default) skips Form D/A entries
before the XML fetch — saves bandwidth and rate-limit budget.
- XML schema quirks handled:
"Indefinite" literal offering amounts, overFiveYears
vs withinFiveYears year-of-incorporation fork, yetToOccur first-sale fork,
raw "0" minimum investment → null.
- EDGAR Fair Access Policy compliance: mandatory User-Agent header on every request;
0.1 s inter-XML-fetch sleep to stay under 10 req/s/IP.
- Exponential backoff with
Retry-After for 429 / 503 responses; max 5 attempts.
- Two PPE events:
actor-start ($0.05), result-row ($0.005).
curl-cffi with Chrome 131 TLS impersonation (ADR-0002 house default).- Apify Proxy support via
BUYPROXIES94952 group (opt-in via useProxy).
- 40+ unit tests covering models, parser, client, and the no-
idempotency_key
regression for Actor.charge.
