# Changelog of Used Car Listings Scraper — US Cars For Sale (`prodiger/used-car-listings-scraper`) Actor

- **URL**: https://apify.com/prodiger/used-car-listings-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/prodiger/used-car-listings-scraper.md

## Changelog

### 0.1 — 2026-08-15

Initial release.

- Search US used-car listings via the official [vehicles.dev](https://vehicles.dev) `listings` API (Bearer key).
- Filters: make, model, year range, price range, max mileage, state, condition, seller type, source, min data quality, active/sold/valid-VIN, sort/order.
- Batch `searches[]` (each inheriting top-level filters), with a global `maxItems` budget shared across searches.
- `limit`/`offset` pagination that pages past any single-response cap up to `maxItems`; requests `min(500, remaining)` per call so it never over-fetches.
- Run-level VIN deduplication (overlapping searches never double-bill), migration-safe run state (`Actor.useState`).
- Operator credential (`VEHICLES_DEV_API_KEY` env secret) with optional per-run BYOK `apiKey`; origin override via `VEHICLES_DEV_API_BASE_URL`.
- Pay-per-event pricing: `actor_start` + `listing_scraped` ($0.50 / 1,000 listings), charged only after a successful write (2xx only).
- RFC 9457 error handling (terminal on bad key / out of credits; 429/5xx retried with backoff), optional `customMapFunction`.
