Scrape used-car listings from Cars.bg, Bulgaria's largest car marketplace — make, model, year, price in EUR and BGN, mileage, fuel type, gearbox, engine power, body type, color, seller, and photos. Export to JSON or CSV; enrich each listing from its detail page.
Force-residential proxy guard: _resolve_proxy_config now always requests
the RESIDENTIAL group regardless of what the customer passes in
proxyConfiguration. If apifyProxyGroups is absent, empty, or contains
only datacenter groups, it is silently upgraded to ["RESIDENTIAL"].
Fail fast on unavailable proxy: instead of falling back to direct/datacenter
routing (which causes HTTP 403/503 on Cars.bg), the Actor now raises a
RuntimeError with an actionable message if create_proxy_configuration
returns None or raises. This surfaces the issue immediately rather than
producing empty datasets.
Add tests/test_proxy_guard.py with 7 unit tests covering the guard logic
and the fail-fast RuntimeError path.
_ensure_residential_groups extracted as a pure sync helper (testable
without the Apify SDK).
0.2.0 — 2026-06-05
Switch enrichDetails default from true to false (listing-only mode).
Cars.bg detail pages return HTTP 403 on many FREE-tier residential IPs;
keeping enrichment off-by-default prevents Apify auto-QA from timing out
with zero rows and being flagged "Under maintenance".
Update README to accurately describe enrichDetails as opt-in with a
rate-limit warning. Input table, example input JSON, Limitations section,
and FAQ entry all updated.
Fix test assertions to reflect enrich_details=False default.
Bump actor.json version 0.1 → 0.2 (Gate 10 requirement).
